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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/wp_list_bookmarks 2007年8月8日 (水) 20:49 FireMind 版)
 
(要確認部分を除きひととおり和訳)
1行目: 1行目:
 
{{draft}}
 
{{draft}}
 +
{{Notice|要検討}}
  
== Description ==
+
<div id="Description">
This function will be found in WordPress v2.1 it is NOT supported by WordPress v2.0. [[Template_Tags/wp_list_bookmarks|wp_list_bookmarks()]], displays bookmarks found in the [[Administration_Panels|Administration]] > [[Administration_Panels#Manage_Blogroll|Blogroll]] > [[Manage_Blogroll_SubPanel|Manage Blogroll]] panel.  This [[Template_Tags|Template Tag]] allows the user to control how the bookmarks are sorted and displayed and is intended to replace the Template tags '[[Template_Tags/get_links_list|get_links_list()]]' and '[[Template_Tags/get_links|get_links()]]'.
+
== 説明 ==
 +
</div>
 +
この関数は WordPress バージョン 2.1 以上で使えます。2.0.x 系には対応していません。
 +
[[テンプレートタグ/wp_list_bookmarks|wp_list_bookmarks()]] は、[[管理パネル|管理]] > [[管理パネル#Manage_Blogroll|ブログロール]] > [[:en:Manage_Blogroll_SubPanel|Manage Blogroll]] パネルにあるブックマークを表示します。ブックマークの表示順や表示内容を指定できます。このタグは、テンプレートタグ '[[:en:Template_Tags/get_links_list|get_links_list()]]' '[[:en:Template_Tags/get_links|get_links()]]' の後継に当たります。
  
== Usage ==
+
<div id="Usage">
%%% <?php wp_list_bookmarks('arguments'); ?> %%%
+
== 使い方 ==
 +
</div>
  
== Examples ==
+
<?php wp_list_bookmarks('引数'); ?>
  
===Default Usage===
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
<div id="Default_Usage">
 +
=== 初期設定での使用 ===
 +
</div>
 
<pre>
 
<pre>
 
$defaults = array('orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '',
 
$defaults = array('orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '',
17行目: 28行目:
 
   'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>');</pre>
 
   'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>');</pre>
  
By default, the usage shows:
+
デフォルトでは次のように表示されます。
* Bookmarks divided into Categories with a Category name heading
+
* ブックマークをカテゴリ毎に分け、カテゴリ名の見出しを付ける
* All bookmarks included, regardless of Category ID, Category Name, or Category ID
+
* All bookmarks included, regardless of Category ID, Category Name, or Category ID<!-- カテゴリID・カテゴリ名を問わず、全てのブックマークを表示? -->
* Sorts the list by name
+
* リストを名前順にソート
* An image if one is included
+
* 画像(Image URL)が登録されていれば表示
* A space between the image and the text
+
* A space between the image and the text<!-- 画像とテキストとの間に 1スペースを挿入?(これは between パラメータ?text とは Description か?「1スペース」で合っているか?) -->
* Shows the description of the bookmark
+
* ブックマークの概要(Description)を表示
* Does not show the ratings
+
* 評価(Rating)は非表示
* Unless limit is set, shows all bookmarks
+
* 表示数制限なし、全てのブックマークを表示
* Displays bookmarks
+
* ブックマークを表示(サイトに表示するか値を返すかを選べるので)
  
 
  <?php wp_list_bookmarks(); ?>
 
  <?php wp_list_bookmarks(); ?>
  
=== Specific Category Sorted by URL ===
+
<div id="Specific_Category_Sorted_by_URL">
Displays bookmarks for Category ID 2 in span tags, uses images for bookmarks, does not show descriptions, sorts by bookmark URL.
+
=== 特定のカテゴリを URL でソート ===
 +
</div>
 +
<code><nowiki><span></nowiki></code> タグ内にカテゴリID 2 のブックマークを表示、ブックマークの画像を使用、概要は非表示、ブックマーク URL でソート。
  
<?php wp_list_bookmarks('categorize=0&category=2&before=&lt;span&gt;&after=&lt;/span&gt;&show_images=1&show_description=0&orderby=url'); ?>
+
<pre>
 +
<?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?>
 +
</pre>
  
=== Shows Ratings and Timestamp ===
+
<div id="Shows_Ratings_and_Timestamp">
Displays all bookmarks in an ordered list with descriptions on a new line, does not use images for bookmarks, sorts by bookmark id, shows ratings and last-updated timestamp.
+
=== 評価とタイムスタンプを表示 ===
 +
</div>
 +
番号付き箇条書きで全てのブックマークを表示、各ブックマークの 2行目に概要を表示、画像は非表示、ブックマークID でソート、評価・最終更新日時を表示。
  
&lt;ol&gt;
+
<pre>
<?php wp_list_bookmarks('between=&lt;br /&gt;&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
+
<ol>
&lt;/ol&gt;
+
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
 +
</ol>
 +
</pre>
  
== Parameters ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 
<!--
 
<!--
 
<pre>
 
<pre>
53行目: 74行目:
 
</pre>
 
</pre>
 
-->
 
-->
; categorize : (''boolean'') Bookmarks should be shown within their assigned Categories (<tt>TRUE</tt>) or not (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>.
+
; categorize  
:* <tt>1</tt> (True - default)
+
: ''真偽値'') ブックマークをカテゴリ分けして表示する(<code>TRUE</code>)か否(<code>FALSE</code>)か。初期値は <code>TRUE</code>(カテゴリ毎に分ける)。
:* <tt>0</tt> (False)
+
:* <code>1</code> (True - 初期値)
; category : (''string'') Comma separated list of numeric Category IDs to be displayed. If none is specified, all Categories with bookmarks are shown. Defaults to <tt>''</tt> (all Categories).
+
:* <code>0</code> (False)
; category_name : (''string'') The name of a Category whose bookmarks will be displayed. If none is specified, all Categories with bookmarks are shown. Defaults to <tt>''</tt> (all Categories).
+
; category  
; category_orderby : (''string'') Value to sort Categories on. Defaults to <tt>'name'</tt>. Valid options:
+
: ''文字列'') 表示するカテゴリID の数字をカンマ区切りで指定。特に指定しなければ全カテゴリのブックマークを表示。初期値は <code><nowiki>''</nowiki></code>(全カテゴリ)。
:* <tt>'name'</tt> (Default)
+
; category_name  
:* <tt>'id'</tt>
+
: ''文字列'') 表示するブックマークのカテゴリ名。特に指定しなければ全カテゴリのブックマークを表示。初期値は <code><nowiki>''</nowiki></code>(全カテゴリ)。
; category_order : (''string'') Sort order, ascending or descending for the category_orderby parameter. Valid values:
+
; category_orderby  
:* <tt>ASC</tt> (Default)
+
: ''文字列'') カテゴリをどの項目でソートするか。初期値は <code>'name'</code>。有効値:
:* <tt>DESC</tt>
+
:* <code>'name'</code> (初期値)
; title_li : (''string'') Text for the heading of the Page list. Defaults to <tt>'__('Bookmarks')'</tt>, which displays "Bookmarks" (the <tt>__(&#039;&#039;)</tt> is used for [[Localization|localization purposes]]).  Only used with categorize set to 0 (else the category names will be used instead). If passed a null or empty value (<tt>&#039;&#039;</tt>), no heading is displayed, and the list will not be wrapped with <tt>&lt;ul>, &lt;/ul></tt> tags.
+
:* <code>'id'</code>
; title_before : (''string'') Text to place before each Category description if 'categorize' is TRUE.  Defaults to <tt>'&lt;h2&gt;'</tt>.
+
; category_order  
; title_after : (''string'') Text to place after each Category description if 'categorize' is TRUE. Defaults to <tt>'&lt;/h2&gt;'</tt>.
+
: ''文字列'') カテゴリのソート順。category_orderby パラメータで指定した項目の昇順か降順か。有効値:
; show_private : (''boolean'') Should a Category be displayed even if the Category is considered private.  Ignore the admin setting and show private Categories (<tt>TRUE</tt>) or do NOT show private Categories (<tt>FALSE</tt>). Defaults to <tt>FALSE</tt>.
+
:* <code>ASC</code> (初期値)
:* <tt>1</tt> (True)
+
:* <code>DESC</code>
:* <tt>0</tt> (False - default)
+
; title_li  
; include : (''string'') Comma separated list of numeric bookmark IDs to include in the output.  For example, 'include=1,3,6' means to return or echo bookmark IDs 1, 3, and 6.  If the include string is used, the ''category'', ''category_name'', and ''exclude'' parameters are ignored.  Defaults to <tt>''</tt> (all Bookmarks).
+
: ''文字列'') ブックマークリストの見出しとする文字列。初期値は「Bookmarks」(またはその翻訳語句)を表示するための <code>'__('Bookmarks')'</code>(「<code><nowiki>__('○○')</nowiki></code>」は[[:ja:Localization|翻訳用の書き方]])。'categorize' パラメータが 0 のときにのみ有効( 1 のときは見出しにカテゴリ名が使われる)。ヌルか空の値(<code><nowiki>''</nowiki></code>)を指定すると、見出しは表示せず、リストを <code><nowiki><ul>, </ul></nowiki></code> タグで括らない。
; exclude : (''string'') Comma separated list of numeric bookmark IDs to exclude.  For example, 'exclude=4,12' means that bookmark IDs 4 and 12 will NOT be returned or echoed.  Defaults to <tt>''</tt> (exclude nothing).
+
; title_before  
; orderby : (''string'') Value to sort bookmarks on. Defaults to <tt>'name'</tt> unless you pass the value of <tt>&#39;&#39;</tt> (empty), in which case it sets to <tt>'id'</tt>. Valid options:
+
: ''文字列'''categorize' パラメータが TRUE のとき、各カテゴリ概要の前に置く文字列。初期値は <code><nowiki>'<h2>'</nowiki></code>。
:* <tt>'id'</tt>
+
; title_after  
:* <tt>'url'</tt>
+
: ''文字列'''categorize' パラメータが TRUE のとき、各カテゴリ概要の後ろに置く文字列。初期値は <code>'</h2>'</code>
:* <tt>'name'</tt>
+
; show_private  
:* <tt>'target'</tt>
+
: ''真偽値'') プライベートなカテゴリであっても表示するか。管理設定を無視してプライベートカテゴリを表示する(<code>TRUE</code>)か、プライベートカテゴリを表示しない(<code>FALSE</code>)か。初期値は <code>FALSE</code>(表示しない)。
:* <tt>'description'</tt>
+
:* <code>1</code> (True)
:* <tt>'owner'</tt> - User who added bookmark through bookmarks Manager.
+
:* <code>0</code> (False - 初期値)
:* <tt>'rating'</tt>
+
; include  
:* <tt>'updated'</tt>
+
: ''文字列'') 出力に含めるブックマークID の数字をカンマ区切りで指定。例えば <code>'include=1,3,6'</code> とすれば、ブックマークID が 1, 3, 6 のものを返す/表示する。このパラメータを指定すると、''category'', ''category_name'', ''exclude'' パラメータの指定は無視される。初期値は <code><nowiki>''</nowiki></code>(全ブックマーク)。
:* <tt>'rel'</tt> - bookmark relationship (XFN).
+
; exclude  
:* <tt>'notes'</tt>
+
: ''文字列'') 出力から除外するブックマークID の数字をカンマ区切りで指定。例えば <code>'exclude=4,12'</code> とすれば、ブックマークID が 4, 12 のものは返さない/表示しない。初期値は <code><nowiki>''</nowiki></code>(除外なし)。
:* <tt>'rss'</tt>
+
; orderby  
:* <tt>'length'</tt> - The length of the bookmark name, shortest to longest.
+
: ''文字列'') ブックマークをどの項目でソートするか。<code>'id'</code> とするために <code><nowiki>''</nowiki></code>(ブランク)を指定するのでない限り、初期値は <code>'name'</code>。有効値:
:* <tt>'rand'</tt> - Display bookmarks in random order
+
:* <code>'id'</code>
 +
