add_meta_box()函数

add_meta_box()函数是被用来在文章编辑等页面添加一个设置的区域的函数。

创建的文章类型默认的仅有标题、作者、分类、标签、日期和评论,这些也许对博客已经足够使用了,但是对于产品类型的文章来说,不仅仅需要标题和正文,还需要单独设置一些其它的参数,如产品价格、产品型号、规格大小等,那么就需要给文章类型添加Meta Box,通俗点理解就是自定义字段表单,下面就来以实例讲解下这个函数的用法。

语法结构

<?php add_meta_box(
    $id, 
    $title, 
    $callback, 
    $post_type, 
    $context, 
    $priority, 
    $callback_args
); 
?>

参数

$id(字符串)(必需)字段id,唯一
$title(字符串)(必需)标题名称,显示在文章编辑页面
$callback(回调)(必需)回调函数
$post_type(字符串)(必需)文章类型
$context(字符串)(可选)显示位置,文章编辑页面包括’normal’, ‘side’, and ‘advanced’的形式,Menus meta boxes仅用’side’的形式
$priority(字符串)(可选)优先级,默认值: ‘default’
$callback_args(数组)(可选)传递到 callback 函数的参数。callback 函数将接收 $post 对象和其他由这个变量传递的任何参数。

实例

add_action( 'add_meta_boxes', 'product_price' );
function product_price() {
    add_meta_box(
        'product_price',
        '产品价格',
        'product_price_meta_box',
        'store',
        'side',
        'low'
    );
}

创建回调函数product_price_meta_box
配置参数里面指定了回调函数product_price_meta_box,需要在这个函数里面创建表单,

隐藏的自定义字段

插件/主题开发人员如果需要用自定义字段来保存插件或模板相关参数,会发现WordPress不会在页面/文章编辑页的自定义字段列表上显示以”_”(下划线)开始的关键字。这样就可以在自定义参数中将下划线作为第一个字符,这些设置将按自定义字段被保留,但却不会在管理者用户界面的自定义字段中显示出来。

function product_price_meta_box($post) {
    // 创建临时隐藏表单,为了安全
    wp_nonce_field( 'product_price_meta_box', 'product_price_meta_box_nonce' );
    // 获取之前存储的值
    $value = get_post_meta( $post->ID, '_product_price', true );
    ?>
    <label for="product_price"></label>
       <input style="width:180px" type="text" id="product_price" name="product_price" value="<?php echo esc_attr( $value ); ?>" placeholder="输入产品价格">
       <span>价格</span>
    <?php
}

提示:添加上面代码后,新建文章时,在右则就可以看到一个产品价格的输入框。

这时候表单还不能用,因为提交文章之后并没有保存这个 Meta Box 的内容,下面是验证保存内容的代码:

add_action( 'save_post', 'product_price_save_meta_box' );
function product_price_save_meta_box($post_id){
    if ( ! isset( $_POST['product_price_meta_box_nonce'] ) ) {
        return;
    }
    if ( ! wp_verify_nonce( $_POST['product_price_meta_box_nonce'], 'product_price_meta_box' ) ) {
        return;
    }
    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }
    if ( ! isset( $_POST['product_price'] ) ) {
        return;
    }
    $product_price = sanitize_text_field( $_POST['product_price'] );
    update_post_meta( $post_id, '_product_price', $product_price );
}

把上面的代码按顺序添加到主题的functions.php文件,至此,Meta Box注册完成,就可以开始添加参数了:

调用代码

<?php 
if(get_post_meta($post->ID,'_product_price',true)){
    echo get_post_meta($post->ID,'_product_price',true);
}
?>

把META BOX添加把后台所有产品列表字段中显示

通过manage_$post_type_posts_custom_column实现,代码如下

add_filter('manage_store_posts_columns', 'add_new_product_columns');
function add_new_product_columns($columns) {
    $columns['id'] = 'ID';
    $columns['product_price'] = '产品价格';
    return $columns;
}

add_action('manage_store_posts_custom_column', 'manage_posts_columns', 10, 2);
function manage_posts_columns($column,$id) {
    global $post;
    switch ($column) {
        case 'id':
            echo $id;
            break;
        case 'product_price':
            echo get_post_meta( $post->ID, '_product_price', true );
            break;
    }
}