描述
所有核心功能都与编辑界面的功能区域直接相关,例如编辑器或元框(meta box)。功能包括:“title” 标题、“editor” 编辑器、“comments” 评论、“revisions” 修订、“trackbacks” 引用、“author” 作者、“excerpt” 摘录、“page-attributes” 页面属性、“thumbnail” 缩略图、“custom-fields” 自定义字段和“post-formats” 文章格式。
此外,“revisions”功能决定文章类型是否存储修订版,“comments”功能决定评论计数是否显示在编辑界面上。
第三个可选参数也可以与功能一起传递,以提供有关支持该功能的附加信息。
示例用法:
add_post_type_support( 'my_post_type', 'comments' ); add_post_type_support( 'my_post_type', array( 'author', 'excerpt', ) ); add_post_type_support( 'my_post_type', 'my_feature', array( 'field' => 'value', ) );
参数
- $post_type
-
(string) (必填) 要为其添加功能的文章类型。
- $feature
-
(string|array) (必填) 要添加的功能,接受功能字符串数组或单个字符串。
- $args
-
(mixed) (可选) 与某些功能一起传递的额外参数。
说明
应该使用 init 动作钩子调用该函数。
多站点
要在多站点安装中显示“特色图像”元框,请确保在网络管理Network Admin Settings SubPanel#Upload_Settings的媒体上载按钮选项中更新允许的上载文件类型。默认设置为关闭。
源码
更新日志
版本 | 描述 |
---|---|
5.3.0 | 通过将现有和已记录的...$args 参数添加到函数签名中,将其形参化 |
3.0.0 | 开始引入 |
使用示例
有关所有可能功能(例如“title”、“editor”等)的概述,请参阅post_type_supports的文档。
不幸地
add_post_type_support('page', 'thumbnail');
不会将特色图像添加到页面。为此,您需要[为文章缩略图添加主题支持
add_theme_support( 'post-thumbnails', array( 'post', 'page' ) );
本例添加了对页面中摘录的支持(假设“屏幕选项”下*未*显示):
<?php add_action('init', 'wpdocs_custom_init'); /** * Add excerpt support to pages */ function wpdocs_custom_init() { add_post_type_support( 'page', 'excerpt' ); } ?>