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

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

関数リファレンス/wp set post tags

提供: WordPress Codex 日本語版
< 関数リファレンス
2014年8月17日 (日) 23:08時点におけるGblsm (トーク | 投稿記録)による版 (en:Function Reference/wp_set_post_tags 19:09, 1 March 2014 Souri 版を和訳。)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

投稿にタグを付けます。存在しないタグはどれも自動的に作成されます。 内部で wp_set_post_terms() を使用します。

使い方

<?php wp_set_post_tags( $post_ID, $tags, $append ) ?>

パラメータ

$post_ID
整数) (必須) 投稿 ID
初期値: 0
$tags
文字列|配列) (オプション) タグのリスト。配列またはコンマ区切りの文字列。
初期値: array
$append
真偽値) (オプション) true にするとタグが投稿に追加される。false にすると既に付いているタグを置き換える。
初期値: false

戻り値

(真偽値|mixed)
投稿に付けられたタグの ID の配列を返す。失敗すると WP_Error または false を返す。

用例

ID が 42 の投稿に付いている現在のタグに meaninglife というタグを追加するには:

wp_set_post_tags( 42, 'meaning,life', true );


参考

フック

変更履歴

バージョン 2.3.0 から導入されました。

ソースファイル

wp_set_post_tags()wp-includes/post.php にあります。

wp_insert_term(), wp_delete_term(), wp_set_post_terms(), wp_set_object_terms()

タグ: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud()


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


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