博客

您已经运行WordPress网站一段时间了，它一直在做您需要做的事情。但是现在，您决定需要对其进行自定义。

或者，您可能正在使用从主题目录下载的主题或已购买的主题创建站点，但您意识到它不能完全按照您的需要运行。

那你怎么办呢？

您可以找到一个插件来提供您需要的自定义或切换到新主题。但是，如果您对当前的主题感到满意并且找不到可以添加您需要的功能的插件怎么办？

答：您需要自定义您的主题。最佳实践说：您通过（WordPress）子主题来做到这一点。

在本教程中，我们将更多地讨论子主题是什么以及它是如何工作的。我们还将带您完成从头开始创建主题的过程，并向您展示如何将修改后的主题变成子主题。

修改现有主题是开始WordPress开发的好方法。更改的结果将很容易看到和理解。但是，直接对活动主题进行编辑可能会导致问题，因为即使是一个小错误也可能导致主题无法使用。每当主题更新时，您所做的所有更改也将丢失。

然而，有一种方法可以避免这些问题，那就是创建“子主题”。子主题的工作方式与任何其他WordPress主题大致相同，不同之处在于它使用现有主题作为基础（或“父”）。您对子主题所做的更改将反映在您的站点上，而无需直接更改父主题。

1. 自定义WordPress的方法
2. 什么是WordPress子主题？
3. 何时在WordPress中使用子主题（优点）
4. 何时不使用WordPress子主题（缺点）
5. 如何创建WordPress子主题
6. 如何激活WordPress子主题
7. 如何在WordPress中自定义您的子主题
8. 如何对子主题和父主题进行故障排除
9. 使用WordPress子主题时的有用提示

自定义WordPress的方法

自定义主题有风险。如果您在第三方主题（例如您从市场上购买的主题）中编辑代码，那么当您下次更新主题时，您所做的所有更改都将丢失。这意味着您的网站不仅会恢复原状，而且您的所有工作都被浪费了。

可以通过三种方式自定义您的WordPress网站：

• 直接编辑您的主题。
• 安装插件。
• 创建当前主题的子主题。

让我们依次来看看其中的每一个。

编辑您的主题

如果您的网站运行自定义WordPress主题，这意味着它是专门为您的网站开发的，您可以选择安全地编辑它，因为下次更新主题时不会丢失您的自定义设置。

相反，如果您或您的开发人员将来对主题进行更改，您将编辑的是主题的自定义版本，而不是更改之前的原始版本。

这并不意味着编辑您的主题并非没有风险。如果您没有编写主题的经验，创建子主题可能仍然更安全（我们稍后会看到如何）。这是我做的事情：我有一个基本主题，我在我所有的网站上使用，具有标准布局、钩子和函数，然后我在每个网站上使用子主题对其进行自定义。

如果您直接编辑主题，请确保保留原始主题的备份，不要在实时站点中编辑主题（改用开发或临时站点），并使用版本控制来跟踪您的更改。

如果您使用的是第三方主题，则永远不要直接编辑它。相反，使用插件或创建子主题。

添加插件

自定义WordPress主题的第二个选项是安装或编写插件。

如果您要进行的自定义是功能性的而不是与设计相关的，那么插件是一种更合适的方法。所以如果你想添加额外的代码，最好还是创建一个插件。

插件不必很大或很复杂：如果您需要向主题中的functions.php文件添加额外的代码，请创建一个简单的插件来向您的站点添加几行代码。一个很好的例子是注册自定义文章类型。

将代码添加到主题的functions.php可能很诱人，但添加帖子类型是对网站的功能更改，而不是设计更改。如果您以后要切换主题，您不会希望丢失这些帖子类型以及您使用它们创建的所有帖子。这就是为什么您应该安装或创建插件的原因。

有时您可以找到一个现有的插件来满足您的需求，但有时您可能需要自己编写插件代码。

WordPress插件库

如果对是否应该创建插件或自定义主题（或子主题）有疑问，请问自己：如果我想在将来更改网站的设计并安装新的WordPress主题，我是否希望保留此更改? 如果答案是肯定的，这意味着更改是功能性的而不是美学的，它应该包含在插件中。

创建子主题

自定义WordPress主题的第三个选项是创建子主题。

以下是您使用子主题的一些场景：

• 您希望更改网站的设计，而不是功能。
• 您的网站正在运行第三方主题或您想在当前状态下再次使用的主题。
• 您不想直接编辑现有主题，以防它引起问题（可能您不是经验丰富的主题开发人员）。
• 您的站点正在运行一个设计为父主题的主题，例如框架主题。这些主题具有许多自定义选项，例如hooks，专为您添加到您自己的子主题而设计。

