wp_set_post_terms:WordPress私的マニュアル

wp_set_post_terms

(2.8.0以降)
wp_set_post_terms - 投稿情報に投稿タグを設定する

説明

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

参考

Code Reference: wp_set_post_terms

お勧めコンテンツ

32ピクセルのサイトアイコンを別の画像ファイルに変更する（2015年8月27日登録）

「サイトアイコン」は4.3の新機能の1つ。管理画面で適当な画像ファイルを指定するだけでサイトアイコンが適用されます。そんなサイトアイコンで、既存の favicon.ico を併用する方法を紹介します。

headタグのmeta（generator）タグを取り除く（2011年2月18日登録）

標準的なWordPressのテーマで出力されるHTMLには、headタグ内に次のようなmetaタグが出力されている。

<meta name="generator" content="WordPress 3.0.5" />

3.6リリース直前チェック（2013年7月26日登録）

$wpdbは、WordPressのデータベースにアクセスする際に使用できる便利なオブジェクト。独自テーブルの利用やデータ検索の最適化など、標準提供される関数では実現できないことを手助けしてくれる。そんな$wpdbのescapeメソッドが3.6で非推奨（deprecated）になる。

購読者は管理者ページのアクセス禁止（2013年11月12日登録）

購読者（subscriber）は、通常「ダッシュボード」「プロフィール」にアクセスできるが、今回はプロフィールを独自に管理する準備を兼ねて、これらのページにアクセスできないようにブロックしてみた。

検索ワード「-10,000円」を検索できるようにしたい（2017年7月20日登録）

とあるサイトで「-10,000円」をキーワードに検索した際、予想と異なるページが表示され、ちょっと驚いた。今回はその原因調査と対策についてまとめてみた。