【Wordpress関数】get_tags()(タグ情報を一覧(配列)で取得)

[公開] 2024-07-16 / [更新] 2024-08-16

タグの情報を一覧(配列)で取得する、タグ一覧用のWordpressテンプレートタグ。
パラメータで条件を設定したり、戻り値で様々な要素を指定できます。

get_tags() 呼び出しコード

呼び出しコード	説明
`<?php $cats = get_tags(); ?>`	パラメータなし
`<?php $cats = get_tags('number=5&exclude=1'); ?>`	直接指定 = パラメータが少ない場合など
`<?php $args = array( 'orderby' => 'count', 'order' => 'DESC', 'number' => 5 ); $cats = get_tags( $args ); ?>`	引数を代入 = パラメータが多い場合など

get_tags() パラメータ

パラメータ	初期値	設定できる値	説明
`slug`	”	スラッグを指定	指定スラッグで取得
`orderby`	name	count、name、slug、term_group、id	ソート対象
`order`	ASC	ASC(昇順)、DESC(降順)	ソート順
`number`	”	取得件数	省略時は条件に一致するすべてを取得
`hide_empty`	1	1 (表示しない)、0 (表示する)	投稿のないタグ
`include`	”	タグID /複数時 `,` 区切り	指定タグのみ
`exclude`	”	タグID /複数時 `,` 区切り	取得しないタグ

主要なパラメータのみを記載 / 他のパラメータはGoogle様でm(__)m

get_tags() 戻り値

変数名	型	内容
`term_id`	int	タグID
`name`	string	タグ名
`slug`	string	タグスラッグ
`count`	int	記事数
`description`	string	タグ説明

エイリアスは記載していません。

get_tags() の使用例

<span>で囲む

PHP

<?php
  $tags = get_tags();
  foreach ($tags as $tag) { 
?>
  <span><a href="<?php echo get_tag_link($tag->term_id); ?>"><?php echo $tag->name; ?></a></span>
<?php } ?>