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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/wp_generate_tag_cloud 16:09, 30 November 2013 Mistercat 版を反映の上、誤記訂正。)
31行目: 31行目:
 
* ''smallest'' - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
 
* ''smallest'' - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
 
* ''largest'' -  一番大きいタグを 22(pt) で表示(件数が多いタグ)
 
* ''largest'' -  一番大きいタグを 22(pt) で表示(件数が多いタグ)
* ''unit'' - 最少・最多値のフォントサイズの単位として 'pt' (ポイント) を使用。
+
* ''unit'' - ''smallest'' と ''largest'' のフォントサイズの単位として 'pt' (ポイント) を使用。
* ''number'' - 最大 0 タグを表示
+
* ''number'' - すべてのタグを表示。
* ''format'' - flat形式でタグを表示。
+
* ''format'' - flat 形式でタグを表示。
 
* ''separator'' - ホワイトスペース区切りでタグを表示。
 
* ''separator'' - ホワイトスペース区切りでタグを表示。
 
* ''orderby'' - タグ名順に表示
 
* ''orderby'' - タグ名順に表示
 
* ''order'' - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)。
 
* ''order'' - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)。
* ''topic_count_text_callback'' - タグ数の表示形式を default_topic_count_text ファンクションで指定。
+
* ''topic_count_text_callback'' - タグ数の表示形式を default_topic_count_text 関数で指定。
* ''topic_count_scale_callback'' - タグの表示スケールを default_topic_count_scale ファンクションで指定。
+
* ''topic_count_scale_callback'' - タグの表示スケールを default_topic_count_scale 関数で指定。
 
* ''filter'' - 最後に wp_generate_tag_cloud フィルタが実行されます。
 
* ''filter'' - 最後に wp_generate_tag_cloud フィルタが実行されます。
  
45行目: 45行目:
 
</div>
 
</div>
  
{{Parameter|$tags|tagオブジェクトの配列|タグクラウドを作るためのタグ情報の配列。id, link, name のプロパティを持つこと。配列のキーが id の場合は id プロパティは不要。}}
+
{{Parameter|$tags|配列|タグクラウドを作るためのタグ情報の配列。配列の要素はタグオブジェクトとし、id, link, name のプロパティを持つこと。配列のキーが id の場合は id プロパティは不要。}}
 +
 
 
{{Parameter|smallest|整数|一番小さい(件数が少ない)タグの表示サイズを <tt>unit</tt> 単位で指定。|オプション|8}}
 
{{Parameter|smallest|整数|一番小さい(件数が少ない)タグの表示サイズを <tt>unit</tt> 単位で指定。|オプション|8}}
 +
 
{{Parameter|largest|整数|一番大きい(件数が少ない)タグの表示サイズを <tt>unit</tt> 単位で指定。|オプション|22}}
 
{{Parameter|largest|整数|一番大きい(件数が少ない)タグの表示サイズを <tt>unit</tt> 単位で指定。|オプション|22}}
{{Parameter|largest|文字列|フォントサイズの単位を指定。CSS の font-size プロパティで指定可能な単位が使える。
+
 
 +
{{Parameter|unit|文字列|フォントサイズの単位を指定。CSS の <code>font-size</code> プロパティで指定可能な単位が使える。|オプション|<tt>pt</tt>}}
 
:* <tt>pt</tt> (ポイント)
 
:* <tt>pt</tt> (ポイント)
 
:* <tt>px</tt> (ピクセル)
 
:* <tt>px</tt> (ピクセル)
 
:* <tt>em</tt> (現在のフォントのサイズを1とした比率)
 
:* <tt>em</tt> (現在のフォントのサイズを1とした比率)
 
:* <tt>%</tt> (現在のフォントのサイズを100とした比率)  
 
:* <tt>%</tt> (現在のフォントのサイズを100とした比率)  
|オプション|pt}}
+
 
 
{{Parameter|number|整数|表示するタグの個数。0 ならすべて表示する|オプション|0}}
 
{{Parameter|number|整数|表示するタグの個数。0 ならすべて表示する|オプション|0}}
{{Parameter|format|文字列|タグクラウドの戻り値の形式を指定する。
+
 
:* <tt>array</tt> (タグを <a></a> で囲んだ文字列の配列)
+
{{Parameter|format|文字列|タグクラウドの戻り値の形式を指定する。|オプション|<code>flat</code>}}
:* <tt>list</tt> (タグを <li><a></a></li> で囲み、<ul class='wp-tag-cloud'></ul> のリストにした文字列)
+
:* <tt>array</tt> (タグを <code><nowiki><a></a></nowiki></code> で囲んだ文字列の配列)
:* <tt>flat</tt> (タグを <a></a> で囲み <tt>separator</tt> で区切った文字列)
+
:* <tt>list</tt> (タグを <code><nowiki><li><a></a></li></nowiki></code> で囲み、<code><nowiki><ul class='wp-tag-cloud'></ul></nowiki></code> のリストにした文字列)
|オプション|flat}}
+
:* <tt>flat</tt> (タグを <code><nowiki><a></a></nowiki></code> で囲み '''separator''' で区切った文字列)
{{Parameter|separator|文字列|<tt>format</tt> が <tt>flat</tt> のときのタグリンクの区切り文字。|オプション|\n}}
+
 
