钩子文档

unspam_comment

💡 云策文档标注

概述

unspam_comment 是一个 WordPress 动作钩子,在评论被从垃圾评论状态移除前立即触发。它允许开发者在评论状态变更时执行自定义操作。

关键要点

  • 触发时机:评论被标记为非垃圾评论之前
  • 参数:$comment_id(评论 ID 字符串)和 $comment(WP_Comment 对象)
  • 版本历史:从 WordPress 2.9.0 引入,4.9.0 版本添加了 $comment 参数

代码示例

do_action( 'unspam_comment', $comment->comment_ID, $comment );

注意事项

  • 此钩子与 wp_unspam_comment() 函数相关,用于从垃圾评论中移除评论
  • 开发者可以利用此钩子添加日志记录、通知或其他自定义逻辑

📄 原文内容

Fires immediately before a comment is unmarked as Spam.

Parameters

$comment_idstring
The comment ID as a numeric string.
$commentWP_Comment
The comment to be unmarked as spam.

Source

do_action( 'unspam_comment', $comment->comment_ID, $comment );

Changelog

Version Description
4.9.0 Added the $comment parameter.
2.9.0 Introduced.