編輯“WordPress:Function Reference/delete post meta”

==描述==

函數(shù)用某篇文章特別規(guī)定的key，刪除所有的自定義區(qū)。也看看[[WordPress:Function Reference/update post meta|update_post_meta()]], [[WordPress:Function Reference/get post meta|get_post_meta()]] 和 [[WordPress:Function Reference/add post meta|add_post_meta()]]。

==用法==

%%% <?php delete_post_meta($post_id, $key, $value); ?> %%%

==例子==
===默認(rèn)用法===

<?php delete_post_meta(76, 'my_key', 'Steve'); ?>

===其它的例子===

假如我們有一個插件，這個插件可以向文章添加一些meta參數(shù)值，但是當(dāng)我們卸載插件的時候，我們想要刪除插件添加的所有的文章 meta keys。假定插件添加keys<tt>related_posts</tt> 和<tt>post_inspiration</tt>。

要刪除所有的keys，需要將下面的內(nèi)容添加到"卸載"函數(shù)：
<pre><?php
  $allposts = get_posts('numberposts=0&post_type=post&post_status=');

  foreach( $allposts as $postinfo) {
    delete_post_meta($postinfo->ID, 'related_posts');
    delete_post_meta($postinfo->ID, 'post_inspiration');
  }
?></pre>

或者，如果你想要刪除除了<tt>post_inspiration</tt>是"Sherlock Holmes"之外的所有的keys：

<pre><?php
  $allposts = get_posts('numberposts=0&post_type=post&post_status=');

  foreach( $allposts as $postinfo) {
    delete_post_meta($postinfo->ID, 'related_posts');
    $inspiration = get_post_meta( $postinfo->ID, 'post_inspiration );
    foreach( $inspiration as $value ) {
      if( $value != "Sherlock Holmes" )
        delete_post_meta($postinfo->ID, 'post_inspiration', $value);
    }
  }
?></pre>


或者可能文章數(shù)字185已經(jīng)刪除了，而且你想要刪除所有提及這個數(shù)字的<tt>related_posts</tt> keys：

<pre><?php
  $allposts = get_posts('numberposts=0&post_type=post&post_status=');

  foreach( $allposts as $postinfo) {
    delete_post_meta($postinfo->ID, 'related_posts', '185');
  }
?></pre>

更詳細的例子，請進入[[WordPress:Function Reference/post meta Function Examples|post_meta函數(shù) 例子]]網(wǎng)頁。

'''''注:'''與[[WordPress:Function Reference/update post meta|update_post_meta()]]不同，這個函數(shù)會刪除匹配標(biāo)準(zhǔn)的'''所有的'''區(qū)。
==參數(shù)==

{{Parameter|$post_id|integer|你刪除某個區(qū)所在文章的ID。}}

{{Parameter|$key|string|你將要刪除某個區(qū)的key。}}

{{Parameter|$value|string|你將要刪除的某個區(qū)的參數(shù)值。這個參數(shù)值是用來區(qū)分幾個具有相同的key的區(qū)。如果這個參數(shù)值是空的，那么某個key的所有區(qū)都會被刪除。|可選擇的}}

==相關(guān)的==
[[WordPress:Function Reference/update post meta|update_post_meta()]], [[WordPress:Function Reference/get post meta|get_post_meta()]], [[WordPress:Function Reference/add post meta|add_post_meta()]], [[WordPress:Function Reference/get post custom|get_post_custom()]], [[WordPress:Function Reference/get post custom values|get_post_custom_values()]], [[WordPress:Function Reference/get post custom keys|get_post_custom_keys()]]