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;
}
}