因此，子主题是一种向您的网站添加自定义内容的有效且安全的方式。因此，让我们更深入地了解它们。

什么是WordPress子主题？

那么，WordPress中的子主题究竟是什么？它是如何工作的？

子主题是与另一个主题协同工作的主题，称为父主题。

它包含一些特定的说明来告诉WordPress这是一个子主题以及父主题是什么。WordPress 然后在大多数情况下使用来自父主题的代码，但会使用来自子主题的代码（如有必要）覆盖它。

在许多方面，子主题的功能就像一个“正常”的WordPress主题。它以相同的方式安装、启用和配置。子主题的独特之处在于它依赖于另一个主题来确定其大部分内容。另一个主题被称为“父主题”。

WordPress将始终优先考虑子主题的设置。因此，你能想到的子主题为坐在前面的家长。如果子主题中的设置覆盖了父主题中的匹配设置，则子主题优先。这使您可以仅更改要更改的主题部分，其他所有内容都由现有父级处理。

例如，大多数父主题包含定义不同标题文本级别的样式，例如h1、h2、h3、h4等。假设父主题将h1字体大小定义为20px，但子主题指定与32px相同的标题。在这种情况下，WordPress会将后一种样式应用于所有h1文本。但是，如果同一个子主题不包含h2、h3 和 h4 的特殊样式说明，则仍将应用父主题定义的样式。

如果您可以直接编辑主题，您可能想知道为什么子主题值得麻烦。使用子主题实际上有很多优点，因为它：

• 使您能够更新父主题。您应该始终保持网站的各个方面都是最新的。但是，如果您编辑了父主题，则更新后所有更改都将丢失。
• 可以轻松找到您所做的更改。发现您进行更改的每个实例可能很困难。使用子主题使您的添加内容更加清晰。
• 避免直接编辑父主题的风险。如果您在处理主题时出错，或者您对所做的修改不满意，您可以轻松回滚到原始主题。

WordPress子主题中的文件

每个WordPress子主题必须至少有两个文件：样式表和函数文件。样式表将在顶部包含注释掉的文本，告诉WordPress这是一个子主题以及父主题是什么。函数文件将包含一个函数，该函数将来自父主题的样式表排入队列。

注意：您可能会遇到一些指南，告诉您从子主题的样式表调用父主题样式表。这不再是正确的方法，您应该在函数文件中使用排队。我很快就会告诉你如何做到这一点。

你的子主题并不必须 包含的任何其他文件。与父主题不同，如果主题中没有更多特定文件，它不需要index.php文件作为后备。这是因为如果子主题中不存在模板文件，WordPress将使用父主题中的文件。

因此，根据您希望子主题执行的操作，您可以向样式表、函数文件中添加额外的代码，或者在子主题中创建额外的文件以覆盖父主题。这些可能包括以下一项或多项：

• 模板文件覆盖父主题中的相同文件，例如page.php当您要自定义静态页面的显示时。
• 当您想要自定义站点设计的这些部分时，模板部分例如header.php或footer.php。
• 您从子主题中的模板文件调用的额外模板部分。因此，如果您想在显示静态页面时自定义页眉，您可以在子主题中创建一个名为header-page.php的文件和一个名为page.php的模板文件，该文件将覆盖父主题中的page.php . 这个模板文件将与父主题中的模板文件相同，除了头文件的调用，它会调用header-page.php 而不是header.php。
• 用于功能的额外包含文件。如果您想添加大量函数代码并对其进行组织，您可以为每组函数创建包含文件，然后在您的子主题的functions.php文件中调用它们。因此，例如，如果您想添加额外的定制器选项，您可以在您的子主题中添加一个名为customr.php的包含文件，然后从您的子主题中的函数文件中调用该文件。

但是，如果您确实添加了额外的文件和功能，WordPress怎么知道该使用哪个呢？来自父主题的那些还是来自子主题的那些？这就是我们接下来要讲的。

WordPress如何选择模板文件

WordPress在您的站点上显示内容时从您的主题中选择模板文件的方式是参考模板层次结构。

WordPress模板层次结构

WordPress使用此层次结构来处理主题中的模板文件，并在显示给定类型的内容时找到要使用的正确模板文件。它将从顶部开始（在上图中的左侧）并依次查找给定内容类型的每个文件。当它找到将显示该内容的文件时，它将使用它。

假设您的主题有一个archive.php文件和一个category.php文件，但没有tag.php文件。显示类别档案时，WordPress将使用category.php，因为它更特定于内容类型。当显示标签档案时，它将使用archive.php代替。

如果WordPress没有为给定的内容类型找到模板文件，它会默认为包罗万象的index.php文件，这就是为什么每个独立主题（即不是子主题）都必须有一个index.php文件的原因.

