概述

wp_staticize_emoji() 函数用于将内容中的 emoji 转换为静态图片元素，以增强兼容性和显示效果。它通过检测文本中的 emoji 字符，将其替换为对应的 PNG 图片链接，并支持过滤器和忽略特定标签的处理。

关键要点

• 函数接受一个字符串参数 $text，返回编码后的字符串。
• 内部使用 wp_encode_emoji() 和 _wp_emoji_list() 辅助函数来处理 emoji 检测和转换。
• 支持通过 apply_filters() 钩子 emoji_url 和 emoji_ext 自定义图片 CDN 地址和文件扩展名。
• 在转换过程中会忽略 code、pre、style、script、textarea 等标签内的内容，避免破坏代码结构。
• 函数从 WordPress 4.2.0 版本引入，主要用于前端显示和电子邮件中的 emoji 静态化。

代码示例

function wp_staticize_emoji( $text ) {
    // 检查文本是否包含 emoji 实体
    if ( ! str_contains( $text, '&#x' ) ) {
        // 如果文本为 ASCII 编码或无 emoji，直接返回
        if ( ( function_exists( 'mb_check_encoding' ) && mb_check_encoding( $text, 'ASCII' ) ) || ! preg_match( '/[^x00-x7F]/', $text ) ) {
            return $text;
        } else {
            $encoded_text = wp_encode_emoji( $text );
            if ( $encoded_text === $text ) {
                return $encoded_text;
            }
            $text = $encoded_text;
        }
    }
    // 获取 emoji 实体列表并替换为图片
    $emoji = _wp_emoji_list( 'entities' );
    $possible_emoji = array();
    foreach ( $emoji as $emojum ) {
        if ( str_contains( $text, $emojum ) ) {
            $possible_emoji[$emojum] = html_entity_decode( $emojum );
        }
    }
    if ( ! $possible_emoji ) {
        return $text;
    }
    $cdn_url = apply_filters( 'emoji_url', 'https://s.w.org/images/core/emoji/17.0.2/72x72/' );
    $ext = apply_filters( 'emoji_ext', '.png' );
    // 处理文本，忽略特定标签
    $textarr = preg_split( '/()/U', $text, -1, PREG_SPLIT_DELIM_CAPTURE );
    $output = '';
    $tags_to_ignore = 'code|pre|style|script|textarea';
    $ignore_block_element = '';
    for ( $i = 0; $i < count( $textarr ); $i++ ) {
        $content = $textarr[$i];
        // 检查是否进入忽略块
        if ( '' === $ignore_block_element && preg_match( '/^<(' . $tags_to_ignore . ')[s>]/', $content, $matches ) ) {
            $ignore_block_element = $matches[1];
        }
        // 如果不在忽略块中，替换 emoji
        if ( '' === $ignore_block_element && strlen( $content ) > 0 && '<' !== $content[0] ) {
            foreach ( $possible_emoji as $emojum => $emoji_char ) {
                if ( ! str_contains( $content, $emojum ) ) {
                    continue;
                }
                $file = str_replace( ';&#x', '-', $emojum );
                $file = str_replace( array( '&#x', ';' ), '', $file );
                $entity = sprintf( '', $cdn_url . $file . $ext, $emoji_char );
                $content = str_replace( $emojum, $entity, $content );
            }
        }
        // 检查是否退出忽略块
        if ( '' !== $ignore_block_element && '' === $content ) {
            $ignore_block_element = '';
        }
        $output .= $content;
    }
    // 移除多余的 U+FE0F 字符
    $output = str_replace( '️', '', $output );
    return $output;
}

注意事项

• 函数依赖于 WordPress 核心的 emoji 处理函数，如 wp_encode_emoji() 和 _wp_emoji_list()，确保这些函数可用。
• 使用过滤器 emoji_url 和 emoji_ext 可以自定义 emoji 图片的源地址和文件类型，适用于 CDN 或自定义部署场景。
• 在转换时自动忽略 code、pre 等标签内的内容，防止破坏代码或样式，开发者应注意此行为以避免意外影响。
• 函数从 4.2.0 版本开始提供，主要用于提升 emoji 在旧浏览器或邮件客户端中的兼容性。