:* <code>'url'</code>
 +
:* <code>'name'</code>
 +
:* <code>'target'</code>
 +
:* <code>'description'</code>
 +
:* <code>'owner'</code> - ブックマーク管理パネルでブックマークを追加したユーザ
 +
:* <code>'rating'</code>
 +
:* <code>'updated'</code>
 +
:* <code>'rel'</code> - ブックマーク先との続柄(bookmark relationship)(XFN).
 +
:* <code>'notes'</code>
 +
:* <code>'rss'</code>
 +
:* <code>'length'</code> - The length of the bookmark name, shortest to longest.
 +
:* <code>'rand'</code> - ランダムな順序でブックマークを表示
 +
; order  
 +
: ブックマークのソート順。orderby パラメータで指定した項目の昇順か降順か。有効値:
 +
:* <code>ASC</code> (初期値)
 +
:* <code>DESC</code>
 +
; limit
 +
: (''整数'') 表示するブックマークの最大数。初期値は <code>-1</code>(全ブックマーク)。
 +
; before
 +
: (''文字列'') 各ブックマークの前に置く文字列。初期値は <code><nowiki>'<li>'</nowiki></code>。
 +
; after
 +
: (''文字列'') 各ブックマークの後ろに置く文字列。初期値は <code><nowiki>'</li>'</nowiki></code>。
 +
