get_tags

（2.3.0以降）
get_tags - タグ情報を取得する

説明

array get_tags( [ mixed $args = '' ] )

条件を指定してタグ情報を検索し、マッチしたすべてのタグ情報を取得する。

$args

検索条件を指定する文字列（または連想配列）。文字列の場合はname=valueの形式で指定し、複数の条件はname1=value1&name2=value2のように'&'の後に続ける。主なキーワードは次の通り。

キーワード	意味
orderby	ソート対象を示すname、countなど。省略時は'name'が適用され、指定しない場合はIDが適用される
order	ソート順を示すASCかDESC（省略時はASC）
hide_empty	投稿数が0のタグ情報を除外する場合はtrue(1)、除外しない場合はfalse(0)を指定（省略時はtrue）
exclude	除外する投稿ID（省略時は''）。複数指定する場合は,で区切る
include	取得したい投稿ID（省略時は''）。複数指定する場合は,で区切る
number	最大件数（省略時は''で制限なし）
fields	取得したいタグ情報のフィールドを示すall、ids、namesなど（省略時は'all'）
slug	タグ情報のスラッグ（省略時は''）
offset	取得開始位置（先頭は0）

条件にマッチしたタグ情報（オブジェクト）を配列に格納して返す。条件にマッチしたタグがない場合は、空の配列を返す。
タグ情報のメンバー変数は次の通り。

プロパティ名	データ型	意味
term_id	int	ID
name	string	名前
slug	string	スラッグ
term_group	int	グループID
term_taxonomy_id	int	タクソノミーID
taxonomy	string	タクソノミー名。タグの場合は必ず'post_tag'となる
description	string	説明。現在は必ず''となる
parent	int	親タグID。現在は必ず0となる
count	int	投稿数

特にありません。

get_terms関数にて投稿タグ情報を取得できた場合、get_tagsフィルターで処理を行いその戻り値を返している（なお投稿タグ情報を取得できなかった場合は、このフィルターは呼ばれない）。

$tags = apply_filters( 'get_tags', $tags, $args );

実行するアクションはありません。

/wp-includes/category.php

最終更新 : 2018年05月27日 10:49

投稿編集ページにはビジュアル編集モードとHTML編集モードがあり、それらを拡張するプラグインも多数存在している。そういったプラグインを利用するのもいいのだが、仕組みを理解するのも悪くないはず。というわけで、ここではHTML編集モードのボタンの仕組みと定型文を挿入するボタンを追加する方法を紹介する。

従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。

新テーマ「Twenty Eleven」のトップページでは、投稿フォーマットに応じて表示を切り替える仕組みが提案されている。ここでは、その投稿フォームの活用方法を簡単に紹介する。

画像をアップロードして「投稿に追加」ボタンをクリックすると、投稿記事内にリンク付きのimgタグか、ショートコードのが挿入される。ここではそれらの書式を整理する。

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。