WordPress 6.7 中的新插件模板注册 API

自从引入块主题以来,主题开发者就能够创建自定义块模板。但是,这种可能性仅限于主题,插件无法直接注册自己的模板。为了实现类似的功能,插件必须采用复杂的方法,包括挂接多个PHP过滤器、手动创建WP_Block_Template对象以及复制内部 WordPress 逻辑。

WordPress 6.7 中的新插件模板注册 API

WordPress 6.7 引入了一个新的API,它将大大简化插件注册自己的块模板的过程。为了实现这一点,引入了两个新功能:register_block_template()用于注册块模板和unregister_block_template()用于取消注册块模板。

register_block_template( string $template_name, $args = array() )接受两个参数,定义模板如何注册:

  • $template_name:模板名称,形式为plugin_uri//template_name(请注意,这需要双//)。
  • $args:用于定义模板的参数数组:
    • title:模板的国际化标题。
    • description:模板的国际化描述。
    • content:模板在编辑器或前端呈现时的默认内容(块标记)。
    • post_types:一系列帖子类型 slug,可作为每个帖子的自定义模板提供给用户。
WordPress 6.7 中的新插件模板注册 API

例如,插件可以使用以下代码片段注册模板:

register_block_template( 'devblog-plugin-templates//my-template', [
    'title'     => __( 'Example', 'devblog-plugin-templates' ),
    'description' => __( 'An example block template from a plugin.', 'devblog-plugin-templates' ),
    'content'   => '
        <!-- wp:template-part {"slug":"header","area":"header","tagName":"header"} /-->
        <!-- wp:group {"tagName":"main"} -->
        <main class="wp-block-group">
            <!-- wp:group {"layout":{"type":"constrained"}} -->
            <div class="wp-block-group">
                <!-- wp:paragraph -->
                <p>This is a plugin-registered template.</p>
                <!-- /wp:paragraph -->
            </div>
            <!-- /wp:group -->
        </main>
        <!-- /wp:group -->
        <!-- wp:template-part {"slug":"footer","area":"footer","tagName":"footer"} /-->'

一旦注册,该模板将与站点编辑器中的所有其他模板一起出现:

WordPress 6.7 中的新插件模板注册 API

并且,如果需要,可以稍后使用以下命令取消注册:

	unregister_block_template( 'devblog-plugin-templates//my-template' )

插件还可以覆盖 WordPress 模板层次结构中的模板,例如自定义帖子类型的存档页面或特定作者页面。

主题模板优先于插件注册的模板,允许主题覆盖特定的插件模板,就像使用 WordPress 模板一样。

目前该API仅限于块模板,不允许注册块模板部分。

WordPress 6.7 中的新插件模板注册 API

联系我们
文章看不懂?联系我们为您免费解答!免费助力个人,小企站点!
电话:020-2206-9892
QQ咨询:1025174874
邮件:info@361sale.com
工作时间:周一至周五,9:30-18:30,节假日休息
发布者:光子波动,转转请注明出处:https://www.361sale.com/21929/

(1)
上一篇 2天前
下一篇 1天前

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

联系我们

020-2206-9892

QQ咨询:1025174874

邮件:info@361sale.com

工作时间:周一至周五,9:30-18:30,节假日休息

客服微信