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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/wp_tag_cloud 2007年8月31日 (金) 15:01 MichaelH 版)
 
(和訳・補足/'array' フォーマットを要確認)
1行目: 1行目:
 
{{stub}}
 
{{stub}}
 
-----
 
-----
<p style="color:#c00;">'''Note: This function is only available in WordPress 2.3 or newer.'''</p>
+
<p class="important">'''注: このタグは WordPress 2.3 以上でのみ使えます。'''</p>
 
-----
 
-----
  
== Description ==
+
<div id="Description">
This template tag becomes available with WordPress Version 2.3. [[Template_Tags/wp_tag_cloud|wp_tag_cloud]] displays a list of tags in what is called a 'tag cloud', where the size of each tag is determined by how many times that particular tag has been assigned to posts.
+
== 説明 ==
 +
</div>
 +
このテンプレートタグは、WordPress '''バージョン 2.3''' から使えるようになる予定です。[[テンプレートタグ/wp_tag_cloud|wp_tag_cloud]] は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「タグクラウド」というタグの一覧を表示します。
  
== Usage ==
+
<div id="Usage">
%%% <?php wp_tag_cloud(’’); ?> %%%
+
== 使い方 ==
 +
</div>
 +
<?php wp_tag_cloud('引数'); ?>
  
== Examples ==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
===Default Usage===
+
<div id="Default_Usage">
$defaults = array('smallest' => 8, 'largest' => 22,
+
=== デフォルトでの使用 ===
  'unit' => 'pt', 'number' => 45, 'format' => 'flat',  
+
</div>
  'orderby' => 'name', 'order' => 'ASC','exclude' => '', 'include' => '');
+
<pre>
 +
$defaults = array('smallest' => 8, 'largest' => 22,
 +
  'unit' => 'pt', 'number' => 45, 'format' => 'flat',  
 +
  'orderby' => 'name', 'order' => 'ASC', 'exclude' => '', 'include' => '');
 +
</pre>
 +
 
 +
デフォルトのまま使うと、次のように表示します。
 +
* ''smallest'' - 最少数のタグを表示するフォントサイズを 8 (point) とする
 +
* ''largest'' -  最多数のタグを表示するフォントサイズを 22 (point) とする
 +
* ''unit'' - 最少・最多値のフォントサイズの単位として 'pt' (point) を使用
 +
* ''number'' - 最大 45 タグを表示
 +
* ''format'' - flat(ホワイトスペース区切り)形式でタグを表示
 +
* ''orderby'' - タグ名順に表示
 +
* ''order'' - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)
 +
* ''exclude'' - 除外タグなし
 +
* ''include'' - 全タグ対象
  
By default, the usage shows:
+
  <?php wp_tag_cloud(); ?>
* ''smallest'' - Use 8 point font-size when displaying the tag with lowest count value
+
* ''largest'' - Use 22 point font-size when displaying the tag with highest count value
+
* ''unit'' - Describes 'pt' (point) as the font-size unit for the smallest and largest values
+
* ''number'' - Display at most 45 tags
+
* ''format'' - Displays the tags in flat (separated by whitespace) style
+
* ''orderby'' - Order the tags by name
+
* ''order'' - Sort the tags in ASCENDING fashion
+
* ''exclude'' - Exclude no tags
+
* ''include'' - Include all tags
+
  
===Cloud displayed under Popluar Tags title===
+
<div id="Cloud_displayed_under_Popluar_Tags_title">
 +
=== タイトル「Popluar Tags」の下にタグクラウドを表示 ===
 +
</div>
 
<pre>
 
<pre>
 
<?php if ( function_exists('wp_tag_cloud') ) : ?>
 
<?php if ( function_exists('wp_tag_cloud') ) : ?>
39行目: 53行目:
 
<?php endif; ?>
 
<?php endif; ?>
 
</pre>
 
</pre>
 +
(前後を <code>ul</code> で括るなら <code>format=list</code> かも?)
  
===Cloud limited in size and ordered by count rather than name===
+
全体が <code><nowiki><li></nowiki></code> で括られているのは、デフォルトテーマなどのサイドバー用の形式。サイドバー全体が番号なし箇条書きの入れ子でできている([[サイドバーのカスタマイズ]]/[[:en:Customizing Your Sidebar|en]] 参照)。
 +
 
 +
<div id="Cloud_limited_in_size_and_ordered_by_count_rather_than_name">
 +
===サイズ指定、タグ名ではなく使用数順のタグクラウド===
 +
</div>
 
  <?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>
 
  <?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>
  
