wordpress进阶教程(六):创建自定义字段面板

2020-08-30 11:38:14

上一篇教程中我们介绍了wordpress自定义字段,以及自定义字段的操作函数,但是对于自定义字段的时候,在后台添加的使用通过那个面板添加十分不方便,比如你要使用自定义字段来实现seo功能,那么你每次都需要重复输入字段名称:titlekeywordsdescription。

今天这篇文章,我们将讲解为自定义字段添加一个固定的面板,这样就不用每次为每个字段输入字段名称了。

说明:不要误以为自定义面板就是用来添加自定义字段的,你可以通过本篇教程添加一个自定义字段来干任何事,比如你只是想显示一个提示信息而已,用来显示浏览次数,等等。。。本篇教程的核心应该是怎样在后台添加自定义面板。

效果图:wordpress自定义字段面板
要在后台创建一个面板,首先了解一个函数:


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

准备工作:

1、准备文件,作者以默认的twenty ten主题做测试,在默认主题中新建一个metabox.php文件,而后在主题的functions.php中include该文件。

步骤、(接下来的代码参考自露兜博客)

一、准备要创建的字段信息,我们将添加keywords和description两个字段。在metabox.php文件中添加代码(php文件别忘了哦):


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

这是一个二维数组,数组的第一个元素就是description字段的信息,包括标题、字段名、描述信息。

二、创建(显示)面板内容的函数


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

该函数用来显示面板的内容,将作为add_meta_box函数才callback参数调用。

三、创建面板


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

这个函数代码就不解释了,看前面函数详细介绍。

四、保存更新数据


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

改函数用来保存和更新我们的字段值

 

OK,函数代码都准备好了,下马就是触发了,我们应该先执行create_meta_box函数,因为 add_meta_box是由它调用的。使用动作钩子,继续添加下面的代码:


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

同时在保存文章的时候执行更新和保存字段的函数。

 

调用:通过 get_post_meta函数调用即可


   

$new_meta_boxes =   
array(   
    "description" => array(   
        "name" => "description",   
        "std" => "这里填默认的网页描述",   
        "title" => "网页描述:"),   
  
    "keywords" => array(   
        "name" => "keywords",   
        "std" => "这里填默认的网页关键字",   
        "title" => "关键字:")   
);  

function new_meta_boxes() {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        $meta_box_value = get_post_meta($post->ID, $meta_box['name'].'_value', true);   
  
        if($meta_box_value == "")   
            $meta_box_value = $meta_box['std'];   
  
        echo'';   
  
        // 自定义字段标题   
        echo'

'.$meta_box['title'].'

';   
  
        // 自定义字段输入框   
        echo '
';   
    }   
}  

function create_meta_box() {   
    global $theme_name;   
  
    if ( function_exists('add_meta_box') ) {   
        add_meta_box( 'new-meta-boxes', '自定义模块', 'new_meta_boxes', 'post', 'normal', 'high' );   
    }   
}  

function save_postdata( $post_id ) {   
    global $post, $new_meta_boxes;   
  
    foreach($new_meta_boxes as $meta_box) {   
        if ( !wp_verify_nonce( $_POST[$meta_box['name'].'_noncename'], plugin_basename(__FILE__) ))  {   
            return $post_id;   
        }   
  
        if ( 'page' == $_POST['post_type'] ) {   
            if ( !current_user_can( 'edit_page', $post_id ))   
                return $post_id;   
        }    
        else {   
            if ( !current_user_can( 'edit_post', $post_id ))   
                return $post_id;   
        }   
  
        $data = $_POST[$meta_box['name'].'_value'];   
  
        if(get_post_meta($post_id, $meta_box['name'].'_value') == "")   
            add_post_meta($post_id, $meta_box['name'].'_value', $data, true);   
        elseif($data != get_post_meta($post_id, $meta_box['name'].'_value', true))   
            update_post_meta($post_id, $meta_box['name'].'_value', $data);   
        elseif($data == "")   
            delete_post_meta($post_id, $meta_box['name'].'_value', get_post_meta($post_id, $meta_box['name'].'_value', true));   
    }   
}  

add_action('admin_menu', 'create_meta_box');   
add_action('save_post', 'save_postdata');  

$description = get_post_meta($post->ID, "description_value", true);   
$keywords = get_post_meta($post->ID, "keywords_value", true);  

注意字段名称,我们在保存数据的时候,保存的字段名称分别是description_value、keywords_value。。。

OK,自定义面板的创建结束。

节目预告:显然,这样创建面板效率不高,而且只能添加文本框,对于主题开发者来说,可用性不高,所以在接下来的教程中,我们将用类添加面板,并且面板不仅仅是普通的文本输入框,应该包括,下拉框、选择框、图片上传等等。。敬请期待。。。