説明
mixed wp_set_post_terms( [ int $post_id = 0 [ , mixed $tags = '' [ , string $taxonomy = 'post_tag' [ , bool $append = false ] ] ] ] )
投稿情報に投稿タグを設定する。
パラメータ
- $post_id投稿情報のIDを指定（省略時は0）。
- $tags投稿タグ（ターム）の文字列を指定（省略時は''）。複数指定する場合はカンマ（,）で区切るか、その配列を指定する。
- $taxonomyタクソノミータイプを指定（省略時は'post_tag'）。
- $append投稿タグを追加する場合はtrue、設定する場合はfalseを指定（省略時はfalse）。
返り値
投稿タグを更新した場合は、それらのタームIDの配列を返す。更新できなかった場合はfalseまたは WP_Errorのオブジェクトを返す。注意
パラメータ$taxonomyに'post_tag'以外を指定することで、任意のカスタムタクソノミーに対応できると思われる。パラメータ$tagsに複数のタクソノミーを追加する場合はカンマ（,）などで囲む。内部では$tagsをカンマ区切りで分割するが、分割を行う前段階として前後の空白文字とカンマは除外している。
使用例
- IDが10の投稿情報に投稿タグ'Ultrabook'と'値下げ'を設定する。<?php wp_set_post_tags( 10, 'Ultrabook,値下げ' ); ?>
- IDが10の投稿情報に投稿タグ'Ultrabook'を追加する。<?php wp_set_post_tags( 10, 'Ultrabook', 'post_tag', true ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/post.php最終更新 : 2014年07月04日 11:39
関連
お勧め
wp_titleからwp_get_document_titleへ（2018年5月27日 更新）
先週、WordPress 4.4 beta1（以降4.4 beta1）が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。
ツイート引用が簡単になる仕組み（2012年6月8日 更新）
WordPress 3.4では、投稿記事の中にツイートのURLを記述するだけで、投稿ページにそれっぽい表示をしてくれるようになる。ちょっと気になったので、その仕組みを追っかけてみた。5.5の機能強化：テーマ変更時に要求バージョンを確認（2020年8月12日 更新）
WordPress 5.5 RC 2が公開され、来週には正式版がリリース。変更箇所が多い「WordPress 5.5 RC 2（以降RC 2）」のソースコードを眺めていると、テーマの切り替え前にWordPressとPHPのバージョンを確認するようになっていた。
サイトヘルス機能を使ってみた（2019年4月12日 更新）
先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2（以降5.2Beta2）が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。
ブロックエディターで編集したページが出力した余分な改行を削除（2019年2月22日 更新）
ブロックエディターで編集したページのHTMLソースは、投稿本文部分の改行が目立った。Webページとしての表示は問題ないのだが、データとしては不要なので削除することにした。