WordPress に関するドキュメントは 『WordPress Codex 日本語版』へ移動しました。
最新情報はリンク先でお読みください。

テンプレートタグ/get the tags

出典: ps*wiki

< テンプレートタグ
2008年5月4日 (日) 18:32; Bono (会話 | 投稿記録) による版
(差分) ←前の版 | 最新版を表示 (差分) | 次の版→ (差分)

目次

説明

記事に付けられているタグをそれぞれ一つのオブジェクトにし、そのオブジェクトの配列を返します。このタグはループ内で使用しなければなりません。


使い方

このファンクションは何も表示しません。オブジェクトにアクセスし、echo もしくは使いたいメンバ変数を使用します。

以下の例は記事に付けられているタグを表示します (the_tags() を使うのと似ていますが、タグにリンクが無く、コンマの代わりにスペースが使われています) 。

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo $tag->name . ' '; 
}
}
?>

用例

タグのイメージを表示

これは term_id にちなんだファイル名のタグイメージを alt 属性にタグ名を付けて表示します。また、他のメンバ変数を代わりに使うことも出来ます。

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo '<img src="http://example.com/images/' . $tag->term_id . '.jpg" 
alt="' . $tag->name . '" />'; 
}
}
?>

最初のタグだけを表示する

<?php
$tag = get_the_tags(); 
if ($tag) {
$tag = $tag[0]; echo $tag->name;
}
?>

メンバ変数

term_id 
タグのID
name 
タグ名
slug 
タグのスラッグ
term_group 
タグのグループ (もしあれば)
taxonomy 
この場合は常に「post_tag」になります
description 
タグの説明
count 
このタグの総使用回数

変更履歴

  • 2.3 : 新規テンプレートタグ

the_tags, get_the_tags, get_the_tag_list, single_tag_title, is_tag, get_tag_link, wp_tag_cloud, wp_generate_tag_cloud,


原文・最新版: WordPress Codex » Template Tags/get_the_tags最新版との差分

MediaWiki
他の言語