当前浏览:首页 / WordPress函数 / add_post_type_support()

add_post_type_support( string $post_type, string|array $feature, mixed $args )

注册文章类型的某些功能的支持

addmore...

post_type 文章类型more...

support 支持


描述

所有核心功能都与编辑界面的功能区域直接相关,例如编辑器或元框(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开始引入

使用示例

  • 示例1

    有关所有可能功能(例如“title”、“editor”等)的概述,请参阅post_type_supports的文档。

  • 示例2

    不幸地

    add_post_type_support('page', 'thumbnail');

    不会将特色图像添加到页面。为此,您需要[为文章缩略图添加主题支持

    add_theme_support( 'post-thumbnails', array( 'post', 'page' ) );

  • 示例3

    本例添加了对页面中摘录的支持(假设“屏幕选项”下*未*显示):

    <?php
    add_action('init', 'wpdocs_custom_init');
    
    /**
     * Add excerpt support to pages
     */
    function wpdocs_custom_init() {
    	add_post_type_support( 'page', 'excerpt' );
    }
    ?>