本指南旨在通过动手实践的方式演示 WordPress 中块开发的基本原理。按照以下步骤操作,您只需几分钟即可创建一个使用现代 JavaScript(ESNext 和 JSX)的自定义块插件。示例块显示版权符号 (©) 和当前年份,是任何网站页脚的理想补充。您可以通过这段简短的视频演示来查看这些步骤的实际效果。

搭建块插件

首先,请确保您的计算机上已安装 Node.js 和 npm。如果没有,请查阅 Node.js 开发环境 指南。

接下来,使用 @wordpress/create-block 包和 @wordpress/create-block-tutorial-template 模板来搭建完整的“版权日期块”插件。

您可以使用 create-block 在任何位置搭建块,然后在生成的插件文件夹中使用 wp-env。这将在您的新块插件已安装并激活的情况下创建本地 WordPress 开发环境。
如果您已经有了自己的 本地 WordPress 开发环境,请使用终端导航到 plugins/ 文件夹。

选择要创建插件的文件夹,然后在该文件夹内从终端执行以下命令:

npx @wordpress/create-block copyright-date-block --template @wordpress/create-block-tutorial-template

提供的 slug(copyright-date-block)定义了搭建的插件文件夹名称和内部块名称。

导航到本地 WordPress 安装的插件页面并激活“版权日期块”插件。示例块随后将在编辑器中可用。

基本用法

激活插件后,您可以探索该块的工作原理。使用以下命令进入新创建的插件文件夹并开始开发过程。

cd copyright-date-block && npm start

当 create-block 搭建块时,它会安装 wp-scripts 并向块的 package.json 文件添加最常见的脚本。有关此包的简介,请参阅 使用 wp-scripts 入门 文章。

npm start 命令将启动开发服务器并监视块代码的更改,每当进行修改时重新构建块。

完成修改后,运行 npm run build 命令。这将优化块代码并使其准备好用于生产环境。

查看块的运行情况

您可以使用任何本地 WordPress 开发环境来测试新块,但搭建的插件包含针对 wp-env 的配置。您必须已经在机器上安装并运行 Docker,但如果有的话,请运行 npm run env start 命令。

脚本运行完成后,您可以访问本地环境:http://localhost:8888。使用用户名 admin 和密码 password 登录 WordPress 仪表板。插件将已安装并激活。打开编辑器或站点编辑器,像插入任何其他块一样插入版权日期块。

访问 入门 指南以了解有关 wp-env 的更多信息。

其他资源