这同样适用于单个文章和页面。假设您的主题有一个single.php文件，它是任何文章类型（包括页面和自定义帖子类型）的单个帖子的统称。它还有一个page.php文件。当显示单个页面时，它将使用page.php。显示文章时，它将使用singular.php。如果您注册自定义文章类型并且不为该帖子类型添加模板文件，它将再次使用singular.php。

当您使用子主题时，WordPress仍然使用模板层次结构来决定在您的站点上输出内容时使用哪个文件。它查看父主题和子主题中的文件并使用它遇到的第一个文件。

所以想象你的子主题有singular.php和post.php，你的父主题有page.php和index.php。输出单个文章时，WordPress将使用子主题中的post.php。输出页面时，它将使用父主题中的page.php。当输出自定义帖子类型的单个帖子时，它将使用来自子主题的single.php。

但是，如果您的子主题和父主题都有相同文件的实例怎么办？

假设您将page.php文件添加到上一个示例中的子主题。因为该主题位于子主题中，所以它会覆盖父主题中的相同文件。因此，当显示单个页面时，WordPress将使用来自子主题的新page.php文件。

这就是为什么创建子主题可以让您自定义父主题。如果您将父主题中的模板文件副本添加到子主题，然后对其进行编辑以包含您要进行的自定义，WordPress将使用这个新模板文件，而不是来自父主题的模板文件。这意味着您的自定义将在显示内容时使用，而无需您编辑父主题。好的！

WordPress如何从父主题和子主题运行函数

如果您不想对主题中的模板文件进行自定义，而是对功能进行自定义，该怎么办？

你也可以这样做。首先，您需要让自己满意，这样做的正确方法是通过子主题而不是插件。一个示例可能是您想要编辑父主题中已有的函数，例如，在页脚中输出版权页的函数。

然后将新函数添加到子主题中的函数文件，或添加到从函数文件调用的包含文件。

为确保您的新函数覆盖父主题的功能，您需要了解如何覆盖函数。有三种方法可以做到这一点：

• 通过在父主题中编写一个与可插入函数同名的新函数。
• 通过将父主题中的函数从它所附加的钩子中解开，然后编写一个新函数来替换它。
• 通过编写一个比原始函数具有更高优先级的新函数并通过相同的钩子调用它，这意味着它在原始函数之后被调用，因此可以覆盖或增加它。

我们将在本文稍后介绍您如何执行所有这些操作。但首先，让我们看一下您何时会使用和不会使用子主题的场景。

何时在WordPress中使用子主题（优点）

您现在知道什么是子主题以及如何使用它们来覆盖父主题中的模板文件或函数。

简要回顾一下，如果您在网站上运行主题并且想要执行以下一项或多项操作，则应使用子主题：

• 编辑一个或多个模板文件。
• 添加与显示而非功能相关的额外功能。
• 覆盖父主题中的一个或多个函数。
• 添加额外的模板文件。

一些优点包括：

• 易于扩展和定制：很明显，子主题扩展了其父主题的功能。您已经有一个父主题形式的现成模板，您需要做的就是为您的子主题创建一个单独的style.css文件，并根据您的需要添加自定义调整。
• 轻松更新：随着 WordPress 的发展，主题和插件需要经常更新。如果您对主要主题进行自定义调整和更改，如果您更新主题，最终可能会丢失所有更改。因此，建议对子主题进行此类更改，这样即使您需要更新父主题，也不必担心丢失更改。

当您不使用子主题时呢？

何时不使用WordPress子主题（缺点）

有时您不会使用子主题，而应该使用不同的方法来自定义您的网站。这些是：

• 如果您的主题是您自己开发的（或其他人为您编写的）并且不需要在其他任何地方使用它。只需编辑主题，确保使用版本控制。
• 如果您要进行的自定义具有功能性，例如添加自定义帖子类型，并且您希望在将来更改主题时保留它们。改用插件。

一些缺点包括：

• 选择理想的父主题：并非所有主题都可以作为好父主题！例如，某些WordPress主题可能不会定期更新，因此往往缺乏最新的功能。同样，并非所有WordPress主题都是在考虑子主题的情况下创建的，因此可能不适合父主题。您需要选择完美的父主题，以便正确扩展它并使其成为您子主题的基础。
• 定制工作：子主题基本上寻求扩展和定制现有模板设计。因此，如果您已经围绕父主题创建了一个网站，则在移动到子主题时，您可能需要重新考虑自定义元素，例如菜单、主题选项、侧边栏、标题等。

现在您知道何时（以及何时不）使用子主题，是时候开始工作并学习如何在WordPress中创建子主题了。

现在您知道为什么应该使用子主题，现在是创建一个的时候了。这个过程有点复杂，但我们将引导您完成每一步。