; category_before
 +
: (''文字列'') 各カテゴリの前に置く文字列。初期値は、それぞれに見合った <code>id</code> と <code>class</code> 属性付きの <code><nowiki>'<li>'</nowiki></code> 。
 +
; category_after
 +
: (''文字列'') 各カテゴリの後ろに置く文字列。初期値は <code><nowiki>'</li>'</nowiki></code>。
 +
; between
 +
: (''文字列'') 各ブックマーク/画像とその概要との間に置く文字列。初期値は <code>'\n'</code>(HTMLコード上の改行?)。<!-- \n なら HTMLコード上の改行、サイト表示上の改行(br)ではない、たぶん。 -->
 +
; show_images
 +
: (''真偽値'') ブックマーク画像を表示する(<code>TRUE</code>)か否(<code>FALSE</code>)か。初期値は <code>TRUE</code>(表示)。
 +
:* <code>1</code> (True - 初期値)
 +
:* <code>0</code> (False)
 +
; show_description
 +
: (''真偽値'') 各ブックマークの概要を表示する()か否()か。'''show_images''' パラメータが <code>FALSE</code> のときか、画像が定義されていないときに有効。初期値は <code>FALSE</code>(表示しない)。
 +
:* <code>1</code> (True)
 +
:* <code>0</code> (False - 初期値)
 +
