WordPress中[display-posts]短码无法正常解析的问题求助

针对你遇到的[display-posts]等文章展示短码无法解析、仅显示文本的问题，提供以下几个可行的解决方案：

• 强制启用短码解析钩子
  部分主题或自定义代码可能意外移除了the_content上的短码解析过滤，你可以在主题的functions.php中添加以下代码，确保短码被解析：

  add_filter( 'the_content', 'do_shortcode', 11 );
  

  这里设置优先级为11，确保在其他内容过滤之后执行，避免被覆盖。

• 自定义可控的单篇文章短码
  第三方插件的短码可能存在兼容性问题，自己写一个简单的短码更可靠。将以下代码添加到functions.php：

  function custom_single_post_shortcode( $atts ) {
      // 设置默认参数，必填文章ID
      $args = shortcode_atts( array(
          'id' => '',
      ), $atts );
  
      if ( empty( $args['id'] ) ) {
          return '请指定要展示的文章ID';
      }
  
      // 获取文章对象
      $target_post = get_post( $args['id'] );
      if ( ! $target_post ) {
          return '未找到指定的文章';
      }
  
      // 初始化文章数据，避免影响全局上下文
      setup_postdata( $target_post );
      // 组装文章内容，包含标题和处理后的正文
      $post_html = '<h3>' . get_the_title() . '</h3>' . apply_filters( 'the_content', get_the_content() );
      // 重置文章数据
      wp_reset_postdata();
  
      return $post_html;
  }
  add_shortcode( 'show-single-post', 'custom_single_post_shortcode' );
  

  使用时直接调用[show-single-post id="你的文章ID"]即可，这个短码不会受其他插件冲突影响。

• 调整第三方短码的执行优先级
  如果坚持使用[display-posts]插件，可以尝试提高它的执行优先级，确保在内容输出前被解析：

  // 先移除原插件的短码注册
  remove_shortcode( 'display-posts' );
  // 重新注册并设置更高优先级（100）
  add_shortcode( 'display-posts', 'display_posts_shortcode', 100 );
  

  注意：display_posts_shortcode是该插件的核心回调函数，若插件更新后函数名变化，需要对应修改。

• 排查主题/插件冲突
  暂时禁用所有非必要插件，只保留WooCommerce和Display Posts插件，切换到WordPress默认主题（如Twenty Twenty-Four）测试短码。如果恢复正常，再逐个启用插件、切换主题，定位到冲突的组件后针对性处理。

• 检查模板输出逻辑
  如果你是在自定义模板（包括支付网关的页面模板）中输出内容，要确保内容被do_shortcode()包裹。比如模板中应该写：

  echo do_shortcode( get_the_content() );
  

  而不是直接输出未处理的内容。

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