钩子文档

write_your_story

💡 云策文档标注

概述

write_your_story 是一个 WordPress 过滤器,用于修改文章编辑器中正文区域的占位符文本。它允许开发者自定义默认提示信息,以增强用户体验。

关键要点

  • 过滤器名称:write_your_story
  • 参数:$text(占位符文本,默认值为 'Type / to choose a block')和 $post(WP_Post 对象)
  • 用法示例:通过 apply_filters 调用,可参考源代码 $body_placeholder = apply_filters( 'write_your_story', __( 'Type / to choose a block' ), $post );
  • 版本历史:在 WordPress 5.0.0 中引入,5.8.0 中更改了默认占位符文本

📄 原文内容

Filters the body placeholder text.

Parameters

$textstring
Placeholder text. Default ‘Type / to choose a block’.
$postWP_Post
Post object.

Source

$body_placeholder = apply_filters( 'write_your_story', __( 'Type / to choose a block' ), $post );

Changelog

Version Description
5.8.0 Changed the default placeholder text.
5.0.0 Introduced.