详解 WordPress `add_theme_support()` 函数源码：如何通过全局变量启用主题功能。

喔嚯！各位观众老爷们，今天咱们聊点WordPress主题开发里的硬核东西：add_theme_support() 函数，看看它咋呼风唤雨，操控主题功能的开关。准备好了吗？咱们开整！

一、啥是 add_theme_support()？ 别跟我说官方文档！

咱们先别急着啃官方文档那堆晦涩难懂的术语。简单粗暴地说，add_theme_support() 就是个开关总闸，用来开启或关闭WordPress主题的某些特定功能。这些功能，官方有个好听的名字，叫"主题功能"（Theme Features）。

想想你家里的电器，电视、冰箱、空调，都有开关。 add_theme_support() 就相当于你家电总闸，决定哪些电器能用，哪些不能用。 比如，你想让你的主题支持特色图像（又名文章缩略图），你就得用 add_theme_support( 'post-thumbnails' ); 开启这个功能。

二、add_theme_support() 语法解剖： 不懂语法，寸步难行！

add_theme_support() 函数的基本语法很简单：

add_theme_support( string $feature, mixed $args = true );

• $feature (string, required)： 这是个字符串，指定你要开启的主题功能的名字。 比如 'post-thumbnails'、'title-tag'、'custom-logo' 等等。 WordPress 内置了很多主题功能，你也可以自定义。

• $args (mixed, optional)： 这是一个可选参数，用来传递一些额外的配置信息给 $feature 指定的功能。 不同的功能，接收的参数类型和含义也不同。 比如，'post-thumbnails' 功能可以传递允许哪些文章类型支持特色图像。 如果省略 $args，大多数情况下，默认值是 true，表示启用该功能，使用默认配置。

三、add_theme_support() 的原理： 全局变量的秘密！

add_theme_support() 函数背后的原理，其实挺简单的，就是修改一些全局变量。 WordPress 用全局变量来记录主题是否支持某个功能。 当你调用 add_theme_support() 时，它会修改相应的全局变量，告诉 WordPress： "嘿，这个主题支持这个功能啦！"

具体来说，add_theme_support() 函数会修改 $GLOBALS['wp_theme_features'] 这个全局数组。 这个数组的键就是 $feature 参数的值，而值则是由 $args 参数传递的配置信息。

咱们来看个例子：

add_theme_support( 'post-thumbnails', array( 'post', 'page' ) );

这行代码会把以下信息添加到 $GLOBALS['wp_theme_features'] 数组中：

$GLOBALS['wp_theme_features']['post-thumbnails'] = array( 'post', 'page' );

这样，WordPress 就能知道你的主题支持特色图像，并且只允许文章（post）和页面（page）使用特色图像。

四、add_theme_support() 的最佳实践： 姿势很重要！

• 放在 functions.php 文件里： add_theme_support() 函数通常放在主题的 functions.php 文件里。 这是主题的核心配置文件，用来定义主题的功能和行为。

• 放在 after_setup_theme 钩子里： 为了确保 WordPress 完成初始化，并且主题已经加载，最好把 add_theme_support() 函数放在 after_setup_theme 钩子里执行。

  function my_theme_setup() {
      add_theme_support( 'post-thumbnails' );
      add_theme_support( 'title-tag' );
      add_theme_support( 'custom-logo', array(
          'height'      => 100,
          'width'       => 200,
          'flex-width'  => true,
          'flex-height' => true,
      ) );
  }
  add_action( 'after_setup_theme', 'my_theme_setup' );

  这样可以保证在主题加载完成后，这些功能才会被启用。

• 检查功能是否已经启用： 在某些情况下，你可能需要在启用某个功能之前，先检查它是否已经启用。 你可以使用 current_theme_supports() 函数来检查。

  if ( ! current_theme_supports( 'post-thumbnails' ) ) {
      add_theme_support( 'post-thumbnails' );
  }

  这可以避免重复启用同一个功能，导致冲突或者错误。

五、常见的主题功能： 盘点一下家底！

WordPress 内置了很多主题功能，咱们来盘点一下：