{{Parameter|orderby|文字列|タグの並び順のキー。
+
{{Parameter|separator|文字列|'''format''' が <tt>flat</tt> である場合のタグリンクの区切り文字。|オプション|<code>\n</code>}}
 +
 
 +
{{Parameter|orderby|文字列|タグの並び順のキー。|オプション|<code>name</code>}}
 
:* <tt>name</tt> (タグの名前順)
 
:* <tt>name</tt> (タグの名前順)
 
:* <tt>その他</tt> (タグの件数順)
 
:* <tt>その他</tt> (タグの件数順)
|オプション|name}}
+
 
{{Parameter|order|文字列|タグの並び順。
+
{{Parameter|order|文字列|タグの並び順。|オプション|<code>ASC</code>}}
 
:* <tt>ASC</tt> (昇順)
 
:* <tt>ASC</tt> (昇順)
 
:* <tt>DESC</tt> (降順)
 
:* <tt>DESC</tt> (降順)
:* <tt>RAND</tt> (ランダム。orderby の値は無効)
+
:* <tt>RAND</tt> (ランダム。'''orderby''' の値は無効)
|オプション|ASC}}
+
 
{{Parameter|topic_count_text_callback|関数名|タグリンクの title 属性に設定される「タグの件数」の文字列を返す関数。|オプション|default_topic_count_text}}
+
{{Parameter|topic_count_text_callback|関数名|タグリンクの <code>title</code> 属性に設定される「タグの件数」の文字列を返す関数。|オプション|<code>default_topic_count_text</code>}}
{{Parameter|topic_count_scale_callback|関数名|タグリンクのフォントサイズ算出の元になる「タグのサイズ」を 100% 単位で返す関数。|オプション|default_topic_count_scale}}
+
 
{{Parameter|single_text|文字列|タグの件数が1件のときの表示フォーマット。PHP の sprintf で使うフォーマット指定子を含む。<tt>topic_count_text_callback</tt> が空文字のとき有効。|オプション}}
+
{{Parameter|topic_count_scale_callback|関数名|タグリンクのフォントサイズ算出の元になる「タグのサイズ」を 100% 単位で返す関数。|オプション|<code>default_topic_count_scale</code>}}
{{Parameter|multiple_text|文字列|タグの件数が複数のときの表示フォーマット。PHP の sprintf で使うフォーマット指定子を含む。<tt>topic_count_text_callback</tt> が空文字のとき有効。|オプション}}
+
 
{{Parameter|filter|真偽値|タグクラウド作成後に wp_generate_tag_cloud フィルタを実行するかどうかを指定。
+
{{Parameter|single_text|文字列|タグが 1 件のときの表示フォーマット。PHP の sprintf で使うフォーマット指定子を含む。'''topic_count_text_callback''' が空文字のとき有効。|オプション}}
 +
 
 +
{{Parameter|multiple_text|文字列|タグが 2 件以上のときの表示フォーマット。PHP の sprintf で使うフォーマット指定子を含む。'''topic_count_text_callback''' が空文字のとき有効。|オプション}}
 +
 
 +
{{Parameter|filter|真偽値|タグクラウド作成後に <code>'wp_generate_tag_cloud'</code> フィルタを実行するかどうかを指定。|オプション|1}}
 
:* <tt>1</tt> (true)
 
:* <tt>1</tt> (true)
 
:* <tt>0</tt> (false)
 
:* <tt>0</tt> (false)
|オプション|1}}
 
  
 
<div id="Hooks">
 
<div id="Hooks">
 
== フック ==
 
== フック ==
 
</div>
 
</div>
* apply_filters( 'tag_cloud_sort', $tags, $args )
+
* <code>apply_filters( 'tag_cloud_sort', $tags, $args );</code>
タグクラウド作成前に実行されます。
+
: タグクラウド作成前に実行されます。
  
* apply_filters( 'wp_generate_tag_cloud', $return, $tags, $args );
+
* <code>apply_filters( 'wp_generate_tag_cloud', $return, $tags, $args );</code>
タグクラウド作成後に実行されます。
+
: タグクラウド作成後に実行されます。
  
 
<div id="Examples">
 
<div id="Examples">
 
== 用例 ==
 
== 用例 ==
 
</div>
 
</div>
 +
 +
<!-- Need creative examples. Feel free to link to external examples. -->
 +
{{募集中||クリエイティブな例を求めています。外部サイトへのリンクでも構いません。|情報}}
  
 
<div id="Notes">
 
<div id="Notes">
114行目: 125行目:
  
 
{{Tag Tag Tags}}
 
{{Tag Tag Tags}}
{{PHP Function Tag Footer}}
 
{{原文|Template_Tags/wp_generate_tag_cloud|79012}}<!-- 19:16, 9 October 2009 Ramiy 版 -->
 
  
{{DEFAULTSORT:wp_generate_tag_cloud}}  
+
{{Tag Footer}}
 +
 
 +
{{原文|Function Reference/wp_generate_tag_cloud|138707}} <!-- 16:09, 30 November 2013 Mistercat 版 -->
 +
 
 +
{{DEFAULTSORT:Wp_generate_tag_cloud}}  
 