如何创建WordPress子主题

在创建子主题之前，您需要做一些准备工作。首先，在执行任何其他操作之前创建站点备份非常重要。这样，您就可以处理您的主题，而不必担心破坏您的网站或丢失其任何内容。事实上，最好使用临时站点来编辑和测试您的主题，而不是您的实时站点。

我们还建议您在开始之前熟悉CSS和PHP。虽然您不需要任何使用这些语言创建子主题的经验，但它肯定有助于编辑主题的过程。花时间了解这些关键语言的基础知识将使您有一个良好的开端。

在WordPress中设置一个基本的子主题涉及创建两个文件：样式表和函数文件。

Step 1：为您的子主题创建一个文件夹

您需要的第一件事是为您的孩子主题生活的地方。但是，在此之前，您需要一种直接处理站点文件的方法。这通常意味着使用像FileZilla这样的SFTP解决方案来访问您的站点。

一旦你安装和设置FileZilla中，您可以使用登录你的虚拟主机提供的凭据。完成后，您将看到整个站点组织成一系列文件夹和文件。从这里，您需要导航到/wp-content/themes/，这是所有主题所在的位置。

右键单击此文件夹内的任意位置，然后选择创建目录。此文件夹将保存您的子主题，因此我们建议您以其父主题命名。例如，一个二〇一七的子主题可能被称为twentyseventeen-child。

保存文件夹后，就可以开始向子主题添加内容了。

Step 2：创建样式表

层叠样式表 (CSS)是一种定义HTML内容外观的语言。主题的CSS文件控制您网站上的文本、图像、超链接和大多数其他内容的外观。当我们谈论更改主题的外观时，我们通常谈论的是编辑其CSS。

这听起来可能很复杂，而且CSS确实为您提供了很多自定义选项。但是，现在您无需担心具体细节。您需要做的就是创建CSS文件本身。您将在刚刚创建的子主题文件夹中执行此操作。只需打开文件夹，右键单击其中的任意位置，然后选择创建新文件。

当您被要求命名文件时，将其命名为style.css，注意使用确切的大小写和拼写（因为WordPress否则将无法识别该文件）。

该文件自然是空的，因此您需要为其提供一些内容。要开始编辑文件，请右键单击它并选择查看/编辑。这将在您的默认文本编辑程序中打开文件，例如TextEdit或记事本。

在创建文件之前，您需要创建一个文件夹来保存您的主题。这在WordPress安装的wp-content/themes文件中。

在新主题的文件夹中，创建一个名为style.css的文件。添加以下内容：

/*
Theme Name:  My Child Theme. Child for Twenty Nineteen.
Theme URI:  https://rachelmccollin.com
Description:  Theme to support tutsplus tutorial. Child theme for the Twenty Nineteen theme.
Author:  Rachel McCollin
Textdomain:  mccollin
Author URI:  https://rachelmccollin.com/
Template:  twentynineteen
Version:  1.0
License:  GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html                 
*/

这段文字被注释掉了。它不是在您的网站上运行任何东西或提供任何功能的代码。相反，它会告诉WordPress主题。每个主题中都需要这样的文本，否则WordPress无法将其识别为主题。

让我们通过每一行来确定它们的作用：

• Theme Name：主题的唯一名称。
• Theme URI：用户可以在其中找到主题的代码或文档。
• Description：帮助用户理解主题的描述性文字。
• Author：你的名字
• Textdomain：用于国际化。在任何国际化函数中使用文本域作为第二个参数。
• Author URI：作者的网站。
• Template：存储父主题的文件夹。使用文件夹名称而不是主题名称。没有这一行，您的主题将无法作为子主题使用。
• Version：版本号
• License：许可证，必须是GNU。[关联]
• License URI：许可证信息的链接。

子主题最重要的一行是Template: 行。没有这个，主题将不能作为子主题工作。只有子主题将包含此行。

将此添加到您主题的样式表中，对其进行编辑以添加您自己的详细信息而不是我的。您需要编辑Template: 行以添加存储现有主题的文件夹，因为这将是您的父主题。

现在保存文件。如果您现在查看站点中的主题详细信息屏幕，您会看到显示的所有内容：

WordPress中没有截图的主题页面

这看起来不太好，因为没有截屏。这是一张图像，可以让您了解主题的外观。除非您的主题看起来与父主题非常不同，否则只需将screenshot.png文件从您的父主题复制到您的子主题。

带有屏幕截图的WordPress中的主题页面

Step 3：引用父主题

到目前为止，您的主题已经有了一个主页和一些基本信息。现在，是时候给它一些功能了。您可以通过创建一个函数文件来做到这一点。除其他外，此文件决定了主题的独特功能。这是一个功能强大的工具，用途广泛，但现在，您只需要创建它。

