WordPress 块目录：基本指南

WordPress 块目录是 WordPress 用户可以从 WordPress 块编辑器中发现、安装和测试第三方 WordPress 块的一种新方式。 WordPress 5.5 中引入的 WordPress 块目录使您可以更轻松地找到最适合您需求的 WordPress 块。

如果您还没有听说过 WordPress 块目录，那么您并不孤单。 在本指南中，我们将介绍您需要了解的有关新块目录的所有信息。 我们还将解释如何开始使用 Block Director 来简化您的内容工作流程。

什么是 WordPress 块目录？

WordPress 块目录是一类免费的 WordPress 插件，提供第三方 WordPress 块以在 WordPress 块编辑器中使用。

新的 WordPress 块目录内置于块编辑器中，因此您无需离开编辑器即可将新的块类型安装到您的站点。 块目录旨在让用户可以更轻松地直接从块编辑器中搜索和安装 WordPress 块，因此您可以快速将所需的块类型添加到您的内容中。

要搜索 WordPress 块目录，请使用页面左上角的“+”图标使用新的块插入器并搜索可用块。

以下是有关 WordPress 块目录的一些重要注意事项：

• 块目录搜索功能仅适用于有权添加或安装插件的 WordPress 用户角色。
• 如果您从块目录中添加第三方块，则相应的 WordPress 插件将安装在您的站点上。 因此，如果您看到您的网站上安装了一个新插件，但您不记得安装它，请检查该插件是否为 WordPress 块插件。
• WordPres 块目录包含内置的默认 WordPress 块和第三方 WordPress 块插件，因此您可以直接从页面/帖子编辑器安装它们。
• 第三方块插件的搜索结果取决于开发人员必须满足的一些要求（本文稍后会详细介绍）。

WordPress 块目录的历史

WordPress 块目录是关于如何将块插件与 WordPress.org 插件目录中可用的其他免费插件区分开来的 WordPress 核心讨论的结果。

WordPress 块目录工作是一项跨团队开发工作，涉及以下方面的主要更新：

• WordPress 插件更新过程
• WordPress 插件库
• 集成到 WordPress 块编辑器的插入器中

特色古腾堡 WordPress 插件的 8.4 版本是在块目录合并到 WordPress 核心时； 2020 年 8 月 11 日在 WordPress 5.5 中。

WordPress 块目录的目的

新的 WordPress 块目录与主 WordPress.org 插件目录分开，因此您可以浏览常规 WordPress 插件或单块插件。

块目录旨在帮助区分块插件，这些插件仅支持 javascript 且仅注册 WordPress 块，与具有更多功能的传统 WordPress 插件。

什么是 WordPress 块？

WordPress 块是您可以在 WordPress 块编辑器中使用的页面元素，以帮助组织和设计博客文章和页面的内容。 从图像到引用再到列表和媒体嵌入，几乎所有内容都有一个 WordPress 块。

内置默认 WordPress 块

WordPress 带有一个内置默认块的库。 这是一些最常用的块的表格。 此表包含新块编辑器中 WordPress 随附的一些默认 WordPress 块。

当您登录管理仪表板（假设您使用的是 WordPress 5.0 或更高版本）并单击以撰写新帖子时，您会立即注意到一个基于块的内容编辑面板。

以前，帖子编辑器的这一部分是一个包含标准文本格式控件的大内容字段。

当将旧版本的编辑器与基于块的新版本进行比较时，这对用户来说是一次重大升级。

新版本中的整体编辑体验更加流畅且不受干扰。 它使您可以清楚地看到主要“画布”，而没有其他大部分不需要的元素。

什么是 WordPress 块插件？

一种 WordPress 块插件 是一个相对较小、简单的 WordPress 插件，提供单个 WordPress 块。 插件本质上就是块。

WordPress 块目录有助于将第三方块插件组织在与传统 WordPress 插件分开的类别中，以便它们更易于搜索和安装。

您如何使用 WordPress 块？

当您开始为您的网站处理新内容时，无论是新页面还是博客文章，您都会注意到您包含的每个内容片段（例如图像或一段文本）都被转换为自己的块。

您基本上可以将块想象成一个包装器，它放置在您包含在帖子或页面中的每条内容周围。 但是块系统不会单独更改内容片段或它们在您网站上的显示方式。 图像仍然是图像，对最终用户没有任何不同。

您会发现使用块创建内容非常直观。 当您开始创建新页面或帖子时，WordPress 会邀请您选择块类型或开始编写文本。

当您完成一段文本时，按 Enter 键，WordPress 会自动将您转换到一个新块。

如果您想在文本段落之外添加不同的块，只需单击位于左上角块编辑器中的“+”图标。