[[Category:テンプレートタグ]]
 
[[Category:テンプレートタグ]]
  
[[en:Template Tags/wp_generate_tag_cloud]]
+
[[en:Function Reference/wp_generate_tag_cloud]]
 +
[[it:Riferimento funzioni/wp_generate_tag_cloud]]

2014年8月10日 (日) 19:01時点における版

タグクラウドの HTML を文字列や配列で取得します。

使い方

<?php $cloud = wp_generate_tag_cloud( $tags, $args ); ?>

デフォルトの使い方

<?php $args = array(
	'smallest'  => 8,
	'largest'   => 22,
	'unit'      => 'pt',
	'number'    => 0,
	'format'    => 'flat',
	'separator' => '\n',
	'orderby'   => 'name',
	'order'     => 'ASC',
	'topic_count_text_callback'  => 'default_topic_count_text',
	'topic_count_scale_callback' => 'default_topic_count_scale',
	'filter'    => 1 ); ?>

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

  • smallest - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
  • largest - 一番大きいタグを 22(pt) で表示(件数が多いタグ)
  • unit - smallestlargest のフォントサイズの単位として 'pt' (ポイント) を使用。
  • number - すべてのタグを表示。
  • format - flat 形式でタグを表示。
  • separator - ホワイトスペース区切りでタグを表示。
  • orderby - タグ名順に表示
  • order - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)。
  • topic_count_text_callback - タグ数の表示形式を default_topic_count_text 関数で指定。
  • topic_count_scale_callback - タグの表示スケールを default_topic_count_scale 関数で指定。
  • filter - 最後に wp_generate_tag_cloud フィルタが実行されます。

パラメータ

$tags
配列) (必須) タグクラウドを作るためのタグ情報の配列。配列の要素はタグオブジェクトとし、id, link, name のプロパティを持つこと。配列のキーが id の場合は id プロパティは不要。
初期値: なし
smallest
整数) (オプション) 一番小さい(件数が少ない)タグの表示サイズを unit 単位で指定。
初期値: 8
largest
整数) (オプション) 一番大きい(件数が少ない)タグの表示サイズを unit 単位で指定。
初期値: 22
unit
文字列) (オプション) フォントサイズの単位を指定。CSS の font-size プロパティで指定可能な単位が使える。
初期値: pt
  • pt (ポイント)
  • px (ピクセル)
  • em (現在のフォントのサイズを1とした比率)
  • % (現在のフォントのサイズを100とした比率)
number
整数) (オプション) 表示するタグの個数。0 ならすべて表示する
初期値: 0
format
文字列) (オプション) タグクラウドの戻り値の形式を指定する。
初期値: flat
  • array (タグを <a></a> で囲んだ文字列の配列)
  • list (タグを <li><a></a></li> で囲み、<ul class='wp-tag-cloud'></ul> のリストにした文字列)
  • flat (タグを <a></a> で囲み separator で区切った文字列)
separator
文字列) (オプションformatflat である場合のタグリンクの区切り文字。
初期値: \n
orderby
文字列) (オプション) タグの並び順のキー。
初期値: name
  • name (タグの名前順)
  • その他 (タグの件数順)
order
文字列) (オプション) タグの並び順。
初期値: ASC
  • ASC (昇順)
  • DESC (降順)
  • RAND (ランダム。orderby の値は無効)
topic_count_text_callback
関数名) (オプション) タグリンクの title 属性に設定される「タグの件数」の文字列を返す関数。
初期値: default_topic_count_text
topic_count_scale_callback
関数名) (オプション) タグリンクのフォントサイズ算出の元になる「タグのサイズ」を 100% 単位で返す関数。
初期値: default_topic_count_scale
single_text
文字列) (オプション) タグが 1 件のときの表示フォーマット。PHP の sprintf で使うフォーマット指定子を含む。topic_count_text_callback が空文字のとき有効。
初期値: なし
multiple_text
文字列) (オプション) タグが 2 件以上のときの表示フォーマット。PHP の sprintf で使うフォーマット指定子を含む。topic_count_text_callback が空文字のとき有効。
初期値: なし
filter
真偽値) (オプション) タグクラウド作成後に 'wp_generate_tag_cloud' フィルタを実行するかどうかを指定。
初期値: 1
  • 1 (true)
  • 0 (false)

フック

  • apply_filters( 'tag_cloud_sort', $tags, $args );
タグクラウド作成前に実行されます。
  • apply_filters( 'wp_generate_tag_cloud', $return, $tags, $args );
タグクラウド作成後に実行されます。

用例

情報募集中 クリエイティブな例を求めています。外部サイトへのリンクでも構いません。 該当部分を編集するか、このページのノートまたはフォーラム等で教えてください。


変更履歴

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

ソースファイル

wp_generate_tag_cloud()wp-includes/category-template.php にあります。


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


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/wp_generate_tag_cloud最新版との差分