説明
mixed wp_set_object_terms( int $object_id, mixed $terms, mixed $taxonomy [ , bool $append = false ] )
投稿情報などにタクソノミーを設定する。
パラメータ
- $object_id投稿情報などのIDを指定
- $termsタームID、ターム名またはそれらの配列を指定
- $taxonomy'category'や'post_tag'などのタクソノミー名またはその配列を指定
- $append追加のみを行う場合はtrue、指定したタクソノミー以外を削除する場合はfalseを指定（省略時、false）
返り値
正しく設定できた場合はタームIDの配列を返す。設定できなかった場合は、エラー内容を示す WP_Errorオブジェクトを返す。注意
カスタム投稿タイプにカテゴリを設定する場合は、 register_post_type関数による登録際、'taxonomies'プロパティに'category'を指定しておくこと。この指定がない場合は正しく動作しない。wp_set_post_categories関数ではカテゴリーをIDまたはその配列で指定するが、このwp_set_object_terms関数は文字列で指定できるので、こちらのほうが便利かも。
使用例
- 投稿IDが10の投稿情報に'ニュース'と'値下げ'のカテゴリーを設定する。<?php wp_set_object_terms( 10, array( 'ニュース', '値下げ' ), 'category' ); ?>
フィルター
実行するフィルターはありません。アクション
タクソノミーの関連付け情報を追加する前に'add_term_relationship'アクションを呼び出す。do_action( 'add_term_relationship', $object_id, $tt_id );do_action( 'added_term_relationship', $object_id, $tt_id );do_action( 'delete_term_relationships', $object_id, $delete_terms );do_action( 'deleted_term_relationships', $object_id, $delete_terms );do_action( 'set_object_terms', $object_id, $terms, $tt_ids, $taxonomy, $append, $old_tt_ids );ソースファイル
/wp-includes/taxonomy.php最終更新 : 2013年08月08日 15:33
関連
お勧め
投稿記事で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」で紹介されており、さまざまな条件指定が追加されていた。