'mytheme_comment_item'，四处必须一致。
* TODO 2. mytheme-comment-text 是给评论正文预留的钩子类名（本文件不写任何自定义 CSS），
* 需要给它加排版规则时写在 assets/css/theme.css，改完重新执行 npm run build:css。
* TODO 3. 表单与回复入口的中文文案（「发表评论」「回复」「邮箱不会公开显示……」）按站点语言自行替换。
*
* 说明：
* 1. 头像不使用 Gravatar 外链（国内访问不稳定），改为按昵称哈希取固定配色 + 首字的占位头像，同一昵称始终同色；
* 2. 评论区只在文章详情页输出（由 single.php 调用 comments_template()），页面模板不要调用；
* 3. 样式全部使用 daisyUI / Tailwind 类名，新增或修改类名后需执行 `npm run build:css`。
*
* 依赖：无第三方依赖，仅用 WordPress 自带函数与 PHP 的 mbstring 扩展（mb_substr / mb_strtoupper）。
*
* @package mytheme
*/
// 防止直接访问该文件。
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
/**
* 按昵称取占位头像的配色类（同一昵称结果固定）。
*
* @param string $name 评论者昵称。
* @return string daisyUI 背景与前景色类名。
*/
function mytheme_avatar_color_class( $name ) {
$mytheme_palette = array(
'bg-primary text-primary-content',
'bg-secondary text-secondary-content',
'bg-accent text-accent-content',
'bg-info text-info-content',
'bg-success text-success-content',
'bg-neutral text-neutral-content',
);
$mytheme_index = abs( crc32( (string) $name ) ) % count( $mytheme_palette );
return $mytheme_palette[ $mytheme_index ];
}
/**
* 取昵称首字：中文取第一个字，英文取首字母并大写。
*
* @param string $name 评论者昵称。
* @return string 单个字符。
*/
function mytheme_avatar_initial( $name ) {
$mytheme_name = trim( wp_strip_all_tags( (string) $name ) );
if ( '' === $mytheme_name ) {
return '?';
}
return mb_strtoupper( mb_substr( $mytheme_name, 0, 1 ) );
}
/**
* 取「真实评论」数量：排除 pingback / trackback 引用通告。
*
* 说明：get_comments_number() 会把引用通告也算作评论，导致评论数偏大（文章互相内链会
* 产生自引用 pingback），因此前台展示统一用本函数。
*
* @param int|null $post_id 文章 ID，默认当前文章。
* @return int 已批准的真实评论数。
*/
function mytheme_real_comment_count( $post_id = null ) {
$mytheme_post_id = $post_id ? (int) $post_id : (int) get_the_ID();
if ( $mytheme_post_id < 1 ) {
return 0;
}
return (int) get_comments(
array(
'post_id' => $mytheme_post_id,
'type' => 'comment',
'status' => 'approve',
'count' => true,
)
);
}
/**
* 输出评论数徽标（仅在真实评论数大于 0 时输出，避免出现「0 评论」与引用通告带来的虚高）。
*
* 数量为 0 时函数直接返回、不输出任何内容，因此调用处不需要写 if。
*
* @param int|null $post_id 文章 ID，默认当前文章。
* @param bool $link_to_comments 是否渲染为跳到评论区的链接（详情页用）。
*/
function mytheme_comment_count_badge( $post_id = null, $link_to_comments = false ) {
$mytheme_count = mytheme_real_comment_count( $post_id );
if ( $mytheme_count < 1 ) {
return;
}
$mytheme_label = esc_html( number_format_i18n( $mytheme_count ) );
$mytheme_icon = '';
if ( $link_to_comments ) {
echo '' . $mytheme_icon . ' ' . $mytheme_label . ''; // phpcs:ignore WordPress.Security.EscapeOutput -- 图标为本函数内固定字符串，文字已转义。
return;
}
echo '' . $mytheme_icon . ' ' . $mytheme_label . ''; // phpcs:ignore WordPress.Security.EscapeOutput -- 同上。
}
/**
* 单条评论的渲染回调（由 wp_list_comments() 调用）。
*
* 注意：结束标签 由 Walker_Comment 自动补全，本回调不要输出。
*
* @param WP_Comment $comment 评论对象。
* @param array $args wp_list_comments() 参数。
* @param int $depth 当前嵌套层级。
*/
function mytheme_comment_item( $comment, $args, $depth ) {
// 引用通告（pingback / trackback）不是读者评论：用紧凑行展示「引用通告 + 来源标题」，
// 不显示头像与「回复」入口，也不参与评论数统计。
if ( in_array( (string) $comment->comment_type, array( 'pingback', 'trackback' ), true ) ) {
?>