下一步是将函数文件添加到您的子主题。您需要它，以便您可以将来自父主题的样式表排入队列。没有它，您的网站将根本没有样式，看起来像这样：

我们的主页没有CSS

不好，我相信你会同意的！因此，让我们添加样式以使其看起来应该如此。

在您的子主题文件夹中，添加一个名为functions.php的文件。打开它并添加以下代码：

<?php
/* enqueue script for parent theme stylesheeet */        
function childtheme_parent_styles() {
// enqueue style
wp_enqueue_style( 'parent', get_template_directory_uri().'/style.css' );                       
}
add_action( 'wp_enqueue_scripts', 'childtheme_parent_styles');

它使用wp_enqueue_style()函数将来自父主题的样式表排入队列，get_template_directory_uri()函数定位该文件的存储位置。该函数位于我创建的一个名为wbolt_parent_styles()的函数中，与wp_enqueue_scripts钩子挂钩。

您可能想知道为什么它使用名为wp_enqueue_scripts而不是的函数wp_enqueue_styles。这是因为wp_enqueue_scripts用于脚本和样式，并且没有像wp_enqueue_styles.

随意编辑我的代码，将您自己的前缀添加到您的函数名称中。我使用“childtheme”作为前缀，以确保我的函数不会与来自父主题或任何插件的任何其他函数发生冲突。

现在保存您的文件。

Step 4：启用子主题

您的子主题现在可以使用了，所以您需要做的就是启用它。最简单的方法是通过WordPress管理界面。只需登录，然后访问外观>主题。您应该已经在此处看到您的子主题：

此时，您只需要单击“启用”即可启用您的主题。当然，此时您可能不会注意到您的站点有任何差异。这是因为您实际上还没有添加任何自定义。子主题仍然是一张白纸，等着你把它变成特别的东西。

正如我们之前提到的，您现在应该花一些时间来了解有关CSS和PHP的更多信息。这将使您能够使用内置主题编辑器通过子主题向您的站点添加新样式和功能。如果你想扩展您的主题的功能，它也是一个聪明的想法，详细了解了functions.php的文件。只需稍加努力，您就可以使用全新的子主题对 WordPress 网站进行任何您想要的更改！

如何激活WordPress子主题

一旦您的子主题准备就绪，您就需要激活它。如果您担心激活子主题会关闭父主题，请不要担心：WordPress会知道使用父主题中的文件，除非您向子主题添加新文件来覆盖它们。到目前为止，您还没有向子主题添加任何额外的文件或功能，因此您的站点的工作方式与激活父主题时完全相同。

请记住：首先在您的开发或临时站点上执行此操作。在您测试之前，不要在您的实时站点上激活您的子主题。

在WordPress管理中，转到外观 > 主题。您会发现您的子主题列在您网站上安装的主题中。

将鼠标悬停在主题上，然后单击“激活” 按钮。这将激活您的子主题。现在，当您访问您的实时站点时，它看起来和以前一样：

网站首页

它看起来相同，因为您尚未添加任何自定义。但是你现在有一个工作子主题。做得好！

如何在WordPress中自定义子主题

现在您的WordPress网站有了一个可用的子主题，是时候添加您的自定义设置了。在这里，我将向您展示如何添加模板文件以覆盖父主题上的模板文件、如何为子主题添加样式以及如何添加新功能。

让我们从模板文件开始。

如何将模板文件添加到您的WordPress子主题

我们已经了解了WordPress在您的网站上显示内容时如何选择要使用的模板文件。有两件事要记住：

• WordPress将使用层次结构中最先出现的文件，无论是来自子主题还是父主题。
• 如果父主题和子主题中都存在同名的模板文件（或模板部分，例如header.php），WordPress将使用子主题中的一个。

要添加自定义，我发现首先从父主题制作相关文件的副本，将其添加到子主题，然后编辑它更容易。

这适用于您的子主题中的文件是否与父主题中的命名文件相同，或者它是用于显示不同内容类型的新文件，还是层次结构中更高的文件。

因此，如果我将新版本的page.php添加到我的子主题中，这将覆盖我父主题中的page.php，我会将page.php从我的父主题复制到我的子主题，然后对其进行编辑。确保复制文件：不要移动它，因为您不想对父主题进行任何更改。

例如，如果我想要在我的子主题中使用自定义页面模板，我会将page.php复制到我的子主题，重命名它，然后对其进行编辑。

这样，您可以确保不需要自定义的文件的所有方面仍然可以正常工作。这同样适用于模板部件。

如何为您的WordPress子主题添加样式

您还可以向子主题的style.css文件添加样式，这将增强或覆盖父主题样式表中的样式。