; show_rating
 +
: (''真偽値'') 各ブックマークの評価の星/文字を表示する(<code>TRUE</code>)か否(<code>FALSE</code>)か。初期値は <code>FALSE</code>(表示しない)。
 +
:* <code>1</code> (True)
 +
:* <code>0</code> (False - 初期値)
 +
; show_updated
 +
: (''真偽値'') 各ブックマークの最終更新日時を表示する(<code>TRUE</code>)か否(<code>FALSE</code>)か。初期値は <code>FALSE</code>(表示しない)。
 +
:* <code>1</code> (True)
 +
:* <code>0</code> (False - 初期値)
 +
; hide_invisible
 +
: (''真偽値'') Visible 設定が No のブックマークを非表示とするか。管理パネルでの設定に従う(<code>TRUE</code>)か、無視する(<code>FALSE</code>)か。初期値は <code>TRUE</code>(管理設定どおり。No なら非表示)。
 +
:* <code>1</code> (True - 初期値)
 +
:* <code>0</code> (False)
 +
; echo
 +
: (''真偽値'') ブックマークを表示する(<code>TRUE</code>)か、PHP で使うために値として返す(<code>FALSE</code>)か。初期値は <code>TRUE</code>(表示)。
 +
:* <code>1</code> (True - 初期値)
 +
:* <code>0</code> (False)
  
