wp_remove_object_terms

（3.6.0以降）
wp_remove_object_terms - 投稿情報などに関連付けられたタクソノミーの関連付けを外す

説明

mixed wp_remove_object_terms( int $object_id, mixed $terms, mixed $taxonomy )

投稿情報などに関連付けられたタクソノミーの関連付けを外す。

パラメータ

$object_id
投稿情報などのIDを指定。
$terms
タームID、ターム名またはそれらの配列を指定。
$taxonomy
'category'や'post_tag'などのタクソノミー名またはその配列を指定。

返り値

正しく削除できたた場合はtrueを、削除できなかった場合はfalseを返す。また、タクソノミーやタームが存在しない場合は WP_Errorオブジェクトを返す。

注意

wp_add_object_terms関数の逆の機能で、投稿情報に割り付けられているカテゴリや投稿タグなどのタクソノミーを削除する（関連付けを外す）。

使用例

$post_idで示す投稿情報から投稿タグ'recommendation'を削除する。
<?php wp_remove_object_terms( $post_id, 'recommendation', 'post_tag' ); ?>

フィルター

直接実行するフィルターはありません。

アクション

関連付けを削除する直前に'delete_term_relationships'アクションが呼び出される。パラメータ$tt_idsにはパラメータ$termsと$taxonomyから取得したタームIDの配列となる。

do_action( 'delete_term_relationships', $object_id, $tt_ids );

関連付けを削除した直後に'deleted_term_relationships'アクションが呼び出される。パラメータ$tt_idsにはパラメータ$termsと$taxonomyから取得したタームIDの配列となる。

do_action( 'deleted_term_relationships', $object_id, $tt_ids );

ソースファイル

/wp-includes/taxonomy.php

最終更新 : 2013年08月08日 15:33

参考

Code Reference: wp_remove_object_terms

お勧め

投稿記事でrubyタグを使えるようにする（前編）（2012年1月25日更新）

rubyなどのルビ関連タグはIEの独自サポートから始まり、少し前のChrome/Safariが追随して利用できるようになっている。Firefoxはいまだにサポートしていないのだが、それなりに代替表示されるので、投稿記事で使えるようにしてみた。

WordPressの鼓動（2013年10月1日更新）

WordPressでは、Ajaxを利用する方法の1つとして add_action関数を利用することができる。この方法を調べている過程で、'heartbeat'というおもしろそうなAjaxアクションがあったので、紹介しておく。

「順序」をtextからnumberに変更してみた（2018年5月27日更新）

固定ページの編集画面の「投稿の属性」ウィジェットには、ページの並び替えに使用できる「順序」のinput要素がある。この「順序」のinput要素はtype属性が'text'となっており、編集の際にIMEが有効になってしまう場合がある。ページの編集頻度が多くなると、その都度IMEをオフにするのがやや面倒になってくる。

一定時間でログアウトする（2013年5月23日更新）

ログイン関係を調べている関係で、 wp_set_auth_cookie関数に行き着く。ログイン画面の「ログイン状態を保持する」がチェックされた場合、クッキーの有効期限は14日間。チェックされていない場合は、ブラウザが閉じるまで常に有効となっているんだね。

5.3の機能強化：カスタムフィールドキーの条件指定が使いやすくなる（2019年11月19日更新）

5.3 RC4もリリースされ、正式リリースまであと1週間。5.3の変更点を確認していると、WP_Meta_Queryクラスが変更されていた。これは「Expanded meta key comparison operators in 5.3」で紹介されており、さまざまな条件指定が追加されていた。