add_theme_support( string $feature, mixed $args )

使用示例

• 示例1

  /**
   * Essential theme supports
   * */
  function theme_setup(){
      /** automatic feed link*/
      add_theme_support( 'automatic-feed-links' );
  
      /** tag-title **/
      add_theme_support( 'title-tag' );
  
      /** post formats */
      $post_formats = array('aside','image','gallery','video','audio','link','quote','status');
      add_theme_support( 'post-formats', $post_formats);
  
      /** post thumbnail **/
      add_theme_support( 'post-thumbnails' );
  
      /** HTML5 support **/
      add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
  
      /** refresh widgest **/
      add_theme_support( 'customize-selective-refresh-widgets' );
  
      /** custom background **/
      $bg_defaults = array(
          'default-image'          => '',
          'default-preset'         => 'default',
          'default-size'           => 'cover',
          'default-repeat'         => 'no-repeat',
          'default-attachment'     => 'scroll',
      );
      add_theme_support( 'custom-background', $bg_defaults );
  
      /** custom header **/
      $header_defaults = array(
          'default-image'          => '',
          'width'                  => 300,
          'height'                 => 60,
          'flex-height'            => true,
          'flex-width'             => true,
          'default-text-color'     => '',
          'header-text'            => true,
          'uploads'                => true,
      );
      add_theme_support( 'custom-header', $header_defaults );
  
      /** custom log **/
      add_theme_support( 'custom-logo', array(
          'height'      => 60,
          'width'       => 400,
          'flex-height' => true,
          'flex-width'  => true,
          'header-text' => array( 'site-title', 'site-description' ),
      ) );
  
  
  
  }
  add_action('after_setup_theme','theme_setup');
  

• 示例2

  启用区块编辑器的“完全对齐”和“宽对齐”选项的主题支持，请使用
  add_theme_support( 'align-wide' );

• 示例3

  在WP 5.3中，add_theme_support('html5', ['script', 'style']);删除引入脚本和样式的type="text/javascript"和type="text/css"。

  参见https://make.wordpress.org/core/2019/10/15/miscellaneous-developer-focused-changes-in-5-3/–HTML5支持脚本和样式标记的参数

• 示例4

  从5.9版起，区块主题中默认启用以下功能：

  post-thumbnails
responsive-embeds
editor-styles
html5
automatic-feed-links
  

  见#35593（source）

• 示例5

  要确定主题支持是否存在（并检索其参数），请使用get_theme_support( $feature )

• 示例6

  注意，您必须单独调用其中的每一个，组成数组调用也不行
  add_theme_support( array( 'editor-styles', 'align-wide' ) )

  您必须单独调用：

  add_theme_support( 'editor-styles' );
  add_theme_support( 'align-wide' );

• 示例7

  声明支持导航小工具标记。

  add_theme_support( 'html5', array( 'navigation-widgets' ) );

  “我们强烈鼓励主题开发者在他们的主题中利用这一改进。这一新的主题支持功能是一种简单的方法，可以改善使用主题的所有网站的语义和可访问性。”

• 示例8

  初始内容#

  定义并注册初始内容，以在新网站上展示主题。

  add_theme_support( 'starter-content', array(
      // Place widgets in the desired locations (such as sidebar or footer).
      // Example widgets: archives, calendar, categories, meta, recent-comments, recent-posts, 
      //                  search, text_business_info, text_about
      'widgets'     => array( 'sidebar-1' => array( 'search', 'categories', 'meta'), ),
      // Specify pages to create, and optionally add custom thumbnails to them.
      // Note: For thumbnails, use attachment symbolic references in {{double-curly-braces}}.
      // Post options: post_type, post_title, post_excerpt, post_name (slug), post_content, 
      //               menu_order, comment_status, thumbnail (featured image ID), and template
      'posts'       => array( 'home', 'about', 'blog' => array( 'thumbnail' => '{{image-cafe}}' ), ),
      // Create custom image attachments used as post thumbnails for pages.
      // Note: You can reference these attachment IDs in the posts section above. Example: {{image-cafe}}
      'attachments' => array( 'image-cafe' => array( 'post_title' => 'Cafe', 'file' => 'assets/images/cafe.jpg' ), ),
      // Assign options defaults, such as front page settings.
      // The 'show_on_front' value can be 'page' to show a specified page, or 'posts' to show your latest posts.
      // Note: Use page ID symbolic references from the posts section above wrapped in {{double-curly-braces}}.
      'options'     => array( 'show_on_front'  => 'page', 'page_on_front' => '{{home}}', 'page_for_posts' => '{{blog}}', ),
  	// Set the theme mods.
      'theme_mods'  => array( 'panel_1' => '{{about}}' ),
  	// Set up nav menus.
      'nav_menus'   => array( 'top' => array( 'name' => 'Top Menu', 'items' => array( 'link_home', 'page_about', 'page_blog' )), ),
  ) );
  

  有关每个选项的完整示例，您可以参考Twenty Seventeen主题的functions.php：

• 示例9

  自定义背景的“default-color”不起作用

  解决方案是定义自己的样式表类，并将CSS类添加到body标记中。

• 示例10

  声明对区块样式的支持。

  add_theme_support( 'wp-block-styles' );

  这些将支持主题中的默认古腾堡区块样式。

• 示例11

  停用新的区块编辑器小工具并激活旧编辑器小工具

  remove_theme_support( 'widgets-block-editor' );