如何通过Snippets使用WP钩子为WordPress文章元素添加自定义类

之前的代码无法生效，核心是两个认知错误：

• body_class 钩子仅用于给页面根节点<body>标签追加类名，完全无法修改页面内部id为learndash-page-content的div属性
• WordPress不存在is_post()这个条件判断函数，判断普通文章（post类型）单页要使用is_single()，判断任意自定义文章类型单页可以用is_singular()

learndash-page-content是LearnDash插件自带的内容容器，官方提供了专属过滤器用于修改它的类属性，将以下代码添加到Snippets插件中运行即可：

add_filter( 'learndash_content_wrapper_class', 'add_custom_class_to_learndash_content', 10, 1 );
function add_custom_class_to_learndash_content( $classes ) {
    // 按需添加生效范围判断，不需要可以注释掉
    // 例1：仅在普通博客文章页生效
    // if ( ! is_singular( 'post' ) ) return $classes;
    // 例2：仅在LearnDash课程页生效
    // if ( ! is_singular( 'sfwd-courses' ) ) return $classes;

    $classes[] = 'my-class';
    return $classes;
}

如果当前使用的LearnDash版本较旧，上述钩子不生效，可以使用第二种通用方案。

如果找不到元素对应的专属钩子，可以通过WordPress的输出缓冲机制，在页面返回给浏览器前替换目标节点代码，不会覆盖元素原有属性：

add_action( 'template_redirect', 'start_learndash_custom_buffer' );
function start_learndash_custom_buffer() {
    // 仅在前台单内容页启动缓冲，不影响后台管理界面
    if ( is_admin() || ! is_singular() ) {
        return;
    }
    ob_start( 'replace_learndash_content_div' );
}

function replace_learndash_content_div( $html ) {
    // 处理目标div无class的情况
    $html = str_replace(
        '<div id="learndash-page-content">',
        '<div id="learndash-page-content" class="my-class">',
        $html
    );
    // 处理目标div已有class的情况，追加自定义类而非覆盖
    $html = preg_replace(
        '/<div id="learndash-page-content" class="([^"]*)">/i',
        '<div id="learndash-page-content" class="$1 my-class">',
        $html
    );
    return $html;
}

• 添加代码到Snippets插件时，要将代码片段设置为前台运行/全站运行，不要设置为仅后台运行
• LearnDash相关内容为自定义文章类型，做范围判断时对应类型名如下：
  • 课程：sfwd-courses
  • 课程课时：sfwd-lessons
  • 测验：sfwd-quiz
  • 普通博客文章：post

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