WordPress:Function Reference/add post meta

目錄

• 1 描述
• 2 用法
• 3 例子
  • 3.1 默認用法
  • 3.2 添加或者更新一個獨特的區(qū)
  • 3.3 其它的例子
  • 3.4 制作一個 "隱藏的" 自定義區(qū)
• 4 參數(shù)
• 5 相關的

描述

add_post_meta為某篇文章添加了一個自定義的（meta）區(qū)。

如果$unique參數(shù)設置為true而且已經(jīng)存在特別的meta關鍵詞，函數(shù)返回false而且不做什么更改；否則的話，函數(shù)返回true。

用法

%%% <?php add_post_meta($post_id, $meta_key, $meta_value, $unique); ?> %%%

例子

默認用法

<?php add_post_meta($68, 'my_key', 47); ?>

添加或者更新一個獨特的區(qū)

如果你存在關鍵詞，添加一個新的field，或者更新現(xiàn)存的field。

 <?php add_post_meta(7, 'fruit', 'banana', true) 或者update_post_meta(7, 'fruit', 'banana'); ?>

其它的例子

如果你想要確定沒有帶有關鍵字"my_key"的fieled，添加之前：

<?php add_post_meta(68, 'my_key', '47', true); ?> To add several values to the key "my_key":

<?php add_post_meta(68, 'my_key', '47'); ?>
<?php add_post_meta(68, 'my_key', '682'); ?>
<?php add_post_meta(68, 'my_key', 'The quick, brown fox jumped over the lazy dog.'); ?>
...

更詳細的例子，請進入post_meta 函數(shù)例子網(wǎng)頁。

制作一個 "隱藏的" 自定義區(qū)

如果你是一個插件/主題開發(fā)人員而且你計劃使用自定義field儲存與你的插件或者主題相關的參數(shù)，你或饒有興趣地發(fā)現(xiàn)，WordPress習慣于顯示網(wǎng)頁/文章編輯網(wǎng)頁中自定義field列表上以"_"（下劃線）開始的關鍵字。就是說，在自定義參數(shù)中將下劃線設置為第一個字符，是個很好的做法，這樣你可以將設置儲存為自定義fields，但是你的設置不會在管理UI中的自定義fields列表中顯示。

下面的例子：

<?php add_post_meta(68, '_color', 'red', true); ?> 會添加一個關鍵字是 "_color" 的自定義范圍而且這個自定義范圍中的參數(shù)值"red"不會在網(wǎng)頁/文章編輯網(wǎng)頁中顯示。

相關的

delete_post_meta(), get_post_meta(), update_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()

delete_post_meta(), get_post_meta(), update_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()