WordPress主题单页评论回复功能故障技术求助

以下是针对评论回复功能问题的具体排查点和修复方案：

1. 修复评论项的HTML ID属性 #

自定义回调函数calb_comment中，评论的<li>标签缺少唯一ID，而comment_reply_link的add_below参数指定为关联标识，需要每个评论项有匹配的ID才能让回复功能正确定位。修改回调函数中的li标签：

<li class="comment" id="comment-<?php comment_ID(); ?>">

同时给article标签添加对应ID（推荐）：

<article class="comment-body" id="div-comment-<?php comment_ID(); ?>">

2. 修正wp_list_comments的调用方式 #

当前手动传递get_comments结果给wp_list_comments会丢失默认的层级控制参数，直接调用并添加max_depth即可，无需手动获取评论：

<div class="comments">
    <h2 class="comments-title">نظرات</h2>
    <?php
    if (have_comments()) :
        wp_list_comments([
            'type' => 'comment',
            'style' => 'ul',
            'callback' => 'calb_comment',
            'max_depth' => 3 // 按需设置允许的最大嵌套深度
        ]);
    endif;
    ?>
</div>

3. 加载评论回复所需的JS脚本 #

WordPress评论回复的动态效果依赖comment-reply.js脚本，在主题的functions.php中添加加载代码：

function enqueue_comment_reply_script() {
    if (is_singular() && comments_open() && get_option('thread_comments')) {
        wp_enqueue_script('comment-reply');
    }
}
add_action('wp_enqueue_scripts', 'enqueue_comment_reply_script');

4. 检查评论表单的参数配置 #

comment_form中url字段设置了不必要的required=""属性，移除它避免验证错误：

'url' => '<div class=" col-md-4">
    <div class="form-group ">
        <input type="text" name="url" class="form-control" placeholder="وب سایت">
    </div>
</div></div>'

同时确保WordPress后台设置-讨论中已勾选「启用嵌套评论」，层级数与max_depth保持一致。

完整修改后的回调函数示例 #

function calb_comment($comment, $args, $depth)
{
    ?>
    <li class="comment" id="comment-<?php comment_ID(); ?>">
        <article class="comment-body" id="div-comment-<?php comment_ID(); ?>">
            <footer class="comment-meta">
                <div class="comment-author ">
                    <?php echo get_avatar($comment, '128'); ?>
                    <?php printf( __( '<b class="fn">%s</b> <span class="says">says:</span>' ), get_comment_author_link() ); ?>
                </div><!-- .comment-author -->

                <div class="comment-metadata">
                    <a href="<?php echo htmlspecialchars( get_comment_link( $comment->comment_ID ) ); ?>">
                    <?php
                    /* translators: 1: date, 2: time */
                    printf( 
                        __('%1$s at %2$s'), 
                        get_comment_date('l,Y,m'),  
                        get_comment_time() 
                    ); ?>
                    </a>
                </div><!-- .comment-metadata -->

            </footer><!-- .comment-meta -->

            <div class="comment-content">
            <?php comment_text(); ?>
            </div><!-- .comment-content -->

            <div class="reply">
                <?php 
                comment_reply_link( 
                    array_merge( 
                        $args, 
                            array( 
                                'add_below' => 'div-comment', // 对应article的ID前缀
                                'depth'      => $depth,
                                'max_depth' => $args['max_depth']
                            ) 
                    )
                ); ?>
            </div>
        </article><!-- .comment-body -->
    </li><!-- #comment-## -->
    <?php
}

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