add_theme_support()

WordPress函数add_theme_support()使主题或者插件来支持WordPress一些特性。如果在wordpress主题中使用,则应该在functions.php文件中调用。如果在wordpress插件中使用,就将其与某个hook关联,在after_setup_themeinit的hook最合适。

函数原型

参数详解

  1. $feature,需添加支持的特性的名字。
    1. 'post-formats'
    2. 'post-thumbnails'
    3. 'custom-background'
    4. 'custom-header'
    5. 'automatic-feed-links'
    6. 'html5'
    7. 'title-tag'
    8. 'editor-style'
    9. 'widgets'
    10. 'menus'
  2. $arguments,可选参数,默认为true。

参数feature的后三种情况,'editor-style''widgets''menus',在内部注册,不在主题中直接使用。

返回值

如果失败则返回false,其他情况无返回值void

应用实例

Post Formats

该参数使主题支持特定的post-formats类型。如添加'aside'、'gallery'两种类型。

Post Thumbnails

该参数使主题支持文章缩略图(Post Thumbnails),第二个参数为支持Thumbnails的文章类型。。

要在index.php或者single.php或者自定义模板中显示Thumbnails,则使用如下函数:

在显示Thumbnail之前,可以使用如下方式检查文章是否存在Thumbnail:

Custom Background

该参数使主题支持自定义背景。如:

Custom Header

该参数使主题支持自定义头部。如:

Feed Links

该参数使主题在头部支持对文章及评论的Feed链接,如:

HTML5

该参数使主题允许主题使用HTML5标签,针对搜索表单、评论表单、评论列表、相册和标题(caption)。如:

Title Tag

该参数允许插件和主题来管理document title tag。

总结

注意参数'editor-style''widgets''menus'都是只读的,可以使用函数current_theme_supports()进行检测。

飞鱼

发表评论

电子邮件地址不会被公开。 必填项已用*标注