• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/wp delete object term relationships

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「関数リファレンス/wp delete object term relationships」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

オブジェクトに関連づけてあったタクソノミーを外します。 指定されたタクソノミーについて、オブジェクトとすべてのタームの関連づけを削除します。 タームやタクソノミーそのものは削除しません。

使い方

<?php wp_delete_object_term_relationships( $object_id, $taxonomies ); ?>

パラメータ

$object_id
整数) (必須) タームを付けてあるオブジェクトの ID
初期値: なし
$taxonomies
文字列|配列) (必須) タクソノミー名のリスト、または一つのタクソノミー名。
初期値: なし

戻り値

この関数は値を返しません。

ある投稿のタグをすべて外す:

<?php

$post_id = 55;

wp_delete_object_term_relationships( $post_id, 'post_tag' );

// ID が 55 の投稿はタグ無しになります。

?>

ある投稿と複数のタクソノミーの関連づけを外す:

<?php

$post_id = 55;
$taxonomies = array( 'category', 'post_tag', 'custom_taxonomy' );

wp_delete_object_term_relationships( $post_id, $taxonomies );

?>

参考

  • wp_get_object_terms() を使って、オブジェクトに付けられたすべてのタームの term taxonomy ID を取得します。
  • $wpdb->query() を使って、タームとの関連づけを削除します。
  • wp_update_term_count() /en を使って、オブジェクトのタームカウントを更新します。
  • do_action() を使って:
    • アクション 'delete_term_relationships' /en を、関連づけを削除する前に呼び出します。パラメータは $object_id と term taxonomy ID の配列です。
    • アクション 'deleted_term_relationships' /en を、関連づけを削除した後に呼び出します。パラメータは $object_id と term taxonomy ID の配列です。

改訂履歴

2.3.0 にて導入されました。

ソースファイル

wp_delete_object_term_relationships()wp-includes/taxonomy.php にあります。

タームタグ: is_term(), term_exists(), get_objects_in_term(), get_term(), get_term_by(), get_term_children(), get_term_link(), get_terms(), get_the_terms(), get_the_term_list(), has_term(), sanitize_term(), the_terms(), get_object_taxonomies() is_object_in_taxonomy() the_taxonomies() wp_get_object_terms(), wp_set_object_terms(), wp_get_post_terms(), wp_set_post_terms(), wp_delete_object_term_relationships()



関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/wp_delete_object_term_relationships最新版との差分