WordPress将首先从父主题调用样式表，然后从子主题调用样式表。这意味着如果您将样式添加到与父主题中的样式相同的元素的子主题，只要您使用相同的选择器，它就会覆盖父主题的样式。

因此，假设您想更改站点标题的颜色。在父主题中，这可能是这样的：

h1.site-title {
color: #000;
}

要在您的子主题中覆盖它，您可以添加以下内容：

h1.site-title {
color: #303030;
}

由于浏览器会在父主题中的样式之后遇到这个，它将覆盖它并被使用。

如何为WordPress子主题添加函数

因此，您在WordPress中创建了子主题并不是因为您想要编辑任何模板文件，而是因为您想要添加额外的功能或覆盖父主题中的一个或多个功能。

在子主题中编写函数比添加模板文件要复杂一些，但这是可能的。

如果您想添加一个不与父主题中的任何功能交互的新功能，您可以继续这样做。只需将该函数添加到子主题中的functions.php文件中，将其挂接到相关的操作或过滤器挂钩上，就可以了。

但是，如果您计划覆盖或编辑父主题中的函数，则需要了解可用于执行此操作的方法。您可以通过三种方式覆盖子主题中的父主题功能：

• 如果父主题中的主题是可插入的，您只需在子主题中编写另一个具有相同名称的函数，WordPress将运行该函数而不是父主题中的函数。
• 如果你想完全停止父主题中的函数运行，你可以在你的子主题中编写一个函数，将它从它所附加的钩子中解开。
• 如果您想扩充一个函数，您可以在您的子主题中添加另一个函数（具有不同的名称），并确保它在父主题中的函数之后运行。

让我们仔细看看你是如何做到的。

覆盖可插入函数

可插拔函数由环绕在它周围的条件检查标识。这将检查是否有另一个同名的函数已经被触发。如果是这样，它不会运行该功能。

WordPress将在来自父主题的函数之前触发来自您的子主题的函数。如果它在父主题中遇到一个可插拔函数，并且您已向子主题添加了一个同名的函数，则该可插拔函数将不会运行。

一个示例是在WooCommerce站点的Storefront主题中输出版权页的函数。这是没有内容的函数：

WordPress钩子（Hook）是WordPress开发人员的武器库中最重要的工具之一。它们是WordPress插件和主题开发的基础。您可以使用WordPress的许多内置钩子将自定义代码“连接到”WordPress核心，并执行或修改某些内容。

有两种类型的WordPress钩子：Actions和Filters。Hook非常普遍，甚至WordPress Core本身也广泛使用它们。WordPress还提供了一种让您定义自己的自定义钩子的方法，以便其他开发人员可以挂钩到您的代码中。

了解动作、过滤器和自定义钩子的工作原理对于掌握WordPress开发至关重要。

本文的前半部分介绍了WordPress钩子的基础知识，并解释了它们如何与多个示例一起工作。在后半部分，您将学习如何使用钩子来自定义WordPress，创建自己的自定义钩子，并使用它们来构建自己的可扩展插件。

1. 什么是WordPress钩子？
2. 钩子 vs 动作 vs 过滤器
3. WordPress钩子如何工作？
4. 在哪里注册钩子及其函数？
5. 使用WordPress钩子
6. WordPress钩子列表和资源
7. 查找在WordPress页面上注册的钩子
8. “所有”钩子
9. WordPress钩子存储在哪里？
10. 如何创建自定义WordPress钩子
11. 从WordPress钩子中删除回调函数
12. 更多WordPress钩子教程

什么是WordPress钩子？

一个WordPress的页面是由很多的功能和数据库查询组装。WordPress核心、插件和主题协同工作以输出页面元素，如文本、图像、脚本和样式。完全组装后，浏览器会将它们放在一起并呈现页面。

WordPress钩子允许您在某些点“钩入”这个构建过程并运行您的自定义代码。钩子的主要功能是让你在不接触核心文件的情况下修改或添加功能到WordPress 。

钩子将帮助您使用自己的代码扩展WordPress

在WordPress的插件API赋予WordPress钩子的功能。您可以通过在WordPress运行时在特定实例中调用某些称为Hook Functions的WordPress函数来使用钩子。

使用钩子函数，您可以将自定义代码捆绑在回调函数中，并将其注册到任何钩子中。注册后，此回调将在钩子所在的任何地方运行，允许您增加或替换默认的WordPress功能。

钩子在代码执行过程中的位置是一个重要的因素。您将在接下来的部分中详细了解其重要性。

两种类型的WordPress钩子：动作和过滤器

WordPress包括两种类型的钩子，称为Actions和Filters。动作允许您在WordPress运行时的某些预定义点执行某些操作，而过滤器允许您修改WordPress处理的任何数据并返回这些数据。

