在WordPress中,add_theme_support()
函数是用来启用WordPress主题支持的特定功能的。以下是如何使用add_theme_support()
来启用不同的功能的一些示例:
-
标题标签(Title Tag)支持
WordPress 4.1引入了标题标签支持,允许WordPress管理文档标题,而不是在主题中使用<title>
标签。add_theme_support( 'title-tag' );
-
自定义背景
启用自定义背景功能,允许用户在后台自定义主题的背景。add_theme_support( 'custom-background', $args );
其中
$args
是一个关联数组,可以包含自定义背景的设置。 -
自定义头部(Logo)
启用自定义头部功能,允许用户上传自己的logo。add_theme_support( 'custom-header', $args );
同样,
$args
是一个关联数组,用于定义自定义头部的设置。 -
文章格式
启用不同的文章格式,如标准、视频、音频等。add_theme_support( 'post-formats', array( 'aside', 'gallery', 'link', 'image', 'quote', 'status', 'video', 'audio', 'chat' ) );
-
HTML5
启用HTML5标记支持,特别是对于评论表单、评论列表、搜索表单和gallery。add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
-
自动Feed链接
启用自动Feed链接,使得WordPress自动添加RSS feed链接到页面的<head>
区域。add_theme_support( 'automatic-feed-links' );
-
自定义日志类型
如果你的主题支持自定义日志类型,比如作品集,你可以这样启用:add_theme_support( 'post-thumbnails' ); // 启用特色图像 add_theme_support( 'custom-post-type', array( 'portfolio' ) );
-
响应式嵌入内容
启用响应式嵌入内容,比如视频和iframe。add_theme_support( 'responsive-embeds' );
-
自定义颜色
允许用户在后台自定义主题的颜色。add_theme_support( 'custom-colors' );
-
自定义字体大小
允许用户在后台自定义字体大小。add_theme_support( 'custom-line-height' ); add_theme_support( 'custom-font-size' );
要在你的主题中启用这些功能,你需要在主题的functions.php
文件中添加相应的add_theme_support()
调用。例如,以下代码启用了一些常见功能:
function mytheme_setup() {
add_theme_support( 'title-tag' );
add_theme_support( 'post-thumbnails' );
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
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_action( 'after_setup_theme', 'mytheme_setup' );
确保在after_setup_theme
钩子之后调用mytheme_setup
函数,这样WordPress就能在正确的时间执行这些功能。