; order : (''string'') Sort order, ascending or descending for the orderby parameter. Valid values:
+
<div id="Related">
:* <tt>ASC</tt> (Default)
+
== 関連 ==
:* <tt>DESC</tt>
+
</div>
; limit : (''integer'') Maximum number of bookmarks to display. Defaults to <tt>-1</tt> (all bookmarks).
+
; before : (''string'') Text to place before each bookmark. Defaults to <tt>'&lt;li&gt;'</tt>.
+
; after : (''string'') Text to place after each bookmark. Defaults to <tt>'&lt;/li&gt;'</tt>.
+
; category_before : (''string'') Text to place before each category. Defaults to <tt>'&lt;li&gt;'</tt> with an appropriate id and class.
+
; category_after : (''string'') Text to place after each category. Defaults to <tt>'&lt;/li&gt;'</tt>.
+
; between : (''string'') Text to place between each bookmark/image and its description. Defaults to <tt>'\n'</tt> (newline).
+
; show_images : (''boolean'') Should images for bookmarks be shown (<tt>TRUE</tt>) or not (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>.
+
:* <tt>1</tt> (True - default)
+
:* <tt>0</tt> (False)
+
; show_description : (''boolean'') Should the description be displayed (<tt>TRUE</tt>) or not (<tt>FALSE</tt>). Valid when '''show_images''' is <tt>FALSE</tt>, or an image is not defined. Defaults to <tt>FALSE</tt>.
+
:* <tt>1</tt> (True)
+
:* <tt>0</tt> (False - default)
+
; show_rating : (''boolean'') Should rating stars/characters be displayed (<tt>TRUE</tt>) or not (<tt>FALSE</tt>). Defaults to <tt>FALSE</tt>.
+
:* <tt>1</tt> (True)
+
:* <tt>0</tt> (False - default)
+
; show_updated : (''boolean'') Should the last updated timestamp be displayed (<tt>TRUE</tt>) or not (<tt>FALSE</tt>). Defaults to <tt>FALSE</tt>.
+
:* <tt>1</tt> (True)
+
:* <tt>0</tt> (False - default)
+
; hide_invisible : (''boolean'') Should bookmark be displayed even if it's Visible setting is No.  Abides by admin setting (<tt>TRUE</tt>) or does no abide by admin setting (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>.
+
:* <tt>1</tt> (True - default)
+
:* <tt>0</tt> (False)
+
; echo : (''boolean'') Display bookmarks (<tt>TRUE</tt>) or return them for use by PHP (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>.
+
:* <tt>1</tt> (True - default)
+
:* <tt>0</tt> (False)
+
 
+
== Related ==
+
  
 
{{Tag bookmark Manager Tags}}
 
{{Tag bookmark Manager Tags}}
121行目: 168行目:
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
[[Category:Drafts]]
+
{{原文|Template Tags/wp_list_bookmarks}}
 +
 
 +
{{DEFAULTSORT:wp_list_bookmarks}}
 +
 
 +
[[en:Template Tags/wp_list_bookmarks]]

2007年9月1日 (土) 21:42時点における版

このページはラフドラフトで、まだ内容の検証が済んでいません。情報が間違っていたり書き直されることがあります。
執筆中のため、執筆者の許可なく編集しないでください

要検討このページのノートをご覧ください。

この関数は WordPress バージョン 2.1 以上で使えます。2.0.x 系には対応していません。 wp_list_bookmarks() は、管理 > ブログロール > Manage Blogroll パネルにあるブックマークを表示します。ブックマークの表示順や表示内容を指定できます。このタグは、テンプレートタグ 'get_links_list()' と 'get_links()' の後継に当たります。

使い方

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

用例

初期設定での使用

$defaults = array('orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '',
  'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'echo' => 1,
  'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '<h2>', 'title_after' => '</h2>',
  'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat',
  'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>');

デフォルトでは次のように表示されます。

  • ブックマークをカテゴリ毎に分け、カテゴリ名の見出しを付ける
  • All bookmarks included, regardless of Category ID, Category Name, or Category ID
  • リストを名前順にソート
  • 画像(Image URL)が登録されていれば表示
  • A space between the image and the text
  • ブックマークの概要(Description)を表示
  • 評価(Rating)は非表示
  • 表示数制限なし、全てのブックマークを表示
  • ブックマークを表示(サイトに表示するか値を返すかを選べるので)
<?php wp_list_bookmarks(); ?>

特定のカテゴリを URL でソート

<span> タグ内にカテゴリID 2 のブックマークを表示、ブックマークの画像を使用、概要は非表示、ブックマーク URL でソート。

<?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?>

評価とタイムスタンプを表示

番号付き箇条書きで全てのブックマークを表示、各ブックマークの 2行目に概要を表示、画像は非表示、ブックマークID でソート、評価・最終更新日時を表示。

<ol>
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
</ol>

パラメータ

categorize
真偽値) ブックマークをカテゴリ分けして表示する(TRUE)か否(FALSE)か。初期値は TRUE(カテゴリ毎に分ける)。
  • 1 (True - 初期値)
  • 0 (False)
category
文字列) 表示するカテゴリID の数字をカンマ区切りで指定。特に指定しなければ全カテゴリのブックマークを表示。初期値は ''(全カテゴリ)。
category_name
文字列) 表示するブックマークのカテゴリ名。特に指定しなければ全カテゴリのブックマークを表示。初期値は ''(全カテゴリ)。
category_orderby
文字列) カテゴリをどの項目でソートするか。初期値は 'name'。有効値:
  • 'name' (初期値)
  • 'id'
category_order
文字列) カテゴリのソート順。category_orderby パラメータで指定した項目の昇順か降順か。有効値:
  • ASC (初期値)
  • DESC
