常用函数-delete_post_meta()

说明

该函数从指定文章中删除含有指定关键字的所有自定义字段。参见 update_post_meta(), get_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');    
  }  
?>

更详细的示例请查阅 post_meta函数示例 页面。

注意：与 update_post_meta()不同的是，该函数删除所有符合标准的字段。

参数

$post_id

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

默认值：None

$key

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

默认值：None

$value

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

默认值：None

相关资源

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

分类：中文手册