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_idintID
namestring名前
slugstringスラッグ
term_groupintグループID
term_taxonomy_idintタクソノミーID
taxonomystringタクソノミー名。タグの場合は必ず'post_tag'となる
descriptionstring説明。現在は必ず''となる
parentint親タグID。現在は必ず0となる
countint投稿数

注意

特にありません。

使用例

  • すべてのタグ情報を取得する。
    <?php $tags = get_tags(); ?>

フィルター

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

アクション

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

ソースファイル

/wp-includes/category.php

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

関連

参考

Code Reference: get_tags

お勧め

ログアウト後はいつもサイトトップ（2018年5月27日 更新）

ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。

さくらのVPSでKUSANAGI#3（2018年5月27日 更新）

今回は「前回」の続き。http（80番）をクローズ、そのほかに行った調整作業について整理する。

oEmbed対応サイトを整理した（2017年11月18日 更新）

投稿記事にTwitterやYouTubeのURL（アドレス）を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み（機能）はoEmbedというもので、対応サイトは随時バージョンアップしている。

投稿内容に応じてwpautopを制御する（2013年8月13日 更新）

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

Login rebuilder：プラグイン作ってみました（2019年9月7日 更新）

昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。