get_tags()

WordPressのget_tags()関数は、投稿に関連付けられたタグを取得するために使用されます。この関数は、タグの情報を配列として返します。

構文

get_tags( array|string $args = '' );

• $args(array|string) — タグを取得するためのオプションを指定します。デフォルトは空の文字列です。

例1: 基本的なタグの取得

この例では、現在の投稿に関連付けられたすべてのタグを取得します。

<?php $tags = get_tags(); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->name . ' '; endforeach; endif; ?>

例2: 特定の投稿のタグを取得

この例では、特定の投稿IDに関連付けられたタグを取得します。

<?php $tags = get_tags( array( 'post_id' => get_the_ID() ) ); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->name . ' '; endforeach; endif; ?>

例3: タグの数を制限する

この例では、取得するタグの数を5つに制限します。

<?php $tags = get_tags( array( 'number' => 5 ) ); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->name . ' '; endforeach; endif; ?>

例4: タグを名前順に並べ替える

この例では、タグを名前順に並べ替えて取得します。

<?php $tags = get_tags( array( 'orderby' => 'name', 'order' => 'ASC' ) ); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->name . ' '; endforeach; endif; ?>

例5: 特定のタグIDのタグを取得

この例では、特定のタグIDのタグを取得します。

<?php $tags = get_tags( array( 'include' => array( 1, 2, 3 ) ) ); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->name . ' '; endforeach; endif; ?>

例6: タグのスラッグを取得

この例では、タグのスラッグを取得します。

<?php $tags = get_tags(); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->slug . ' '; endforeach; endif; ?>

例7: タグの説明を取得

この例では、タグの説明を取得します。

<?php $tags = get_tags(); if ( $tags ) : foreach ( $tags as $tag ) : echo $tag->description . ' '; endforeach; endif; ?>

例8: タグのリンクを表示

この例では、タグのリンクを表示します。

<?php $tags = get_tags(); if ( $tags ) : foreach ( $tags as $tag ) : echo '<a href="' . get_tag_link( $tag->term_id ) . '">' . $tag->name . '</a> '; endforeach; endif; ?>

注意点

• get_tags()関数は、タグが存在しない場合に空の配列を返します。
• タグの情報を取得する際に、大量のタグがある場合はパフォーマンスに影響を与える可能性があります。