钩子文档

untrashed_comment

💡 云策文档标注

概述

untrashed_comment 是一个 WordPress 动作钩子,在评论从回收站恢复后立即触发。它允许开发者在评论恢复时执行自定义操作。

关键要点

  • 触发时机:评论从回收站恢复后立即执行
  • 参数:$comment_id(评论ID,字符串类型)和 $comment(WP_Comment 对象,表示恢复的评论)
  • 版本历史:从 WordPress 2.9.0 引入,4.9.0 版本添加了 $comment 参数

代码示例

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

注意事项

  • 此钩子与 wp_untrash_comment() 函数相关,用于从回收站移除评论
  • 参数 $comment 在 WordPress 4.9.0 及更高版本中可用,早期版本可能只传递 $comment_id

📄 原文内容

Fires immediately after a comment is restored from the Trash.

Parameters

$comment_idstring
The comment ID as a numeric string.
$commentWP_Comment
The untrashed comment.

Source

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

Changelog

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