功能名称	描述	$args 参数
'post-thumbnails'	启用文章缩略图（特色图像）功能。	可以传递一个数组，指定哪些文章类型支持特色图像。 比如 array( 'post', 'page' )。 如果省略 $args，则所有文章类型都支持。
'title-tag'	让 WordPress 自动管理文档的 <title> 标签。	无。
'custom-logo'	启用自定义 Logo 功能，允许用户在后台上传主题 Logo。	可以传递一个数组，配置 Logo 的尺寸和是否允许灵活调整尺寸。 比如：array( 'height' => 100, 'width' => 200, 'flex-width' => true, 'flex-height' => true )。
'custom-background'	启用自定义背景功能，允许用户在后台设置主题背景颜色或图片。	可以传递一个数组，配置背景的默认颜色、默认图片等等。 具体参数请参考官方文档。
'custom-header'	启用自定义头部功能，允许用户在后台上传主题头部图片。	可以传递一个数组，配置头部的尺寸、文本颜色、是否随机显示等等。 具体参数请参考官方文档。
'automatic-feed-links'	自动在页面头部插入 RSS feed 链接。	无。
'html5'	启用 HTML5 支持，让 WordPress 使用 HTML5 标签。 可以传递一个数组，指定要支持的 HTML5 特性，比如 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption'。 如果省略 $args，则默认支持所有特性。	可以传递一个数组，指定要支持的 HTML5 特性。 比如 array( 'search-form', 'comment-form' )。
'post-formats'	启用文章形式（Post Formats）功能，允许用户为文章选择不同的形式，比如 'aside', 'gallery', 'link', 'quote', 'status', 'video', 'audio', 'chat'。	可以传递一个数组，指定要支持的文章形式。 比如 array( 'aside', 'gallery', 'video' )。
'menus'	启用菜单功能，允许用户在后台创建和管理导航菜单。	无。 要注册菜单位置，需要使用 register_nav_menus() 函数。
'widgets'	启用小工具功能，允许用户在后台添加和管理小工具。	无。 要注册小工具区域，需要使用 register_sidebar() 函数。
'editor-style'	允许主题自定义编辑器样式，让用户在后台编辑文章时，看到和前台一样的样式。	无。 需要在主题目录下创建一个 editor-style.css 文件，并使用 add_editor_style() 函数加载该文件。
'woocommerce'	启用 WooCommerce 支持，让主题可以更好地兼容 WooCommerce 插件。	无。
'wp-block-styles'	允许主题自定义 WordPress 区块编辑器（Gutenberg）的样式。	无。
'responsive-embeds'	自动将嵌入的视频和音频内容调整为响应式，使其适应不同的屏幕尺寸。	无。

六、自定义主题功能： 高级玩家的玩法！

除了 WordPress 内置的主题功能，你还可以自定义主题功能。 这需要你手动修改 $GLOBALS['wp_theme_features'] 数组，并编写相应的代码来处理这些自定义功能。

咱们来看个例子： 假设你想自定义一个 'my-custom-feature' 功能，允许用户在后台设置一些自定义选项。

1. 在 functions.php 文件里，添加以下代码：

   function my_theme_setup() {
       // 添加自定义主题功能
       add_theme_support( 'my-custom-feature', array(
           'option1' => 'default value 1',
           'option2' => 'default value 2',
       ) );
   }
   add_action( 'after_setup_theme', 'my_theme_setup' );

   这会将以下信息添加到 $GLOBALS['wp_theme_features'] 数组中：

   $GLOBALS['wp_theme_features']['my-custom-feature'] = array(
       'option1' => 'default value 1',
       'option2' => 'default value 2',
   );

2. 编写代码来读取和使用这些自定义选项：

   function my_get_custom_feature_option( $option_name ) {
       global $wp_theme_features;
   
       if ( isset( $wp_theme_features['my-custom-feature'] ) && isset( $wp_theme_features['my-custom-feature'][ $option_name ] ) ) {
           return $wp_theme_features['my-custom-feature'][ $option_name ];
       }
   
       return null; // 或者返回一个默认值
   }
   
   // 使用自定义选项
   $option1_value = my_get_custom_feature_option( 'option1' );
   echo 'Option 1 value: ' . $option1_value;

3. 创建一个后台设置页面，允许用户修改这些自定义选项。 这需要使用 WordPress 的设置 API。 这部分内容比较复杂，咱们就不在这里详细展开了。

七、add_theme_support() 的注意事项： 小心驶得万年船！

• 不要在主题激活之前调用 add_theme_support()： add_theme_support() 函数只能在主题激活之后调用。 如果在主题激活之前调用，可能会导致错误。

• 不要在插件里调用 add_theme_support()： add_theme_support() 函数应该只在主题里调用，而不是在插件里调用。 插件应该使用其他方式来修改主题的功能，比如使用钩子（filters）或者选项（options）。

• 小心覆盖父主题的功能： 如果你的主题是子主题，并且父主题已经启用了某个功能，那么你在子主题里再次启用该功能，可能会覆盖父主题的设置。 因此，在子主题里启用功能之前，最好先检查父主题是否已经启用了该功能。

八、总结： add_theme_support()，你值得拥有！

add_theme_support() 函数是 WordPress 主题开发中一个非常重要的工具。 它可以让你轻松地开启或关闭主题的各种功能，并且可以通过全局变量来传递配置信息。 掌握了 add_theme_support() 函数，你就可以更加灵活地控制主题的行为，并且创建出更加强大的主题。

好了，今天的讲座就到这里了。 希望大家能够对 add_theme_support() 函数有一个更深入的了解。 记住，编程就是不断学习和实践的过程。 多写代码，多踩坑，你才能成为真正的编程高手！ 下次再见！