WordPress 自定义文章类型(Post Type)终极指南

您所在的位置:网站首页 自定义页类型的是 WordPress 自定义文章类型(Post Type)终极指南

WordPress 自定义文章类型(Post Type)终极指南

2024-07-04 08:11| 来源: 网络整理| 查看: 265

什么是 Post Type ?

WordPress 里面内置了两种常用的 Post Type :Post(文章)、Page(页面),分别用来展示两种类型的内容,一种是相对动态的文章,另一种是相对固定的页面。

除此之外,WordPress 还内置了其他几种 Post Type 用来展示不同类型的内容。但如果是一个比较复杂的网站或者需求自定义程度比较高,这时候就可以手动自己创建一个 Post Type 来展示某类信息。

比如大型杂志网站,可以为杂志类型创建个不同的 Post Type 来进行管理;大型企业网站,可以为产品类型创建个不同的 Post Type 来展示。

本教程以创建一个 Movies Post Type 为例,介绍一系列与 Post Type 有关的事情。创建之后,我们可以新建 Movie 介绍,每一篇 Movie 可以自己添加 导演 等信息,还可以创建单独的电影列表等。

使用的主题是官方的 twentyfourteen,建议边看边在本地服务器修改测试。

创建一个 post type

创建一个新的 Post Type 需要使用 register_post_type 函数来注册一下。需要在你主题的 functions.php 文件下调用该函数:

register_post_type( $post_type, $args );

$post_type 参数就是你自定义 Post Type 的名称,Post Type 可以自定义的功能非常多,所以这个函数里面的 $args 参数会很多。所以通常会用下面这种格式来注册:

function my_custom_post_product() { $args = array(); register_post_type( 'product', $args ); } add_action( 'init', 'my_custom_post_product' );

包裹在一个函数中,定义一个数组,然后挂靠到 init 这个 action 上。这样 WordPress 在初始化的时候,就会执行这个函数注册一个自定义 Post Type,因为调用 register_post_type() 的时候,必须要在 admin_menu action 之前,在 after_setup_theme action 之后,所以这里最好挂靠到 init action 上。

参数很多,为了写教程方便,只列出比较常用的参数,大体结构如下:

function my_custom_post_movie() { $labels = array( 'name' => _x( 'Movies', 'post type 名称' ), 'singular_name' => _x( 'Movie', 'post type 单个 item 时的名称,因为英文有复数' ), 'add_new' => _x( '新建电影', '添加新内容的链接名称' ), 'add_new_item' => __( '新建一个电影' ), 'edit_item' => __( '编辑电影' ), 'new_item' => __( '新电影' ), 'all_items' => __( '所有电影' ), 'view_item' => __( '查看电影' ), 'search_items' => __( '搜索电影' ), 'not_found' => __( '没有找到有关电影' ), 'not_found_in_trash' => __( '回收站里面没有相关电影' ), 'parent_item_colon' => '', 'menu_name' => 'Movies' ); $args = array( 'labels' => $labels, 'description' => '我们网站的电影信息', 'public' => true, 'menu_position' => 5, 'supports' => array( 'title', 'editor', 'thumbnail', 'excerpt', 'comments' ), 'has_archive' => true ); register_post_type( 'movie', $args ); } add_action( 'init', 'my_custom_post_movie' );

这里为了直观方便,我直接使用了中文,更好的应该是使用英文然后通过本地化函数来翻译成中文。

参数有点多,也可以使用 generatewp 工具自定义参数,然后改改,会稍微方便一点。

从上面代码可以看到 $args 数组里面有一个 labels 配置项,用来配置显示文案有关的内容,为了清晰所以单独拿出来创建了一个数组。其他配置项看下英文也能猜出大体意思,如果想要详细了解,可以看下官方文档:register_post_type 。

将上面代码加到主题 functions.php 的最下面,进入后台你会发现多出了 Movies 选项,这样表示注册成功:

自定义类型

这时候我们可以新建 Movie 发表一篇电影类型的文章了。但是这样与文章类型基本相同,我们需要更多的自定义来完善我们的 Movie 类型。

为 Post Type 添加分类功能

就电影来说,可以分为科幻、动作、战争等类别,那么我们就为自定义的 Movie 添加分类功能,这样就可以编辑新分类以及归类我们的电影了。这个分类跟文章里面的分类性质是一样的。

添加分类功能需要使用函数 register_taxonomy,使用方法也很简单,跟注册 Post Type 函数类似,只不过多了一个参数用来指定对应的 Post Type :

register_taxonomy( $taxonomy, $object_type, $args );

就本例而言,可以配置如下常用参数:

function my_taxonomies_movie() { $labels = array( 'name' => _x( '电影分类', 'taxonomy 名称' ), 'singular_name' => _x( '电影分类', 'taxonomy 单数名称' ), 'search_items' => __( '搜索电影分类' ), 'all_items' => __( '所有电影分类' ), 'parent_item' => __( '该电影分类的上级分类' ), 'parent_item_colon' => __( '该电影分类的上级分类:' ), 'edit_item' => __( '编辑电影分类' ), 'update_item' => __( '更新电影分类' ), 'add_new_item' => __( '添加新的电影分类' ), 'new_item_name' => __( '新电影分类' ), 'menu_name' => __( '电影分类' ), ); $args = array( 'labels' => $labels, 'hierarchical' => true, ); register_taxonomy( 'movie_category', 'movie', $args ); } add_action( 'init', 'my_taxonomies_movie', 0 );

添加到主题之后,我们看到出现了熟悉的文章分类功能,只不过上面的文案全部变成我们自定义的内容了:

自定义分类

这里我们添加两个分类作为演示。

为 Post Type 添加自定义 Meta Box

我们想要添加的电影类型不能仅仅只有正文内容,我们还需要额外添加一些 导演 之类的有关内容。那么就需要添加自定义 Meta Box,Meta Box 可以在文章发表页面中添加自定义的表单,编写文章的时候可以填写额外的信息然后在前端调用出来。

自定义 Meta Box 需要用到 add_meta_box 函数:

add_meta_box( $id, $title, $callback, $post_type, $context,$priority, $callback_args );

老规矩,具体参数内容查看官方文档,这里只介绍常用用法。我们注册一个 Meta Box :

add_action( 'add_meta_boxes', 'movie_director' ); function movie_director() { add_meta_box( 'movie_director', '电影导演', 'movie_director_meta_box', 'movie', 'side', 'low' ); }

然后在配置参数里面指定了回调函数 movie_director_meta_box,我们需要在这个函数里面创建表单:

function movie_director_meta_box($post) { // 创建临时隐藏表单,为了安全 wp_nonce_field( 'movie_director_meta_box', 'movie_director_meta_box_nonce' ); // 获取之前存储的值 $value = get_post_meta( $post->ID, '_movie_director', true ); ?>


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3