• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「テンプレートタグ/wp tag cloud」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連タグリスト(フッタ)を差し替え)
(誤記修正・表現微調整)
1行目: 1行目:
{{stub}}
 
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
17行目: 16行目:
  
 
<div id="Default_Usage">
 
<div id="Default_Usage">
=== デフォルトでの使用 ===
+
=== 初期設定での使用 ===
 
</div>
 
</div>
 
<pre>
 
<pre>
25行目: 24行目:
 
</pre>
 
</pre>
  
デフォルトのまま使うと、次のように表示します。
+
デフォルトでは次のように表示します。各タグの文字サイズは、付けられた記事数に応じて ''smallest''~''largest'' の間で段階的に変化します。
* ''smallest'' - 最少数のタグを表示するフォントサイズを 8 (point) とする
+
* ''smallest'' - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
* ''largest'' -  最多数のタグを表示するフォントサイズを 22 (point) とする
+
* ''largest'' -  一番大きいタグを 22(pt) で表示(件数が多いタグ)
 
* ''unit'' - 最少・最多値のフォントサイズの単位として 'pt' (point) を使用
 
* ''unit'' - 最少・最多値のフォントサイズの単位として 'pt' (point) を使用
 
* ''number'' - 最大 45 タグを表示
 
* ''number'' - 最大 45 タグを表示
43行目: 42行目:
 
<pre>
 
<pre>
 
<?php if ( function_exists('wp_tag_cloud') ) : ?>
 
<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li>
+
<li><h2>Popular Tags</h2>
<h2>Popular Tags</h2>
+
<ul>
+
 
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
 
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</ul>
 
 
</li>
 
</li>
 
<?php endif; ?>
 
<?php endif; ?>
 
</pre>
 
</pre>
(前後を <code>ul</code> で括るなら <code>format=list</code> かも?)
+
<!-- <ul> は不要なので削除。上のとおりなら <ul> は不要、format=list にしても <ul> 込みで出力されるため。  -->
 
+
注: 全体が <code><nowiki><li>~</li></nowiki></code> で括られているのは、デフォルトテーマなどのサイドバー用の形式です。サイドバー全体が番号なし箇条書きの入れ子になっています([[サイドバーのカスタマイズ]]/[[:en:Customizing Your Sidebar|en]] 参照)。
全体が <code><nowiki><li></nowiki></code> で括られているのは、デフォルトテーマなどのサイドバー用の形式。サイドバー全体が番号なし箇条書きの入れ子でできている([[サイドバーのカスタマイズ]]/[[:en:Customizing Your Sidebar|en]] 参照)。
+
  
 
<div id="Cloud_limited_in_size_and_ordered_by_count_rather_than_name">
 
<div id="Cloud_limited_in_size_and_ordered_by_count_rather_than_name">
68行目: 63行目:
 
: (''整数'') 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
 
: (''整数'') 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
 
; unit  
 
; unit  
: (''文字列'') '''smallest'''・'''largest'''の値の単位。初期値は point の '''pt'''。
+
: (''文字列'') '''smallest'''・'''largest''' の値の単位。<code>pt, px, em, %</code> 等、CSS でフォントサイズに用いる単位を指定可能。初期値は point の '''pt'''。
 
; number  
 
; number  
 
: (''整数'') クラウドに表示するタグ数。初期値は 45。<code>'0'</code> を指定すると全タグを表示。
 
: (''整数'') クラウドに表示するタグ数。初期値は 45。<code>'0'</code> を指定すると全タグを表示。
75行目: 70行目:
 
:* <code>'flat'</code> (初期値) タグをホワイトスペースで区切る
 
:* <code>'flat'</code> (初期値) タグをホワイトスペースで区切る
 
:* <code>'list'</code> タグを <code>class='wp-tag-cloud'</code> 付きの <code>ul</code>(番号なし箇条書き)内に表示
 
:* <code>'list'</code> タグを <code>class='wp-tag-cloud'</code> 付きの <code>ul</code>(番号なし箇条書き)内に表示
:* <code>'array'</code> tags are in an array(タグを配列に格納?配置の形を指しているのか未確認)
+
:* <code>'array'</code> タグを配列に格納
 
; orderby  
 
; orderby  
 
: (''文字列'') タグの表示順とする項目。有効値:
 
: (''文字列'') タグの表示順とする項目。有効値:
132行目: 127行目:
  
 
Please Note that styling has not been added to this template.  A good way to determine the structure that your theme uses is to view the single.php theme file.
 
Please Note that styling has not been added to this template.  A good way to determine the structure that your theme uses is to view the single.php theme file.
 +
 +
== 変更履歴 ==
 +
 +
* [[Version 2.3|2.3]] : 新規テンプレートタグ
  
 
<div id="Related">
 
<div id="Related">
143行目: 142行目:
 
{{DEFAULTSORT:wp_tag_cloud}}
 
{{DEFAULTSORT:wp_tag_cloud}}
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
 +
[[Category:wp2.5]]
  
 
[[en:Template Tags/wp_tag_cloud]]
 
