PHP短代码返回畸形HTML渲染异常问题咨询

异常原因 #

这个问题是WordPress内置的文本格式化机制和块编辑器的HTML解析逻辑共同导致的：

1. WordPress默认会通过wptexturize函数对文章内容做文本转义，会自动将普通文本转换为带智能引号的格式，当短代码返回的内容里包含<u>这类内联HTML标签时，解析器会把标签两侧的文本识别为独立的纯文本节点，自动添加多余的引号包裹，最终出现格式错乱。
2. 古腾堡编辑器的短代码块默认会对非标准化的HTML返回内容做额外转义，把部分HTML片段当成纯文本渲染，也会触发该问题。

修复方案 #

步骤1：排除短代码的文本格式化

将以下代码添加到主题functions.php文件，或者自定义短代码所在的插件文件中，将your_shortcode_name替换为你实际注册的短代码名称：

add_filter('no_texturize_shortcodes', function (array $shortcodes) {
    $shortcodes[] = 'your_shortcode_name';
    return $shortcodes;
});

步骤2：优化短代码返回逻辑

用WordPress内置的wp_kses_post函数包裹返回的HTML内容，既可以做安全过滤，也能告知解析器这是合法的HTML内容，无需做文本转义，修改后的短代码逻辑如下：

$next_friday = new DateTime();
$next_friday->modify('next friday');
$final_date = $next_friday->format('l, F j, Y');
    
$response_formatted = "<h3 class='has-text-align-left'>$final_date</h3>";
$response_formatted .= "<p>Pre-sale for <u>Next Friday</u> Will Start on Tuesday at 5pm</p>";

return wp_kses_post($response_formatted);

可选方案

如果以上操作仍然无效，可以换用输出缓冲的方式构造返回内容，避免字符串拼接带来的解析异常：

function 你的短代码回调函数名() {
    ob_start();
    $next_friday = new DateTime();
    $next_friday->modify('next friday');
    $final_date = $next_friday->format('l, F j, Y');
?>
<h3 class="has-text-align-left"><?php echo esc_html($final_date); ?></h3>
<p>Pre-sale for <u>Next Friday</u> Will Start on Tuesday at 5pm</p>
<?php
    return ob_get_clean();
}

内容的提问来源于stack exchange，提问作者dcolumbus