插件基础知识
入门
最简单的来说,WordPress 插件是一个带有 WordPress 插件标头注释的 PHP 文件。强烈建议您创建一个目录来保存您的插件,以便将所有插件的文件整齐地组织在一个位置。
要开始创建新插件,请按照以下步骤操作。
导航到 WordPress 安装的 wp-content目录。
打开插件目录。
创建一个新目录并以插件命名(例如plugin-name)。
打开新插件的目录。
创建一个新的 PHP 文件(最好以您的插件命名该文件,例如plugin-name.php)。
该过程在 Unix 命令行上如下所示:
wordpress $ cd wp-content
wp-content $ cd plugins
plugins $ mkdir plugin-name
plugins $ cd plugin-name
plugin-name $ vi plugin-name.php
在上面的示例中,vi
是文本编辑器的名称。使用您觉得舒服的编辑器。
现在您正在编辑新插件的 PHP 文件,您需要添加插件标头注释。这是一个特殊格式的 PHP 块注释,其中包含有关插件的元数据,例如名称、作者、版本、许可证等。插件标头注释必须符合标头要求,并且至少包含插件 的名称插入。
插件文件夹中只有一个文件应具有标题注释 - 如果插件有多个 PHP 文件,则只有其中一个文件应具有标题注释。
保存文件后,您应该能够在 WordPress 站点中看到列出的插件。登录到您的 WordPress 站点,然后单击WordPress 管理员左侧导航窗格中的插件。此页面显示您的 WordPress 网站拥有的所有插件的列表。您的新插件现在应该在该列表中!
挂钩:操作和过滤器
WordPress 挂钩允许您在特定点接入 WordPress 来更改 WordPress 的行为方式,而无需编辑任何核心文件。
WordPress 中有两种类型的挂钩:操作和过滤器。操作允许您添加或更改 WordPress 功能,而过滤器允许您在加载并向网站用户显示内容时更改内容。
Hooks 不仅仅适用于插件开发者;它也适用于插件开发者。WordPress 核心本身广泛使用 hooks 来提供默认功能。其他挂钩是未使用的占位符,当您需要更改 WordPress 的工作方式时,可以轻松使用它们。这就是 WordPress 如此灵活的原因。
基本挂钩
创建插件时需要的 3 个基本钩子是register_activation_hook()、register_deactivation_hook()和register_uninstall_hook()。
当您激活插件时,register_activation_hook就会运行。您可以使用它来提供设置插件的功能 - 例如,在表中创建一些默认设置。options
当您停用插件时,register_deactivation_hook就会运行。您可以使用它来提供一个函数来清除插件存储的任何临时数据。
这些register_uninstall_hook方法用于在使用 WordPress 管理员删除插件后进行清理。您可以使用它来删除插件创建的所有数据,例如添加到表中的任何选项options
。
添加挂钩
您可以使用do_action()添加您自己的自定义挂钩,这将使开发人员能够通过挂钩传递函数来扩展您的插件。
拆除挂钩
您还可以使用调用remove_action() 来删除之前定义的函数。例如,如果您的插件是另一个插件的附加组件,则可以将remove_action() 与上一个插件通过add_action()添加的相同函数回调一起使用。在这些情况下,操作的优先级很重要,因为remove_action() 需要在初始add_action()之后运行。
从钩子中删除操作以及更改优先级时应该小心,因为很难看出这些更改将如何影响与同一钩子的其他交互。我们强烈建议经常进行测试。
您可以在本手册的“钩子”部分了解有关创建钩子以及与它们交互的更多信息。
WordPress API
您是否知道 WordPress 提供了许多应用程序编程接口 (API)?这些 API 可以极大地简化您需要在插件中编写的代码。您不想重新发明轮子,尤其是当这么多人为您完成了大量工作和测试时。
最常见的是Options API,它可以轻松地将数据存储在插件的数据库中。如果您正在考虑在插件中使用cURL ,那么您可能会对HTTP API感兴趣。
由于我们谈论的是插件,因此您需要研究Plugin API。它具有多种功能可以帮助您开发插件。
WordPress 如何加载插件
当 WordPress 在 WordPress 管理员的插件页面上加载已安装插件的列表时,它会搜索该plugins
文件夹(及其子文件夹)以查找带有 WordPress 插件标头注释的 PHP 文件。如果您的整个插件仅包含一个 PHP 文件(例如Hello Dolly ),则该文件可以直接位于plugins
文件夹的根目录内。但更常见的是,插件文件将驻留在自己的文件夹中,以插件命名。
分享你的插件
有时您创建的插件仅适用于您的网站。但许多人喜欢与 WordPress 社区的其他成员分享他们的插件。在共享您的插件之前,您需要做的一件事是选择许可证。这可以让您的插件的用户知道他们如何被允许使用您的代码。为了保持与 WordPress 核心的兼容性,建议您选择适用于 GNU 通用公共许可证 (GPLv2+) 的许可证。
无评论