5ucms论坛

标题: add_meta_box()函数 是被用来在文章编辑等页面添加一个设置的区域 [打印本页]
作者: admin    时间: 2021-5-31 14:29
标题: add_meta_box()函数 是被用来在文章编辑等页面添加一个设置的区域
创建的文章类型默认的仅有标题、作者、分类、标签、日期和评论，这些也许对博客已经足够使用了，但是对于产品类型的文章来说，不仅仅需要标题和正文，还需要单独设置一些其它的参数，如产品价格、产品型号、规格大小等，那么就需要给文章类型添加Meta Box，通俗点理解就是自定义字段表单，下面就来以实例讲解下这个函数的用法。

语法结构

  2. <?php add_meta_box(
  3.     $id,
  4.     $title,
  5.     $callback,
  6.     $post_type,
  7.     $context,
  8.     $priority,
  9.     $callback_args
  10. );
  11. ?>
复制代码

参数

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


实例

  1. add_action( 'add_meta_boxes', 'product_price' );
  2. function product_price() {
  3.     add_meta_box(
  4.         'product_price',
  5.         '产品价格',
  6.         'product_price_meta_box',
  7.         'store',
  8.         'side',
  9.         'low'
  10.     );
  11. }
复制代码

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

隐藏的自定义字段

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

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

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

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

  1. add_action( 'save_post', 'product_price_save_meta_box' );
  2. function product_price_save_meta_box($post_id){
  3.     if ( ! isset( $_POST['product_price_meta_box_nonce'] ) ) {
  4.         return;
  5.     }
  6.     if ( ! wp_verify_nonce( $_POST['product_price_meta_box_nonce'], 'product_price_meta_box' ) ) {
  7.         return;
  8.     }
  9.     if ( ! current_user_can( 'edit_post', $post_id ) ) {
  10.         return;
  11.     }
  12.     if ( ! isset( $_POST['product_price'] ) ) {
  13.         return;
  14.     }
  15.     $product_price = sanitize_text_field( $_POST['product_price'] );
  16.     update_post_meta( $post_id, '_product_price', $product_price );
  17. }
复制代码

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

调用代码

  1. <?php
  2. if(get_post_meta($post->ID,'_product_price',true)){
  3.     echo get_post_meta($post->ID,'_product_price',true);
  4. }
  5. ?>
复制代码

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

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

  1. add_filter('manage_store_posts_columns', 'add_new_product_columns');
  2. function add_new_product_columns($columns) {
  3.     $columns['id'] = 'ID';
  4.     $columns['product_price'] = '产品价格';
  5.     return $columns;
  6. }

  8. add_action('manage_store_posts_custom_column', 'manage_posts_columns', 10, 2);
  9. function manage_posts_columns($column,$id) {
  10.     global $post;
  11.     switch ($column) {
  12.         case 'id':
  13.             echo $id;
  14.             break;
  15.         case 'product_price':
  16.             echo get_post_meta( $post->ID, '_product_price', true );
  17.             break;
  18.     }
  19. }
复制代码




欢迎光临 5ucms论坛 (http://bbs.5ucms.com/) Powered by Discuz! X3.2