register_block_pattern 注册自定义Pattern
文 / @WordPress主题
函数功能
本函数用于将自定义Pattern注册到WordPress古腾堡编辑器中。
函数参数
参数 | 数据类型 | 是否必需 | 描述 | 默认值 |
---|---|---|---|---|
$pattern_name | 字符串 | 是 | 包含命名空间的Pattern名称 | 无 |
$pattern_properties | 数组 | 是 | 包含Pattern属性的数组。 | 无 |
$pattern_properties数组可以包含以下几项数据:
参数 | 数据类型 | 是否必需 | 描述 |
---|---|---|---|
title | 字符串 | 是 | 模式标题 |
content | 字符串 | 是 | 古腾堡编辑器的内容代码 |
description | 字符串 | 否 | Pattern作用的详细说明 |
categories | 字符串 | 否 | Pattern分类 |
keywords | 字符串 | 否 | Pattern关键词,用于搜索 |
viewportWidth | 字符串 | 否 | 在插入时指定Pattern的宽度 |
函数返回值
如果自定义Pattern注册成功,返回true,否则为false。
使用示例
下面的示例注册了一个包含两个按钮的自定义Pattern。数组中content的内容可以在古腾堡编辑器中编辑好后,切换到古腾堡编辑器的代码模式,直接复制代码过来。
register_block_pattern(
'wpdocs-my-plugin/my-awesome-pattern',
array(
'title'=>__('Twobuttons','wpdocs-my-plugin'),
'description'=>_x('Twohorizontalbuttons,theleftbuttonisfilledin,andtherightbuttonisoutlined.','Blockpatterndescription','wpdocs-my-plugin'),
'content'=>"<!--wp:buttons{\"align\":\"center\"}-->\n<divclass=\"wp-block-buttonsaligncenter\"><!--wp:button{\"backgroundColor\":\"very-dark-gray\",\"borderRadius\":0}-->\n<divclass=\"wp-block-button\"><aclass=\"wp-block-button__linkhas-backgroundhas-very-dark-gray-background-colorno-border-radius\">".esc_html__('ButtonOne','wpdocs-my-plugin')."</a></div>\n<!--/wp:button-->\n\n<!--wp:button{\"textColor\":\"very-dark-gray\",\"borderRadius\":0,\"className\":\"is-style-outline\"}-->\n<divclass=\"wp-block-buttonis-style-outline\"><aclass=\"wp-block-button__linkhas-text-colorhas-very-dark-gray-colorno-border-radius\">".esc_html__('ButtonTwo','wpdocs-my-plugin')."</a></div>\n<!--/wp:button--></div>\n<!--/wp:buttons-->"
)
);
相关文章
-
如何创建WordPress古腾堡编辑器的区块(PHP+原生JS) 2024-01-10 01:01:06
-
搭建一个WordPress网站需要多少成本 2023-11-06 00:09:51
-
Symlink介绍(附:如何使用Symlink进行WordPress开发) 2023-11-05 23:38:32
-
让WordPress实现数据库同步的插件:HyperDB 2023-10-24 23:40:49
-
allegro电商平台值得做吗(附:2023年Allegro注册流程指南) 2023-10-08 21:53:39
-
印度跨境电商平台有哪些(附:印度跨境电商做什么产品好) 2023-10-08 21:34:23
-
跨境电商必看的几大海外二手电商平台 2023-10-08 18:04:42
-
WordPress同城互联网产品解决方案:UBASE 2023-10-03 16:40:39
-
WordPress网站的安全插件:wordfence 2023-09-14 09:25:18
-
WordPress 6.3 支持在手动更新插件和主题失败后回滚旧版本 2023-08-28 16:58:45