wordpress开发:自定义发布类型post_type与栏目添加

本文以浅显易懂的方式,以添加一个产品类型为例,介绍wordpress中自定义发布类型post_type的添加方法。本文主要关注后台部分的添加,前台请参考官方模板的代码,本文尚在不断更新完善中。

国内文章一大抄,百度一下千篇一律,完全都是翻译的官方手册。官方手册我不会自己看啊?

基础知识普及

若对wordpress架构比较了解请略过此段。

Wordpress所有文章都是存储在`wp_posts`表中,这个表里的东西很杂,除了有普通博客的文章,还有附件,通过`post_type`字段来区分。wordpress里面还有一个叫wp_postmeta的表,大白话讲这个表就是存储关联信息的表。每一篇文章,可能都会有几个关联的信息,比如访问量点击数这种,通过post_meta这种方式来存储和获取。

流程

post_type就是自定义发布类型了,这也是对wordpress进行二次开发的第一步。我们知道wp本身是个博客程序,他所有文章甚至附件都存储在一个表中(wp_posts),通过post_type来区分。wp提供了一整套流程,通过这套流程可以方便的创建自己的伪模型、自定义各种字段、方便的在后台添加创建栏目。这里要特别说明一件事,我们创建了新的post_type,实际数据也是在wp_posts表中的,也就是说,我们并没有真正改变表结构,只是通过post_meta这种方式关联了一些信息,就像是新建了字段一样。流程大致为:

  1. 注册新类型:就是告诉wp,我们要搞一个新的发布类型,叫什么名字等等。
  2. 添加MetaBox:后台里面,字段数据添加、修改的展示表格。
  3. MetaBoxpost_meta关联:上一步只是添加表格,数据提交后,把相应的数据写入post_meta
  4. 指定这个新类型的分类
  5. 设置前台列表页和内容页展示的页面

以下以产品product为例,分五部分介绍核心代码,达到快速入门的目的。拓展时可以直接参考官方手册,常规使用下面70%够用。

新建post_type

//添加product类型
function create_product_type() {
    register_post_type( 'product',
        array(
            'labels' => array(
                'name' => '产品',
                'singular_name' => '单条产品',
                'add_new' => '添加产品',
                'add_new_item' => '添加产品',
                'edit' => '编辑',
                'edit_item' => '编辑产品',
                'new_item' => '新产品',
                'view' => '查看',
                'view_item' => '查看产品',
                'search_items' => '查找产品',
                'not_found' => '没有找到产品信息',
                'not_found_in_trash' => '回收站没有产品',
                'all_items' =>  '产品列表',
            ),

            'public' => true,
            'menu_position' => 15,
            'supports' => array( 'title', 'editor', 'thumbnail' ),
            'taxonomies' => array( '' ),
            'has_archive' => true
        )
    );
}
add_action( 'init', 'create_product_type' );

register_post_type官方手册:https://codex.wordpress.org/Function_Reference/register_post_type

添加Meta Box和字段的展示

// 添加Meta Box
function add_product_box() {
    add_meta_box( 'product_meta_box',    //唯一标记
        '产品信息',               //Meta Box标题
        'display_product_meta_box_callback',      //回调函数
        'product',                       //关联的自定义文章类型
        'normal',                       //页面显示位置
        'high'                          //显示位置优先级
    );
}
add_action( 'add_meta_boxes', 'add_product_box' );
// 添加展示
function display_product_meta_box_callback( $result ) {
    // 产品简称
    $product_code = esc_html( get_post_meta( $result->ID, 'product_code', true ) );
    ?>
    <table>
        <tr>
            <td style="width:120px;">产品代码</td>
            <td style="width:85%;"><input type="text" style="width:500px;" name="product_code" value="<?php echo $product_code; ?>" /></td>
            <?php wp_nonce_field( 'product_save_nonce', 'product_save_nonce' );  //安全提交函数 ?>
        </tr>
    </table>
    <?php
}

示例中只添加一个字段,就是产品简称。

add_meta_box官方手册:https://developer.wordpress.org/reference/functions/add_meta_box/

MetaBox和post_meta关联

function save_product_fields( $post_id, $post ) {
    // 判断类型
    if ( $post->post_type == 'product' && wp_verify_nonce( $_POST['product_save_nonce'], 'product_save_nonce' ) ) {
        // 写入数据
        if ( isset( $_POST['product_code'] ) {
            update_post_meta( $post_id, 'product_code', $_POST['product_code'] );
        }
    }
}
add_action( 'save_post', 'save_product_fields', 10, 2 );

添加分类

// 产品自定义分类
function product_taxonomies() {
    register_taxonomy(
        'product_category',    //自定义分类名
        'product',                //自定义类型
        array(
            'labels' => array(
                'name' => '产品分类',
                'add_new_item' => '添加产品分类',
                'new_item_name' => '新产品分类',
            ),
            'show_ui' => true,          //后台显示
            'show_tagcloud' => false,   //是否显示标签云
            'hierarchical' => true,     //控制分类法格式
        )
    );
}
add_action( 'init', 'product_taxonomies', 0 );

register_taxonomy官方手册:https://developer.wordpress.org/reference/functions/register_taxonomy/

指定前台展示页面

// 指定页面模板
function product_template( $template_path ) {
    if ( get_post_type() == 'product' ) {
        if ( is_single() ) {
            $theme_file = locate_template( array ( 'single-product.php' ) );
            $template_path = $theme_file;
        } elseif ( is_archive() ) {
            $theme_file = locate_template( array ( 'archive-product.php' ) );
            $template_path = $theme_file;
        }
    }
    return $template_path;
}
add_filter( 'template_include', 'product_template', 1 );

locate_template官方手册:https://developer.wordpress.org/reference/functions/locate_template/

本文更新完善中,如有错误请批评指正。

点赞