动作（Actions）在WordPress代码中定义为：

do_action( 'action_name', [optional_arguments] );

action_name字符串是动作的名称。您可以指定[optional_arguments]变量以将附加参数传递给回调函数。如果未指定此字段，则其默认值将为空。

示例：do_action( 'wp_head' )每次WordPress处理站点标题时，都可以挂接该动作以运行自定义代码。此动作没有任何其他参数。

过滤器（Filters）在WordPress代码中定义为：

apply_filters( 'filter_name', 'value_to_be_filtered', [optional_arguments] );

filter_name字符串是过滤器的名称，value_to_be_filtered变量是被过滤和返回需求，和值[optional_arguments]变量可以通过附加参数，就像动作。

例如：apply_filters( 'admin_footer_text' , string $text )过滤器可以是钩状来修改在管理页脚显示的文本。从WordPress 5.4开始，其默认值将 在管理区域页脚中显示该句子。Thank you for creating with WordPress.

稍后您将通过WordPress核心中的许多示例学习如何动作和过滤器钩子。

上钩后，您可以指导您的代码在您的网站上执行或自定义某些内容。例如，您可以使用钩子在发布文章后自动发送电子邮件，或加载自定义样式表来更改站点的外观。

WordPress钩子可帮助您与网站互动或修改您的网站

理解钩子的最简单方法是将您的WordPress网站想象成盖房子。

钩子类似于使用起重机来回移动建筑物品。正在传输的项目是回调函数，其中包括您的自定义代码。这些项目（或功能）可以帮助您建造或改造房屋。

在WordPress中“wp_head”动作钩子的示例

回调函数可以是常规PHP函数、默认WordPress函数或您定义的自定义函数。

我们只能在连接到特定挂钩的特定载体上运输某些物品。因此，动作只能与动作函数挂钩。同样，过滤器只能与过滤器函数挂钩。

虽然更换起重机上的吊钩和托架很乏味，但WordPress通过包含超过2,200种默认钩子使其变得非常容易。

WordPress 5.1有2200多个原生钩子（来源：Adam Brown）

您可以找到遍布WordPress核心的钩子，让您可以进入要钩子的确切位置并运行您的自定义代码。

钩子 vs 动作 vs 过滤器

根据WordPress插件手册：

钩子是一段代码交互/修改另一段代码的一种方式……钩子有两种类型：动作和过滤器。

术语Hook、Action和Filter的使用方式存在广泛的不一致。一些教程和指南将它们与与之相关的函数混合在一起。这种混淆存在的一个主要原因是钩子工作方式的复杂性。

即使您仔细查看WordPress核心内部，您也会发现添加动作和过滤器之间没有太大区别。下面是为ADD_ACTION()函数的源代码从wp-includes/plugin.php文件：

function add_action( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) {      
return add_filter( $tag, $function_to_add, $priority, $accepted_args );
}

add_action()函数只是调用该add_filter()函数并返回其值。为什么？因为它们从根本上以相同的方式工作，除了一个区别。

apply_filters()函数返回一个可以更改现有数据类型的值，而该do_action() 函数不返回任何内容（PHP中的NULL值）。

如果您仍然感到困惑，请不要担心！读完本文的前半部分后，一切就都清楚了。我们将坚持使用官方的WordPress Codex术语，因为它清晰、准确且通用。

现在，让自己熟悉下面显示的钩子例程。

钩子程序：钩子、钩子函数和回调函数

让我们分解一下Actions和Hooks之间的区别。

有时，您可以使用动作或过滤器来实现相同的目标。例如，如果您想修改文章中的文本，您可以使用publish_post动作注册一个回调函数，并在将文章内容保存到数据库时更改文章内容。

// define the callback function to change the text
function change_text_callback() { 
// add the code to change text here
}
// hook in to the 'publish_post' action with the add_action() function
add_action( 'publish_post', 'change_text_callback' );

或者您可以使用the_content过滤器注册另一个回调函数，以在浏览器中显示之前修改文章内容。

// define the callback function to modify the text
function change_text_another_callback( $content ) { 
// add the code to change text here and then return it 
return $filtered_content;
}
// hook in to 'the_content' filter with the add_filter() function
add_filter( 'the_content', 'change_text_another_callback');

两种不同的方法，结果相同。知道何时使用一个而不是另一个是成为优秀WordPress开发人员的关键。

WordPress钩子如何工作？

房子的例子很简单，可以理解钩子的基本功能，但它没有捕捉到它们如何工作的复杂性。最重要的是钩位置和特异性的概念。

一个更好的例子是将处理WordPress网页想象成组装汽车。与制造汽车需要时间不同，组装网页几乎是瞬间完成的。

