WordPress插件入门基础知识

130 2025-06-29 Google SEO 手机阅读

WordPress插件入门基础知识

简单来说，WordPress 插件就是一个带有 WordPress 插件头注释的 PHP 文件。强烈建议您创建一个目录来存放插件，以便所有插件文件都能整齐地组织在一个地方。

要开始创建新插件，请按照以下步骤操作。

导航到 WordPress 安装的 wp-content目录。

打开插件目录plugins。

创建一个新目录并以插件的名字命名（例如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 中有两种类型的钩子：操作和过滤器。操作允许您添加或更改 WordPress 功能，而过滤器允许您在内容加载并显示给网站用户时对其进行更改。

钩子并非插件开发者的专属工具；WordPress 核心本身也广泛使用钩子来提供默认功能。其他钩子则是一些未使用的占位符，方便您在需要调整 WordPress 工作方式时使用。这正是 WordPress 如此灵活的原因。

WordPress基本钩子

创建插件时需要的 3 个基本钩子是register_activation_hook()、register_deactivation_hook()和register_uninstall_hook()。

激活钩子会在你激活插件时运行。你可以使用它来提供设置插件的功能——例如，在options表中创建一些默认设置。

停用插件时会运行停用钩子。您可以使用它来提供清除插件存储的所有临时数据的功能。

这些卸载方法用于在使用 WordPress 管理界面删除插件后进行清理。您可以使用它们来删除插件创建的所有数据，例如添加到options表格中的任何选项。

WordPress添加钩子

您可以使用do_action()添加自己的自定义钩子，这将允许开发人员通过钩子传递函数来扩展您的插件。

WordPress移除钩子

您还可以使用 invoke remove_action() 来移除先前定义的函数。例如，如果您的插件是另一个插件的附加组件，则可以将remove_action()与先前插件通过add_action() 添加的相同函数回调一起使用。在这种情况下，操作的优先级很重要，因为remove_action() 需要在初始add_action()之后运行。

从钩子中移除操作以及更改优先级时应格外小心，因为很难看出这些更改会对同一钩子的其他交互产生什么影响。我们强烈建议您经常进行测试。

您可以在本手册的“钩子”部分了解有关创建钩子以及如何与钩子交互的更多信息。

WordPress API

您知道 WordPress 提供了许多应用程序编程接口 (API)吗？这些 API 可以大大简化您在插件中需要编写的代码。您肯定不想再重复造轮子，尤其是在这么多人已经为您完成大量工作和测试的情况下。

最常见的是Options API，它可以轻松地将数据存储到插件的数据库中。如果您正在考虑在插件中使用cURL ，那么HTTP API可能会让您感兴趣。

既然我们在讨论插件，你肯定需要学习一下插件 API。它有各种各样的函数可以帮助你开发插件。

WordPress 如何加载插件

当 WordPress 在 WordPress 管理员的“插件”页面上加载已安装插件列表时，它会搜索该plugins文件夹（及其子文件夹），以查找带有 WordPress 插件标头注释的 PHP 文件。如果您的整个插件仅包含一个 PHP 文件（例如Hello Dolly），则该文件可能直接位于plugins文件夹的根目录中。但更常见的是，插件文件会位于以插件名称命名的独立文件夹中。

分享你的插件

有时，您创建的插件仅用于您的网站。但许多人喜欢与 WordPress 社区的其他成员分享他们的插件。在分享您的插件之前，您需要做的一件事是选择一个许可证。这可以让您的插件用户了解他们被允许如何使用您的代码。为了保持与 WordPress 核心的兼容性，建议您选择与 GNU 通用公共许可证 (GPLv2+) 兼容的许可证。