php - Wordpress WooCommerce Storefront Theme - 功能在哪里定义？

Question

我是 WooCommerce 和 Storefront 主题的新手。在开始修改源代码之前，我试图了解它。我只是很难找到所有必要代码的位置。

当我打开 header.php 时，我迷路了，因为每个函数都像这样挂接到其他一些文件。

do_action( 'storefront_before_header' );

Storefront 主题中的这些功能在哪里定义？以及除了打开所有正在搜索字符串的文件之外，我如何才能找到在未来定义所有这些 do_action 函数的位置？

我查看过以下文件:

• storefront-functions.php
• storefront-template-functions.php
• storefront-template-hooks.php
• 函数.php

Answer 1

对于所有与 woocommerce 相关的产品，在每个 Hook 之前的 phpdoc block 中都有一个 @hooked 标记。如果没有@hooked标签，这个钩子(Hook)就是一个保留的钩子(Hook)，以后可能会用到。

让我们看看 storefront_header hook :

/**
 * Functions hooked into storefront_header action
 *
 * @hooked storefront_skip_links                       - 0
 * @hooked storefront_social_icons                     - 10
 * @hooked storefront_site_branding                    - 20
 * @hooked storefront_secondary_navigation             - 30
 * @hooked storefront_product_search                   - 40
 * @hooked storefront_primary_navigation_wrapper       - 42
 * @hooked storefront_primary_navigation               - 50
 * @hooked storefront_header_cart                      - 60
 * @hooked storefront_primary_navigation_wrapper_close - 68
 */
do_action( 'storefront_header' );

在@hooked 标签之后是一个函数名和优先级，当 Action 被触发时，该函数被执行。较低的数字对应较早的执行。

Hook 的大部分函数都位于 storefront-template-functions.php 内，并添加到 storefront-template-hooks.php 内。

您可以在主题文件夹中通过简单的 IDE 搜索找到这些功能。