编辑“WordPress常用函数delete post meta”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> [[WordPress常用函数(上)|
上一页]] | {{Template:WordPress导航}}</span>
<div style="clear:both;"></div>
==说明==
该函数从指定文章中删除含有指定[[关键字]]的所有自定义字段。参见[http://codex.wordpress.org/Function_Reference/update_post_meta update_post_meta()], [http://codex.wordpress.org/Function_Reference/get_post_meta get_post_meta()] 和[http://codex.wordpress.org/Function_Reference/add_post_meta add_post_meta()]。

==用法==
 <?php delete_post_meta($post_id, $key, $value); ?>

==示例==
'''缺省用法'''

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

===其他示例===
假设有一个插件为文章添加了若干meta值，但卸载插件时希望能删除插件所添加的所有meta关键字。假设插件添加的关键字是related_posts和ost_inspiration。

要删除所有关键字，需要将以下代码添加到“uninstall”函数中：

 <?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');    
  }  
 ?>
如果想删除所有关键字，只保留post_inspiration作为探测器那一部分，可以使用如下代码：
 <?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);      
    }    
  }  
 ?>
如果已将编号为185的文章删除，之后希望将所有涉及该文章的related_posts关键字删除时，可以：
 <?php    
  $allposts = get_posts('numberposts=0&post_type=post&post_status=');      
  foreach( $allposts as $postinfo) {      
    delete_post_meta($postinfo->ID, 'related_posts', '185');    
  }  
 ?>

更详细的示例请查阅[http://codex.wordpress.org/Function_Reference/post_meta_Function_Examples post_meta函数]示例 页面。

'''注意：'''与[http://codex.wordpress.org/Function_Reference/update_post_meta update_post_meta()]不同的是，该函数删除所有符合标准的字段。

'''参数'''

'''$post_id'''

（整数）（必需）需删除字段的文章编号

默认值：None

'''$key'''

（字符）（必需）将要删除字段的关键字

默认值：None

'''$value'''

（字符）（可选）将要删除字段的值。这用来区分含有相同关键字的字段。如果该函数为空，将删除含有给定关键字的所有字段。

默认值：None

'''相关资源'''

[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-add_post_meta%28%29.html add_post_meta()], [http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_post_meta%28%29.html get_post_meta()], [http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-update_post_meta%28%29.html update_post_meta()], [http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_post_custom%28%29.html get_post_custom()], [http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_post_custom_values%28%29.html get_post_custom_values()], [http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_post_custom_keys%28%29.html get_post_custom_keys()]
==相关条目==
*[[Drupal]] 
*[[OBLOG]] 
*[[X-Space]] 
*[[SaBlog-X]] 
*[[Bo-Blog]]

[[category:WordPress中文文档|G]]
[[category:WordPress网站开发|G]]
[[category:WordPress开发文档|G]]