在WordPress主题开发中,add_theme_support()
函数用于启用主题支持的各种功能。以下是一些常用的功能以及如何使用add_theme_support()
来启用它们:
-
标题标签 - 启用内置标题标签支持。
add_theme_support( 'title-tag' );
-
自定义背景 - 允许用户自定义背景。
add_theme_support( 'custom-background', $args );
其中
$args
是一个关联数组,可以包含自定义背景的设置。 -
自定义头部 - 允许用户上传自定义logo。
add_theme_support( 'custom-header', $args );
同样,
$args
是一个关联数组,用于定义自定义头部的设置。 -
特色图片 - 允许文章和页面设置特色图片。
add_theme_support( 'post-thumbnails' );
-
HTML5 - 启用HTML5标记支持。
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
你可以在数组中指定你想要支持的HTML5元素。
-
自动feed链接 - 自动添加feed链接到
<head>
。add_theme_support( 'automatic-feed-links' );
-
自定义日志类型 - 启用对自定义日志类型的支持。
add_theme_support( 'post-formats', array( 'aside', 'gallery', 'link', 'image', 'quote', 'status', 'video', 'audio', 'chat' ) );
在数组中指定你想要支持的日志格式。
-
菜单 - 启用自定义菜单支持。
register_nav_menus( array( 'primary' => __( 'Primary Menu', 'text_domain' ), 'footer' => __( 'Footer Menu', 'text_domain' ), ) );
注意,尽管这是使用
register_nav_menus()
而不是add_theme_support()
,但它与主题支持功能相关。
以下是一个示例,展示了如何在主题的functions.php
文件中使用add_theme_support()
来启用上述功能:
function my_theme_setup() {
add_theme_support( 'title-tag' );
add_theme_support( 'custom-background', array(
'default-color' => '',
'default-image' => '',
'default-repeat' => '',
'default-position-x' => '',
'default-attachment' => '',
'wp-head-callback' => '_custom_background_cb',
'admin-head-callback' => '',
'admin-preview-callback' => ''
) );
add_theme_support( 'custom-header', array(
// 自定义头部设置
) );
add_theme_support( 'post-thumbnails' );
add_theme_support( 'html5', array(
'comment-list',
'comment-form',
'search-form',
'gallery',
'caption'
) );
add_theme_support( 'automatic-feed-links' );
add_theme_support( 'post-formats', array(
'aside',
'gallery',
'link',
'image',
'quote',
'status',
'video',
'audio',
'chat'
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
确保在functions.php
文件中添加这些代码,这样当你激活主题时,WordPress就会识别并启用这些功能。