可供您选择的每种块类型在许多方面都具有高度可定制性。 通过一点时间和实验，您将能够使任何块看起来完全符合您的设想。

块编辑器的好处

基于块的编辑器的引入为 WordPress 内容创建者带来了许多好处。

首先，与以前的编辑器相比，您可以更轻松地重新排列每个页面中的块。 每个块都有单独的控件，允许您将块向上或向下移动一个位置。 您还可以使用拖放功能手动移动块。

在以前的 WordPress 编辑器中，移动内容很痛苦。 首先，您必须将内容剪切并粘贴到您想要放置它们的区域。 通常，这样做会导致很多格式问题； 尽管某些文本编辑器比其他文本编辑器更是如此。 有时，用户会在移动它们之前丢失整个内容部分，因为他们不小心将其复制到剪贴板中。

这些不是您在使用积木时会遇到的问题，而且它们也更具可操作性。

如何使用 WordPress 块目录？

现在我们已经讨论了 WordPress 块是什么，让我们看看新的 WordPress 块目录。

块目录背后的想法并不复杂。 但是，一旦开发人员和站点设计人员了解如何正确使用该工具，它就会非常有用。

当 WordPress 用户想要使用在其编辑器中本地可用的默认 WordPress 块中不可用的块时，他们可以前往插入器的搜索字段并输入关键字，例如“菜单”或“团队”。

在幕后，直观的系统首先在用户的本地站点上运行搜索。 如果无法找到正在搜索的特定块，它将开始搜索块目录：整个 WordPress 插件存储库的指定部分，其中包含单个块插件。

当系统找到与当前搜索词匹配的块时，这些块将显示在插入器中，并提供预览部分供用户查看。

此时，设计者决定他们想要使用哪个块，然后单击“添加块”按钮。 这会导致安装和激活单块插件，而设计者继续创建帖子或页面。

如果第一个块选择不是最佳选择，则用户可以返回并搜索也可以安装的不同块。 这使用户可以快速简便地测试其设计中的不同块元素。

请记住，块目录只能由具有完整站点权限和特权来安装和激活 WordPress 插件的内容创建者访问。

搜索 WordPress 块

搜索功能非常好用。 唯一的问题是当前存储库中缺少插件。 重要的是要记住块目录仍然很新，它的整体功能还没有最终确定。

设计师 Steven Dufresne 和 Enrique Sanchez（以及其他人）一直在积极探索在编辑器中搜索、选择和安装块插件的流程的不同考虑和变化。

例如，当用户运行搜索并且块插件出现在用户已安装在其编辑器中的插入器中时会发生什么？ 它是否应该为该特定搜索结果显示“禁用阻止”？

如果搜索结果显示用户已安装但已停用的块插件怎么办？ 是否应该为此结果显示“Activate Block”？

如您所见，关于块搜索及其交付方式，还有许多悬而未决的问题。

正在与设计人员和开发人员进行讨论。

WordPress 阻止目录搜索性能因素

要使 WordPress 块目录正常工作，有几个因素需要完美对齐。

首先，目录必须有一个唯一的部分，该部分仅指定用于单块插件来填充搜索。 有许多插件有两个或更多的块，不允许在块目录搜索提要中显示。

此后，目录搜索功能必须以可以在插入器中显示的格式返回其结果。

然后块编辑器必须运行一个过程，通过 REST-API 搜索 WordPress 插件目录。 然后，插入器需要一种允许它安装和激活站点插件的方法。

为此，它必须能够考虑当前用户的站点权限。 只有站点管理员才能安装和激活插件。

WordPress 阻止目录搜索结果：要求

插件作者要让他们的插件成为块目录的一部分，他们必须提供一个 block.json 文件和一个要在搜索结果中显示的图像。 对于插件作者来说，记住在用户决定下载插件之前，在预览区域中需要有关插件的其他信息也很重要。

在大多数情况下，用户希望看到插件的：

• 用户评分
• 作者信息
• 上次插件更新的日期

这有助于推动用户决定在其网站上使用哪些块的决策过程。 毕竟，很多人并不仅仅根据事物的外观来决定事物。 他们也想知道引擎盖下是什么。

对于块编辑器来说，自动监控丢弃的插件并确保在保存后从站点卸载未使用的块将是一个好主意（尽管这是一个极其困难的提议，无疑需要进行大量调整）邮政。

避免场地内潜在的“块墓地”也很重要。 使用更新的块管理器，应该可以解决这个问题。 去年，Mel Choyce-Dawn 将其作为初始块目录设计的一部分进行了讨论。 但它不是最初版本的一部分。

WordPress 单块插件列表

