开发WordPress主题时，修改评论HTML结构需用哪个过滤器钩子？

如果你正在用wp_list_comments()输出评论，想要重构HTML结构，有两个核心过滤器钩子可以根据需求选择：

1. wp_list_comments_args（推荐用于完全重构） #

这个过滤器允许你修改wp_list_comments()的参数数组，最常用的是替换默认的评论渲染回调函数，从而完全自定义评论的HTML结构。

示例代码：

add_filter( 'wp_list_comments_args', 'custom_comment_render_args' );
function custom_comment_render_args( $args ) {
    // 指定自定义的评论渲染函数
    $args['callback'] = 'my_custom_comment_template';
    return $args;
}

// 自定义评论渲染函数，这里写你想要的HTML结构
function my_custom_comment_template( $comment, $args, $depth ) {
    $GLOBALS['comment'] = $comment;
    ?>
    <li class="custom-comment" id="li-comment-<?php comment_ID(); ?>">
        <div class="comment-header">
            <?php echo get_avatar( $comment, 60 ); ?>
            <div class="comment-author-info">
                <h4><?php comment_author_link(); ?></h4>
                <span class="comment-date"><?php printf( '%s at %s', get_comment_date(), get_comment_time() ); ?></span>
            </div>
        </div>
        <?php if ( $comment->comment_approved === '0' ) : ?>
            <p class="comment-pending">你的评论正在等待审核</p>
        <?php endif; ?>
        <div class="comment-content">
            <?php comment_text(); ?>
        </div>
        <div class="comment-reply">
            <?php comment_reply_link( array_merge( $args, [ 'depth' => $depth, 'max_depth' => $args['max_depth'] ] ) ); ?>
        </div>
    </li>
    <?php
}

2. comment_list_item（适合小范围修改，WP 5.5+可用） #

这个钩子直接作用于单个评论生成后的HTML代码，你可以通过字符串替换等方式快速调整现有结构，无需重写整个渲染函数。

示例代码：

add_filter( 'comment_list_item', 'tweak_comment_html_structure' );
function tweak_comment_html_structure( $comment_html ) {
    // 给评论li标签添加自定义类
    $comment_html = str_replace( '<li ', '<li class="theme-comment-item" ', $comment_html );
    // 替换默认的"says:"文本
    $comment_html = str_replace( '<span class="says">says:</span>', '<span class="comment-label">评论：</span>', $comment_html );
    return $comment_html;
}

选择建议 #

• 如果你需要完全重构评论的HTML结构，优先用wp_list_comments_args替换回调函数，这种方式更灵活，能精准控制每个元素的输出。
• 只是小调整现有结构（比如加个类、改个文本），用comment_list_item更高效。

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