钩子文档

post_locked_dialog

💡 云策文档标注

概述

post_locked_dialog 是一个 WordPress 动作钩子,在文章锁定对话框的按钮显示前触发,允许开发者自定义对话框内容或行为。

关键要点

  • 触发时机:在文章锁定对话框的按钮显示之前执行。
  • 参数:$post(WP_Post 对象,表示被锁定的文章)和 $user(WP_User 对象,表示锁定文章的用户)。
  • 用途:常用于扩展或修改锁定对话框的界面或逻辑,例如添加自定义通知或处理锁定状态。
  • 相关函数:_admin_notice_post_locked() 用于输出文章被他人编辑的 HTML 通知。
  • 版本历史:从 WordPress 3.6.0 引入,5.4.0 版本添加了 $user 参数。

📄 原文内容

Fires inside the post locked dialog before the buttons are displayed.

Parameters

$postWP_Post
Post object.
$userWP_User
The user with the lock for the post.

Source

do_action( 'post_locked_dialog', $post, $user );

Changelog

Version Description
5.4.0 The $user parameter was added.
3.6.0 Introduced.