如果您转到 WordPress 插件存储库，您将能够浏览 WordPress 块插件，这些插件将在 WordPress 块编辑器中提供您的搜索结果。

在撰写本文时，只有六页结果可供浏览。 实际上，只有大约一半显示在插件存储库搜索中的内容实际上会通过插入器在块编辑器中可见。

通过快速抽查，他们中的很多人似乎完全缺少所需的 block.json 文件。 在这些情况下，插件在 WordPress 块编辑器搜索结果中将不可见，但您会在 WordPress 插件存储库中看到它们。

然而，这似乎在上个月有所改善，因为最终要求已经得到更彻底的记录并发布了关键指南。 越来越多的插件作者开始更新他们的插件，以确保它们在块编辑器中 100% 可搜索。

块目录中当前经过全面测试的单块插件的一些示例包括：

• Automattic 的事件块
• Ham.works 的用户配置文件块
• 苹果地图由 10up 块
• TWST 登录块

TWST 是一个简单但天才的单块插件，允许您在帖子或页面的任何位置插入登录表单。

如何安装新的 WordPress 块

块安装过程对用户来说应该是无缝和直观的。 至少理论上应该是这样。

基本上，用户需要做的就是在不退出块编辑器的情况下单击“添加块”按钮。 所需的新块然后立即可用。

您可能会发现，在某些情况下，您会收到一条错误消息，要求您再次尝试安装。 但在此之前，请务必检查并查看插件是否已实际安装以及块是否可用。

在许多情况下，似乎错误消息本身就是一个错误，并且块已准备就绪。 随着时间的推移，更多这些小错误将得到解决，这个名为 WordPress 块目录的有用新功能将顺利运行。

阻止目录插件作者指南

接近 2019 年底，Meta 团队负责人 Alex Sheils 发布了 WordPress 块插件指南的初始草案，供那些希望将插件添加到块目录中的人使用。 就在几个月前，它已经更新了更详细的要求。

总结要点，块目录上的插件必须具有以下特定特征：

• 仅包含一个块
• 在帖子编辑器之外没有 UI
• 拥有最少量的服务器端代码
• 必须根据特定规范进行结构化并包含 readme.txt 文件

由于规则的严格程度，插件作者遇到了一些管理块目录第一个版本的附加规则。 然而，对目录的限制并不是为了扼杀插件创建者。

目标是将返回块编辑器的块类型限制为特定协议和类型。

这在最初的版本中尤为重要，在这种情况下，结果不是越多越好。 结果需要在插入器中非常具体。

知道这一点，这些附加规则适用于所有想要在 WordPress 块目录上获取插件的插件作者：

• 创建块插件以在块编辑器中使用
• 块插件必须是单独的块
• 插件的标题必须反映块的标题
• 该插件必须包含一个特定的 block.json 文件
• 插件作者不能收取费用或要求为功能付费。 也不允许付费帐户
• 插件应该能够独立运行
• 它不能以任何方式推广其他插件、主题或块

将块目录想象成您刚刚放入地下的未成熟植物。 你知道你需要关注它并保护它，这样它才能成长为更大更好的自己。

块目录也不例外。

随着设计和开发团队继续观察、倾听和解决问题，目录将开始发展成为插件作者和用户发现很多价值的地方。

如果您是插件作者并且您的插件不符合块目录中的要求，请记住它在普通 WordPress 插件目录中仍然受到欢迎。

WordPress 块目录的未来

块目录有可能真正扩展 WordPress 平台的设计功能。 它为内容创建者提供了一种快速、简化的方法，通过指尖访问数十个有用的单个块来扩展他们的内容创建能力。

即使有不断变化的部分，块目录的第一个版本也是一个重要的里程碑，内容创建者和插件作者都应该庆祝。

那些在其发布时阅读本文的人都处于块目录的最前沿以及它将成为什么。 现在是您考虑一些额外的 WordPress 培训的好时机，这些培训将向您展示 WordPress 的其他领域，例如您尚未发现的块目录。

随着您在学习曲线中不断成长，同时将您的网站转变为您预想的成功，请记住错误可能（并且将会）发生。 这就是为什么拥有 WordPress 备份插件和 WordPress 安全插件始终保护您的站点如此重要的原因。

一切就绪后，您的网站可以像 WordPress 块目录一样继续发展和发展。

克里斯汀·赖特

自 2011 年以来，Kristen 一直在编写教程来帮助 WordPress 用户。您通常可以找到她为 iThemes 博客撰写新文章或为 #WPprosper 开发资源。 工作之余，克里斯汀喜欢写日记（她写了两本书！）、远足和露营、烹饪以及与家人一起进行日常冒险，希望过上更现代的生活。