信赖很多站长都知道而且已经在利用WordPress自定义字段,很多插件也利用了这一功能。
自定义字段是一个非常不错的功能,它可以或许让我们为文章添加各种自定义的属性,高度灵活,操作简单。好比可以为文件添加一个SEO MetaDescription的自定义字段,我们可以输入一段文字来概括文章内容,在前台表现的时候可以根据该字段来天生HTML的<meta>标签,使搜索引擎更加方便的了解页面的内容,资助索引。
但是,由于它的高度灵活,导致了一些问题,尤其由于自定义字段的值的输入是一个文本框,导致在输入时会非常未便,例如,计划的是一个整形的字段,但是由于文本框没有验证和提示,导致大概会输入非整数,在前台利用时就会出现问题,乃至导致网站挂掉。或者字段的值是预定义的值集合中的一个(好比有个性别的字段,就只是男和女中的一个值),但是文本框是不会提示你可以输入哪些值。
总的来说,不方便之处是文本框的单一输入方式无法满意差异场景下差异字段范例的输入需求和验证需求。
那么,解决方案来了,利用自定义Meta Box来自定义编辑页面。
以添加一个自定义字段——【推荐指数】为例,来讲讲如何利用Meta Box。
备注:推荐指数,在本例中指的是文章作者对文章的打分,分数在1~10分,为整数。分数越高,越推荐。
先来看看终极的样子,我们可以通过下拉列表来选择值了。
起首,须要利用到add meta boxes Action,该Action答应我们为任何文章范例注册Meta Box,在该Action中,我们须要利用add_meta_box()方法来添加Meta Box的相关信息。代码如下
PHP Code复制内容到剪贴板
- function add_rating_meta_box($post_type, $post) {
- // 须要哪些post type添加推荐指数 Meta Box
- $types = array( 'post', 'page' );
-
- foreach ( $types as $type ) {
- add_meta_box(
- 'rating_meta_box_id', // Meta Box在前台页面中的id,可通过JS获取到该Meta Box
- '推荐指数', // 表现的标题
- 'render_rating_meta_box', // 回调方法,用于输出Meta Box的HTML代码
- $type, // 在哪个post type页面添加
- 'side', // 在哪表现该Meta Box
- 'default' // 优先级
- );
- }
- }
- add_action( 'add_meta_boxes', 'add_rating_meta_box' );
这里我们在$types数组中定义了Post和Page都须要推荐指数这个自定义字段,然后告诉WordPress利用“render_rating_meta_box”方法来渲染Meta Box,位置在侧边栏(side)。由于内容不多,所以侧边栏足够,若内容较多,可以将“side”改为“advanced”,这样就会在主内容地区渲染Meta Box。
接下来看看是如何渲染的
PHP Code复制内容到剪贴板
- function render_rating_meta_box( $post ) {
- // 添加 nonce 项用于后续的安全查抄
- wp_nonce_field( 'rating_nonce_action', 'rating_nonce_name' );
-
- // 获取推荐指数的值
- $rating_key = 'rating';
- $rating_value = get_post_meta( $post->ID, $rating_key, true );
- $rating_value = (int)$rating_value;
-
- $html = '<select name="rating_field">';
- for ($i = 0; $i <= 10; $i++) {
- $selected = '';
- if ($i == $rating_value) {
- $selected = 'selected="selected"';
- }
- $html .= sprintf('<option value="%s" %s>%s星</option>', $i, $selected, $i/2);
- }
- $html .= '</select>';
- echo $html;
- }
这里先利用wp_nonce_field()添加了一个nonce field,用来做安全查抄,然后,读取推荐指数的值,循环1~10来输出可供选择的值,假如和推荐指数相同,则默认选上。通过下拉框,既可以解决输入不方便和无法验证的问题。记住这里下拉框的name属性的值(rating_field),将通过它在下面的代码中获取选择的值。
末了,当文章被保存时,须要将推荐指数也保存起来
PHP Code复制内容到剪贴板
- function save_rating_post_data( $post_id ) {
- // 查抄nonce是否设置
- if (!isset($_POST['rating_nonce_name'])) {
- return $post_id;
- }
- $nonce = $_POST['rating_nonce_name'];
-
- // 验证nonce是否准确
- if (!wp_verify_nonce( $nonce, 'rating_nonce_action')) {
- return $post_id;
- }
-
- // 假如是体系自动保存,则不操作
- if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
- return $post_id;
- }
-
- // 查抄用户权限
- if ($_POST['post_type'] == 'post') {
- if (!current_user_can('edit_post', $post_id )) {
- return $post_id;
- }
- }
-
- $rating_key = 'rating';
- // 获取数据
- $rating_value = $_POST['rating_field'];
-
- // 更新数据
- update_post_meta( $post_id, $rating_key, $rating_value );
- }
- add_action( 'save_post', 'save_rating_post_data' );
这里做了一系列查抄,包括对刚刚设置的nonce查抄,用户权限的查抄,清除自动保存的情况。然后利用update_post_meta()方法将数据存入数据库。
至此,我们就完成了对推荐指数自定义字段的改装,可以很方便的选择文章的推荐指数。
等等。。。
细心的朋友大概发现了,在应用了上面三段代码后,简直可以实现功能。但是,在默认的自定义栏目地区下,是可以看到,有一个名为“rating”的栏目,这就是我们刚刚选择的推荐指数。假如想让他不在自定义栏目下,表现,可以将上述代码中的$rating_key改为以下划线开头,这样,WordPress就不会表现出来了。留意有两个地方要改。
PHP Code复制内容到剪贴板
- // 原来的代码
- $rating_key = 'rating';
- // 改后的代码
- $rating_key = '_rating';
|