组装网页就像组装汽车

就像汽车如何在现代装配线中逐个组装在一起一样，WordPress网页由服务器和客户端逐个组装。

WordPress核心就像汽车引擎、底盘和其他必需品，为网站的“核心”功能提供动力。

您可以仅使用WordPress核心就拥有一个功能强大的网站，但这有什么乐趣呢？您需要向站点添加令人兴奋的功能。这就是WordPress插件和主题介入的地方，它们都广泛使用钩子。

在上面的示例中，每个编号的站点就像WordPress核心中的一个钩子。有两种类型的站点，例如动作和过滤器。每个站都包含一个特定类型的插槽，它只接受某些工具，类似于动作函数和过滤器函数。

为了模块化和效率，所有站点都以频繁的间隔放置。

根据特定位置的要求，我们可以为该特定站点的工作安装（或钩子）最合适的工具。这些工具就像用于与WordPress交互或修改WordPress的回调函数。

一些工具可以显着改变汽车的工作，就像注册到动作的回调一样。其他工具仅用于自定义汽车的外观，例如注册到过滤器的回调。

在正确的站点使用正确的工具对于制造一流的汽车至关重要。同样，钩子帮助我们根据我们的独特需求定制WordPress。

如果你扩展这个类比，插件就像添加有用的汽车功能，如安全气囊、娱乐控制台、远程无钥匙系统等（像这些是为了增强WooCommerce的功能）。主题类似于自定义汽车的视觉部分，例如整体设计、喷漆、轮辋等（这是自定义WordPress主题的方法）。

在哪里注册钩子及其函数？

在WordPress中添加钩子有两种推荐的方法：

• 插件：制作您自己的插件并在其中添加所有自定义代码。
• 子主题：在子主题的functions.php文件中注册钩子和回调函数。

对于本教程，让我们从创建插件开始。为此，请在您的/wp-content/plugins/目录中创建一个新文件夹。

我给我的插件命名salhooks，但你可以随意命名它。根据 WordPress 指南，您需要在插件目录中创建一个具有相同名称 (salhooks.php )的PHP文件。

将以下标题字段添加到您的插件文件以将其注册到WordPress。您可以在WordPress Codex中了解有关插件标头要求的更多信息。

<?php
/*
Plugin Name:  Salhooks
Version    :  1.0
Description:  Demonstrating WordPress Hooks (Actions and Filters) with multiple examples.
Author     :  Salman Ravoof
Author URI :  https://www.salmanravoof.com/
License    :  GPLv2 or later
License URI:  https://www.gnu.org/licenses/gpl-2.0.html
Text Domain:  salhooks
*/
//=================================================
// Security: Abort if this file is called directly
//=================================================
if ( !defined('ABSPATH') ) { 
die;
}

保存此文件，然后在您的WordPress仪表盘中激活该插件。我将在本地WordPress安装中使用这个插件来演示钩子是如何工作的。

作为旁注，您还可以直接编辑WordPress核心文件以注册钩子。但是，不建议这样做，因为每次更新WordPress时，您的所有自定义代码都会被覆盖。出于同样的原因，您不应该在父主题中添加钩子。

使用WordPress钩子

一个WordPress钩子本身什么都不做。它只是坐在代码中，等待一些钩子函数来激活它。要使用钩子，您至少需要调用2个其他函数。

首先，您需要使用钩子函数注册钩子并在其中引用回调函数。然后你需要定义你之前在钩子函数中提到的回调函数。每次触发钩子时，WordPress都会运行此回调函数。

定义这些函数的顺序无关紧要，但最好将它们放在一起。

动作和过滤器具有不同的钩子函数。从现在开始，让我们将它们称为Action Functions和Filter Functions。正如您将看到的，它们有自己的语法和参数要求。

1. 钩住一个动作
2. 钩住过滤器
3. 使用Hooks自定义WordPress登录页面

钩住一个动作

动作提供了一种在WordPress 核心、插件或主题执行中的特定点运行自定义代码的方法。

add_action() 动作函数

您可以按照以下步骤使用动作注册回调函数：

1. 定义一个带有自定义代码的回调函数。当WordPress的代码执行期间触发它注册到的任何动作时，此回调函数将运行。
2. 使用该add_action()函数将您的回调函数连接到您想要的动作。根据WordPress Codex，add_action()函数至少需要传递两个参数：
   • • 要挂钩的动作的名称。
     • 触发动作时将运行的回调函数的名称。
3. add_action()函数还接受两个可选参数来设置priority和number of arguments。我们稍后会讨论它们。

最好将回调函数参数命名为尽可能接近钩子函数传递的参数。

让我们看一个使用该add_action()函数的例子。