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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(除外・表示タグパラメータ修正、Creating a Tag Archive 節追加。(2007年9月25日 (火) 19:19 Sahaskatta 版より))
(関連タグリスト(フッタ)を差し替え)
81行目: 81行目:
 
:* <code>'count'</code> - 使用数
 
:* <code>'count'</code> - 使用数
 
; order  
 
; order  
: (''文字列'') ソート順。有効値:
+
: (''文字列'') ソート順。有効値(大文字):
 
:* <code>'ASC'</code>  - 昇順(初期値)
 
:* <code>'ASC'</code>  - 昇順(初期値)
 
:* <code>'DESC'</code> - 降順
 
:* <code>'DESC'</code> - 降順
89行目: 89行目:
 
: (''文字列'') 表示対象とするタグの <code>term_id</code> をカンマ区切りで指定。例えば、<code>'include=5,27'</code> とすれば <code>term_id</code> が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。
 
: (''文字列'') 表示対象とするタグの <code>term_id</code> をカンマ区切りで指定。例えば、<code>'include=5,27'</code> とすれば <code>term_id</code> が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。
  
== Creating a Tag Archive ==
+
<div id="Creating_a_Tag Archive">
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.
+
== タグアーカイブの作成 ==
 +
</div>
 +
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#Tag_page|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.  This is a good resource for everything pertaining to [[Templates|templates]].  Basic steps needed are
+
To do this a new template will need to be added to your theme files.  These are good resources for everything pertaining to [[Templates|templates]], [[Template_Hierarchy#Tag_page|Template_Hierarchy]].  Basic steps needed are
  
*1. Create file with the contents below.
+
*1. Create file with the contents below named tag.php.
 
*2. Upload file to your themes directory.
 
*2. Upload file to your themes directory.
*3. Create a new blank page using this template.
+
*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.
 
To elobarate more on step three.
106行目: 110行目:
 
Template Name: Tag Archive
 
Template Name: Tag Archive
 
*/ ?>
 
*/ ?>
<div id="content">
+
<div>
<h2>Tag Archive</h2>
+
 
<?php get_header(); ?>
 
<?php get_header(); ?>
 +
<h2>Tag Archive</h2>
 
<?php wp_tag_cloud(''); ?>
 
<?php wp_tag_cloud(''); ?>
 
<div class="navigation">
 
<div class="navigation">
116行目: 120行目:
 
<?php if (have_posts()) : ?>
 
<?php if (have_posts()) : ?>
 
<?php while (have_posts()) : the_post(); ?>
 
<?php while (have_posts()) : the_post(); ?>
<h2 class="posttitle"><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2>
+
<h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2>
 
<div class="entry">
 
<div class="entry">
 
<?php the_content('Read the rest of this entry &raquo;'); ?>
 
<?php the_content('Read the rest of this entry &raquo;'); ?>
129行目: 133行目:
 
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.
  
{{原文|Template Tags/wp_tag_cloud}}
+
<div id="Related">
 
+
== 関連 ==
== Related ==
+
</div>
{{Tag Category Tags}}
+
{{Tag Tag Tags}}
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
 +
 +
{{原文|Template Tags/wp_tag_cloud}}
  
 
{{DEFAULTSORT:wp_tag_cloud}}
 
{{DEFAULTSORT:wp_tag_cloud}}

2007年10月14日 (日) 03:48時点における版

テンプレート:stub

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' => '');

デフォルトのまま使うと、次のように表示します。

  • smallest - 最少数のタグを表示するフォントサイズを 8 (point) とする
  • largest - 最多数のタグを表示するフォントサイズを 22 (point) とする
  • 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>
<ul>
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</ul>
</li>
<?php endif; ?>

(前後を ul で括るなら format=list かも?)

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

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

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

パラメータ

smallest
整数) 最少使用数のタグの表示に使うフォントサイズ。初期値は 8。
largest
整数) 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
unit
文字列smallestlargestの値の単位。初期値は point の pt
number
整数) クラウドに表示するタグ数。初期値は 45。'0' を指定すると全タグを表示。
format
文字列) クラウド表示のフォーマット
  • 'flat' (初期値) タグをホワイトスペースで区切る
  • 'list' タグを class='wp-tag-cloud' 付きの ul(番号なし箇条書き)内に表示
  • 'array' tags are in an 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.

タグ: 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