钩子文档

unspammed_comment

💡 云策文档标注

概述

unspammed_comment 是一个 WordPress 动作钩子,在评论被从垃圾评论状态移除后立即触发。它提供了评论 ID 和评论对象作为参数,方便开发者执行相关操作。

关键要点

  • 触发时机:评论被取消标记为垃圾后立即执行
  • 参数:$comment_id(评论 ID,字符串类型)和 $comment(WP_Comment 对象)
  • 版本历史:从 WordPress 2.9.0 引入,4.9.0 版本添加了 $comment 参数
  • 相关函数:wp_unspam_comment() 用于从垃圾评论中移除评论

代码示例

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

注意事项

此钩子主要用于在评论状态变更时执行自定义逻辑,如更新相关数据或发送通知。


📄 原文内容

Fires immediately after a comment is unmarked as Spam.

Parameters

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

Source

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

Changelog

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