[[en:Template Tags/wp_tag_cloud]]
 
[[fr:Marqueurs de Tags/wp_tag_cloud]]
 
[[fr:Marqueurs de Tags/wp_tag_cloud]]

2008年3月12日 (水) 00:27時点における版

wp_tag_cloud は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「タグクラウド」というタグの一覧を表示します。

注: このタグは WordPress バージョン 2.3 以上でのみ使えます。

使い方

<?php wp_tag_cloud('引数'); ?>

用例

初期設定での使用

$defaults = array('smallest' => 8, 'largest' => 22,
  'unit' => 'pt', 'number' => 45, 'format' => 'flat', 
  'orderby' => 'name', 'order' => 'ASC', 'exclude' => '', 'include' => '');

デフォルトでは次のように表示します。各タグの文字サイズは、付けられた記事数に応じて smallestlargest の間で段階的に変化します。

  • smallest - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
  • largest - 一番大きいタグを 22(pt) で表示(件数が多いタグ)
  • unit - 最少・最多値のフォントサイズの単位として 'pt' (point) を使用
  • number - 最大 45 タグを表示
  • format - flat(ホワイトスペース区切り)形式でタグを表示
  • orderby - タグ名順に表示
  • order - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)
  • exclude - 除外タグなし
  • include - 全タグ対象
<?php wp_tag_cloud(); ?>

タイトル「Popluar Tags」の下にタグクラウドを表示

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li><h2>Popular Tags</h2>
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</li>
<?php endif; ?>

注: 全体が <li>~</li> で括られているのは、デフォルトテーマなどのサイドバー用の形式です。サイドバー全体が番号なし箇条書きの入れ子になっています(サイドバーのカスタマイズ/en 参照)。

サイズ指定、タグ名ではなく使用数順のタグクラウド

<?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>

パラメータ

smallest
整数) 最少使用数のタグの表示に使うフォントサイズ。初期値は 8。
largest
整数) 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
unit
文字列smallestlargest の値の単位。pt, px, em, % 等、CSS でフォントサイズに用いる単位を指定可能。初期値は point の pt
number
整数) クラウドに表示するタグ数。初期値は 45。'0' を指定すると全タグを表示。
format
文字列) クラウド表示のフォーマット
  • 'flat' (初期値) タグをホワイトスペースで区切る
  • 'list' タグを class='wp-tag-cloud' 付きの ul(番号なし箇条書き)内に表示
  • 'array' タグを配列に格納
orderby
文字列) タグの表示順とする項目。有効値:
  • 'name' - タグ名(初期値)
  • 'count' - 使用数
order
文字列) ソート順。有効値(大文字):
  • 'ASC' - 昇順(初期値)
  • 'DESC' - 降順
exclude
文字列) 除外するタグの term_id をカンマ区切りで指定。例えば、'exclude=5,27' とすれば term_id が 5 と 27 のタグは表示されない。デフォルトでは除外なし。
include
文字列) 表示対象とするタグの term_id をカンマ区切りで指定。例えば、'include=5,27' とすれば term_id が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。

タグアーカイブの作成

While the new tagging feature in 2.3 is a great addition, the wp_tag_cloud tag can be used to display a Tag Archive. What this means is that when a visitor clicks on any particular tag a page displaying the tag cloud and all posts tagged the same will be displayed. According to the Template_Hierarchy if a tag.php template does not exist then the archives.php template will be used. By making this tag.php template you can customize the way your Tag Archive will look, this template includes the tag cloud at the top for very easy navigation.


To do this a new template will need to be added to your theme files. These are good resources for everything pertaining to templates, Template_Hierarchy. Basic steps needed are

  • 1. Create file with the contents below named tag.php.
  • 2. Upload file to your themes directory.
  • 3. This is optional only if you would like to have a link in your page navigation to the Tag archive, otherwise when clicking on a tag this template will be used.
    • Create a new blank page using this template, give this page the title Tag Archive.

To elobarate more on step three.

WordPress can be configured to use different Page Templates for different Pages. Toward the bottom of the Write->Write Page administration panel (or on the sidebar, depending on which version of WordPress you are using) is a drop-down labeled "Page Template". From there you can select which Template will be used when displaying this particular Page.

<?php /*
Template Name: Tag Archive
*/ ?>
<div>
<?php get_header(); ?>
<h2>Tag Archive</h2>
<?php wp_tag_cloud(''); ?>
	<div class="navigation">
<div class="alignleft"><?php next_posts_link('« Older Entries') ?></div>
<div class="alignright"><?php previous_posts_link('Newer Entries »') ?></div>
	</div>
<?php if (have_posts()) : ?>
		<?php while (have_posts()) : the_post(); ?>
		<h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2>
	<div class="entry">
	<?php the_content('Read the rest of this entry »'); ?>
	</div>

	<?php endwhile; ?>
	<?php endif; ?>
</div>
<?php get_footer(); ?>

Please Note that styling has not been added to this template. A good way to determine the structure that your theme uses is to view the single.php theme file.

変更履歴

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

タグ: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud()


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Template Tags/wp_tag_cloud