程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> PHP綜合 >> WordPress中編寫自定義存儲字段的相關PHP函數解析

WordPress中編寫自定義存儲字段的相關PHP函數解析

編輯:PHP綜合

WordPress 的自定義字段就是文章的 meta 信息(元信息),利用這個功能,可以擴展文章的功能,是學習 WordPress 插件開發和主題深度開發的必備知識,方便給文章儲存一些額外的自定義內容。

自定義字段不光給插件開發者使用,WordPress 的特色圖像、自定義頁面模板等功能的信息都儲存在自定義字段的表單裡邊。

在文章編輯器界面的 “自定義欄目” 板塊可以管理除了名字開頭是 “_” 的字段(沒有 “自定義欄目” 板塊請在右上角的 “顯示選項” 開啟),所以很多 WordPress 自己使用的自定義字段無法在此管理。
存儲原理

自定義字段非常靈活,首先來說一下它的儲存原理和為什麼這麼靈活。數據庫中,儲存文章的 wp_posts 表單,只有默認的 20 個項目,用於儲存必須的文章信息。

20151225143034327.png (332×620)

而存儲自定義字段的 wp_postmeta 表,卻只有四個項目,分別是 meta_id(自定義字段的 ID)、post_id(自定義字段屬於的文章的 ID)、meta_key(自定義字段的名字)和 meta_value(自定義字段的值),一般我們只需要注意 meta_key 和 meta_value 兩個項目即可。

正是因為這樣,每篇文章都可以有相同名字但不同值的自定義字段,而且可以有無限個自定義字段,任何的插件和主題都可以利用自定義字段對文章信息進行擴展。

一篇文章的自定義字段的名字是可以重復的。

添加字段

自定義字段可以在文章編輯頁面操作,但本文主要寫關於開發的事情。

20151225143103462.png (832×428)

添加自定義字段,可以使用 add_post_meta() 函數:

add_post_meta( $post_id, $meta_key, $meta_value, $unique );

參數:

$post_id

(整數)(必須)添加自定義字段的文章的 ID.

默認值:None

$meta_key

(字符串)(必須)自定義字段的名稱。

默認值:None

$meta_value

(混合)(必須)自定義字段的值。

默認值:None

$unique

(布爾)(可選)如果已經有相同名字的字段,是否重復添加。True 允許;False 不允許。

默認值:False

更新字段

要更新一個字段的值,可以使用 update_post_meta() 函數:

update_post_meta( $post_id, $meta_key, $meta_value, $prev_value );

參數:

$post_id

(整數)(必須)更新自定義字段的文章的 ID.

默認值:None

$meta_key

(字符串)(必須)更新的自定義字段的名稱。

默認值:None

$meta_value

(混合)(必須)更新的自定義字段的值。

默認值:None

$prev_value

(混合)(可選)此參數只有在一篇文章有多個相同名稱的自定義字段時才有用。如果留空,則更新所有同名的字段,否則則更新和此參數值相同的值的字段。

默認值:空字符串

獲取字段

獲取字段可以使用 get_post_meta() 函數:

get_post_meta( $post_id, $key, $single );

參數:

$post_id

(整數)(必須)要獲取字段的文章 ID,如果在循環中,可以使用 get_the_ID() 來設置。

默認值:None

$key

(字符串)(可選)要獲取的字段的名稱。

默認值:None

$single

(布爾)(可選)如果為 True 則返回一個字符串;如果為 False 則返回數組,且相同鍵值的自定義字段的值會按照添加順序組合成一個序列數組。

默認值:False

例子

下邊是一個浏覽統計的簡單例子:

function Bing_statistics_visitors( $cache = false ){
  if( !is_singular() ) return;
  global $post;
  $id = $post->ID;
  if( get_post( $id )->post_status != 'publish' ) return;
  $post_views = (int) get_post_meta( $id, 'views', true );
  update_post_meta( $id, 'views', ( $post_views + 1 ) ) || add_post_meta( $id, 'views', 1, true );
}
add_action( 'wp_head', 'Bing_statistics_visitors' );
獲取計數:
function Bing_get_views(){
  global $post;
  $views = number_format( (int) get_post_meta( $post->ID, 'views', true ) );
  return $views;
}

不可見的自定義字段
雖然在數據庫裡存在很多 WordPress 自己創建的自定義字段,但是在文章編輯器的 “自定義欄目” 裡卻並沒有顯示(沒有 “自定義欄目” 板塊請在右上角的 “顯示選項” 開啟),比如特色圖像、自定義頁面模板和評論是否開啟等等。

如果仔細觀察,會發現這些自定義字段的名字都是以下劃線 “_” 開頭的,所以說,以下劃線 “_” 開頭的自定義字段並不會顯示給用戶,the_meta() 函數也不會輸出,對用戶來說是隱藏的。

20151225143222855.png (827×410)

利用這個特性,我們可以把不想讓用戶隨便修改的字段、會讓用戶感到困惑的字段,比如已經提供設置界面的設置選項、緩存數據等等,以免出現錯誤。

下邊是一個小例子:

add_post_meta( get_the_ID(), '_time_diff', time() );

另外,如果自定義字段儲存的內容是數組即使名字前邊不是下劃線 “_” 也不會顯示。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved