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



お勧め

5.3の新機能:日付とタイムゾーン(2019年10月2日 更新)

WordPress 5.3 Beta 1」に記載されていた「Time/Date component fixes」という見出し。開発者向として新しい関数の追加や多くのバグが修正されたとなっており、チェックせざるを得ない。

PHPとMySQLのバージョンを確認(2013年9月11日 更新)

先日、WordPressで構築されたサイトについて最新版へのバージョンアップを依頼される。使用されていたWordPressはバージョン2.xということで、最新版へバージョンアップできるのか、PHPとMySQLのバージョンを確認することになった。

ACF(Advanced Custom Fields)向けにデータをインポートした時のメモ(2023年7月11日 更新)

ACFを採用するサイトにデータをインポートする際、ほとんどのことはwww.advancedcustomfields.comに記載されていたのだが、いくつかわからないことがあった。ここでは、その時に調べたことをメモしておく。

不要なプラグインを読み込まない(2023年6月2日 更新)

稼働中のサーバーにてバックグラウンドで何か処理しようとコマンドラインのプログラムを作る際、効率化や誤動作のリスクを考えると不要なプラグインはロードしないようにしたい。そんなわけで設定内容(データベース)は変更せず、特定のプラグインをロードしないようにできないか考えてみた。

Align widgets horizontally:プラグイン作ってみました(2024年2月28日 更新)

ほぼ毎日何度も見ているダッシュボードページ。自分好みに各ウィジェットの場所を配置しているものの、何かすっきりしない。そこでふと思ったのが、ウィジェットを横並びにできれば隣り合うウィジェットの並びがガタガタしなくなるのでは!?