WordPressの関数を少しずつまとめていきます。
今回は、タグの情報を出力する関数「the_tags」です。
～ 目次 ～
- 基本的な使い方
- the_tags()関数の応用：パラメータの指定
基本的な使い方
タグの情報を出力する関数です。
WordPressループ内でのみ使用します。
- パラメータ
- (1)前文字列、(2)区切り文字、(3)後文字列
- 戻り値
- 無し
- 利用箇所
- WordPressループ内
通常はパラメータを指定せずに以下のように書きます。
<?php the_tags(); ?>
以下のように出力されます（タグが２つある場合）。
「タグ:」の後ろに、個々のタグがコンマで区切られ、リンク付きで出力されます。
タグ: <a href="タグアーカイブページのURL" rel="tag">タグ1</a>, <a href="タグアーカイブページのURL" rel="tag">タグ2</a>
なお、投稿記事にタグが付いてない場合は出力されません。
例
基本的なWordPressループ内での使い方
<?php if (have_posts()): ?> <?php while (have_posts()) : the_post(); ?> 個々の投稿を出力する処理 <?php the_tags(); ?> <?php endwhile; ?> 投稿一覧を出力した後に行う処理 <?php else: ?> 投稿が無い時の処理 <?php endif; ?>
the_tags()関数の応用：パラメータの指定
パラメータを指定することにより、タグの前後と、タグとタグの間に任意の文字列を出力することが可能です。
例1
タグとタグをコンマで区切った後、改行する
<?php the_tags( 'この投稿のタグ：', ', ', '<br>' ); ?>
出力例
この投稿のタグ：<a href="タグアーカイブページのURL" rel="tag">タグ1</a>, <a href="タグアーカイブページのURL" rel="tag">タグ2</a><br>
例2
ul要素で出力する
<?php the_tags( '<ul><li>', '</li><li>', '</li></ul>' ); ?>
出力例
<ul> <li><a href="タグアーカイブページのURL" rel="tag">タグ</a></li> <li><a href="タグアーカイブページのURL" rel="tag">タグ２</a></li> </ul>
制作のご依頼を受け付けています
星月WEBデザインでは
ホームページ（WEBサイト）・バナー画像等の制作依頼を受け付けています。
遠隔地の方は、クラウドソーシングのランサーズからお申し込みください。