title_li
文字列) ブックマークリストの見出しとする文字列。初期値は「Bookmarks」(またはその翻訳語句)を表示するための '__('Bookmarks')'(「__('○○')」は翻訳用の書き方)。'categorize' パラメータが 0 のときにのみ有効( 1 のときは見出しにカテゴリ名が使われる)。ヌルか空の値('')を指定すると、見出しは表示せず、リストを <ul>, </ul> タグで括らない。
title_before
文字列) 'categorize' パラメータが TRUE のとき、各カテゴリ概要の前に置く文字列。初期値は '<h2>'
title_after
文字列) 'categorize' パラメータが TRUE のとき、各カテゴリ概要の後ろに置く文字列。初期値は '</h2>'
show_private
真偽値) プライベートなカテゴリであっても表示するか。管理設定を無視してプライベートカテゴリを表示する(TRUE)か、プライベートカテゴリを表示しない(FALSE)か。初期値は FALSE(表示しない)。
  • 1 (True)
  • 0 (False - 初期値)
include
文字列) 出力に含めるブックマークID の数字をカンマ区切りで指定。例えば 'include=1,3,6' とすれば、ブックマークID が 1, 3, 6 のものを返す/表示する。このパラメータを指定すると、category, category_name, exclude パラメータの指定は無視される。初期値は ''(全ブックマーク)。
exclude
文字列) 出力から除外するブックマークID の数字をカンマ区切りで指定。例えば 'exclude=4,12' とすれば、ブックマークID が 4, 12 のものは返さない/表示しない。初期値は ''(除外なし)。
orderby
文字列) ブックマークをどの項目でソートするか。'id' とするために ''(ブランク)を指定するのでない限り、初期値は 'name'。有効値:
  • 'id'
  • 'url'
  • 'name'
  • 'target'
  • 'description'
  • 'owner' - ブックマーク管理パネルでブックマークを追加したユーザ
  • 'rating'
  • 'updated'
  • 'rel' - ブックマーク先との続柄(bookmark relationship)(XFN).
  • 'notes'
  • 'rss'
  • 'length' - The length of the bookmark name, shortest to longest.
  • 'rand' - ランダムな順序でブックマークを表示
order
ブックマークのソート順。orderby パラメータで指定した項目の昇順か降順か。有効値:
  • ASC (初期値)
  • DESC
limit
整数) 表示するブックマークの最大数。初期値は -1(全ブックマーク)。
before
文字列) 各ブックマークの前に置く文字列。初期値は '<li>'
after
文字列) 各ブックマークの後ろに置く文字列。初期値は '</li>'
category_before
文字列) 各カテゴリの前に置く文字列。初期値は、それぞれに見合った idclass 属性付きの '<li>'
category_after
文字列) 各カテゴリの後ろに置く文字列。初期値は '</li>'
between
文字列) 各ブックマーク/画像とその概要との間に置く文字列。初期値は '\n'(HTMLコード上の改行?)。
show_images
真偽値) ブックマーク画像を表示する(TRUE)か否(FALSE)か。初期値は TRUE(表示)。
  • 1 (True - 初期値)
  • 0 (False)
show_description
真偽値) 各ブックマークの概要を表示する()か否()か。show_images パラメータが FALSE のときか、画像が定義されていないときに有効。初期値は FALSE(表示しない)。
  • 1 (True)
  • 0 (False - 初期値)
show_rating
真偽値) 各ブックマークの評価の星/文字を表示する(TRUE)か否(FALSE)か。初期値は FALSE(表示しない)。
  • 1 (True)
  • 0 (False - 初期値)
show_updated
真偽値) 各ブックマークの最終更新日時を表示する(TRUE)か否(FALSE)か。初期値は FALSE(表示しない)。
  • 1 (True)
  • 0 (False - 初期値)
hide_invisible
真偽値) Visible 設定が No のブックマークを非表示とするか。管理パネルでの設定に従う(TRUE)か、無視する(FALSE)か。初期値は TRUE(管理設定どおり。No なら非表示)。
  • 1 (True - 初期値)
  • 0 (False)
echo
真偽値) ブックマークを表示する(TRUE)か、PHP で使うために値として返す(FALSE)か。初期値は TRUE(表示)。
  • 1 (True - 初期値)
  • 0 (False)


ブックマークタグ: wp_list_bookmarks, get_bookmarks, get_bookmark get_bookmark_field


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


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