== Parameters ==
+
<div id="Parameters">
; smallest : (''integer'') The unit (font) size to use when displaying the tag with the smallest count value.
+
== パラメータ ==
; largest : (''integer'') The unit (font) size to use when displaying the tag with the highest count value..
+
</div>
; unit : (''string'') Unit of measure as pertains to the '''smallest''' and '''largest''' values.  Use '''pt''' for point.
+
; smallest  
; number : (''integer'') The number of actual tags to display in the cloud.
+
: ''整数'') 最少使用数のタグの表示に使うフォントサイズ。初期値は 8。
; format : (''string'') Format of the cloud display.
+
; largest  
:* <tt>'flat'</tt> (Default) tags are separated by whitespace
+
: ''整数'') 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
:* <tt>'list'</tt> tags are in UL with a class='wp-tag-cloud'
+
; unit  
:* <tt>'array'</tt> tags are in an array
+
: ''文字列'''''smallest''''''largest'''の値の単位。初期値は point の '''pt'''
; orderby : (''string'') Order of the tags. Valid values:
+
; number  
:* <tt>'name'</tt> (Default)
+
: ''整数'') クラウドに表示するタグ数。初期値は 45。
:* <tt>'count'</tt>
+
; format  
; order : (''string'') Sort order. Valid values:
+
: ''文字列'') クラウド表示のフォーマット
:* <tt>'ASC'</tt> (Default)
+
:* <code>'flat'</code> (初期値) タグをホワイトスペースで区切る
:* <tt>'DESC'</tt>
+
:* <code>'list'</code> タグを <code>class='wp-tag-cloud'</code> 付きの <code>ul</code>(番号なし箇条書き)内に表示
; exclude : (''string'') Comma separated list of tags to exclude. For example, 'exclude=ship,navy' means tags ship and navy will NOT be displayed. Defaults to exclude nothing.
+
:* <code>'array'</code> tags are in an array(タグを配列に格納?配置の形を指しているのか未確認)
; include : (''string'') Comma separated list of tags to include. For example, 'include=ship,navy' means tags, ship and nave, will be the only tags displayed. Defaults to include everything.
+
; orderby  
 +
: ''文字列'') タグの表示順とする項目。有効値:
 +
:* <code>'name'</code> - タグ名(初期値)
 +
:* <code>'count'</code> - 使用数
 +
; order  
 +
: ''文字列'') ソート順。有効値:
 +
:* <code>'ASC'</code> - 昇順(初期値)
 +
:* <code>'DESC'</code> - 降順
 +
; exclude  
 +
: ''文字列'') 除外するタグをカンマ区切りで指定。例えば、<code>'exclude=ship,navy'</code> とすれば ship navy タグは表示されない。デフォルトでは除外なし。
 +
; include  
 +
: ''文字列'') 表示対象とするタグをカンマ区切りで指定。例えば、<code>'include=ship,navy'</code> とすれば ship と navy タグのみを表示。デフォルトでは全てのタグが対象。
  
== Related ==
+
{{原文|Template Tags/wp_tag_cloud}}
  
 +
== Related ==
  
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
[[Category:New page created]]
+
{{DEFAULTSORT:wp_tag_cloud}}
 +
[[Category:wp2.3]]
  
 
[[en:Template Tags/wp_tag_cloud]]
 
[[en:Template Tags/wp_tag_cloud]]

2007年9月5日 (水) 21:00時点における版

テンプレート:stub


注: このタグは WordPress 2.3 以上でのみ使えます。


このテンプレートタグは、WordPress バージョン 2.3 から使えるようになる予定です。wp_tag_cloud は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「タグクラウド」というタグの一覧を表示します。

使い方

<?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。
format
文字列) クラウド表示のフォーマット
  • 'flat' (初期値) タグをホワイトスペースで区切る
  • 'list' タグを class='wp-tag-cloud' 付きの ul(番号なし箇条書き)内に表示
  • 'array' tags are in an array(タグを配列に格納?配置の形を指しているのか未確認)
orderby
文字列) タグの表示順とする項目。有効値:
  • 'name' - タグ名(初期値)
  • 'count' - 使用数
order
文字列) ソート順。有効値:
  • 'ASC' - 昇順(初期値)
  • 'DESC' - 降順
exclude
文字列) 除外するタグをカンマ区切りで指定。例えば、'exclude=ship,navy' とすれば ship と navy タグは表示されない。デフォルトでは除外なし。
include
文字列) 表示対象とするタグをカンマ区切りで指定。例えば、'include=ship,navy' とすれば ship と navy タグのみを表示。デフォルトでは全てのタグが対象。

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

Related

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