WordPress hook钩子comment_moderation_text的用法详解

WordPress的评论系统有很多钩子（hooks），可以让开发者在特定的时机插入自己的代码，完成一些自定义的功能。其中，comment_moderation_text是一个用于自定义评论审批文本的钩子。

当管理员需要审批或拒绝一条评论时，WordPress会调用comment_moderation_text钩子，传递评论数据给已注册的回调函数。通过在回调函数中修改评论审批文本，开发者可以实现自定义的审批信息。

以下是comment_moderation_text钩子的使用方式：

1. 注册一个回调函数

function my_custom_comment_moderation_text($text, $comment) {
// 在此处修改评论审批文本
return $text;
}
add_filter('comment_moderation_text', 'my_custom_comment_moderation_text', 10, 2);

2. 添加自定义功能

在回调函数中，可以根据需要修改评论审批文本。例如，以下代码将在审批文本中显示评论的发表者IP地址和邮箱：

function my_custom_comment_moderation_text($text, $comment) {
// 获取评论的发表者IP地址和邮箱
$ip = $comment->comment_author_IP;
$email = $comment->comment_author_email;

// 修改评论审批文本
$text .= "n发表者IP地址: $ip";
$text .= "n发表者邮箱: $email";

return $text;
}
add_filter('comment_moderation_text', 'my_custom_comment_moderation_text', 10, 2);

3. 保存修改后的评论审批文本

通过添加评论审批文本之后，需要点击“修改”或“拒绝”按钮来保存修改后的审批文本。

注意事项：
- callback函数中的第一个参数为当前的评论审批文本，第二个参数为当前评论的对象。
- 使用add_filter函数将回调函数注册到comment_moderation_text钩子上，第一个参数为钩子名称，第二个参数为回调函数的名称，第三个参数为优先级（数字越低优先级越高），第四个参数为回调函数的参数数量。

总结：
comment_moderation_text钩子在管理员审批或拒绝评论时调用，允许开发者自定义评论审批文本。通过注册一个回调函数，并在其中修改审批文本，可以实现自定义的评论审批信息。