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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(Wiki 書式・リンク調整、未翻訳)
(関数リファレンス/get bookmarksへのリダイレクト)
1行目: 1行目:
{{NeedTrans}}
+
#REDIRECT[[関数リファレンス/get bookmarks]]
<div id="Description">
+
== 説明 ==
+
</div>
+
This function will be found in [[Version 2.1|WordPress v2.1]], it is NOT supported by WordPress v2.0. get_bookmarks() returns an array of bookmarks found in the [[管理パネル|Administration]] > [[管理パネル#Manage - Change your content|Manage]] > [[Manage Links SubPanel|Manage Links]]/[[:en:Manage Links SubPanel|en]] panel.  This [[テンプレートタグ|Template Tag]] allows the user to retrieve the bookmark information directly.
+
 
+
<div id="Usage">
+
== 使い方 ==
+
</div>
+
<?php get_bookmarks('引数'); ?>
+
 
+
<div id="Examples">
+
== 用例 ==
+
</div>
+
 
+
<div id="Default_Usage">
+
=== 初期設定での使用 ===
+
</div>
+
<pre>
+
'orderby' => 'name',
+
'order' => 'ASC',
+
'limit' => -1,
+
'category' => '',
+
'category_name' => '',
+
'hide_invisible' => 1,
+
'show_updated' => 0,
+
'include' => '',
+
'exclude' => ''
+
</pre>
+
 
+
By default, the usage gets:
+
* All bookmarks ordered by name, ascending
+
* Bookmarks marked as hidden are not returned.
+
* The link_updated_f field (the update time in the form of a timestamp) is not returned.
+
 
+
<div id="Parameters">
+
== パラメータ ==
+
</div>
+
; orderby
+
: (''string'') Value to sort bookmarks on. Defaults to <code>'name'</code> unless you pass the value of <code>&#39;&#39;</code> (empty), in which case it sets to <code>'id'</code>. Valid options:
+
:* <code>'id'</code>
+
:* <code>'url'</code>
+
:* <code>'name'</code>
+
:* <code>'target'</code>
+
:* <code>'description'</code>
+
:* <code>'owner'</code> - User who added bookmark through bookmarks Manager.
+
:* <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> - Display bookmarks in random order. 
+
; order
+
: (''string'') Sort order, ascending or descending for the orderby parameter. Valid values:
+
:* <code>ASC</code> (Default)
+
:* <code>DESC</code>
+
; limit
+
: (''integer'') Maximum number of bookmarks to display. Defaults to <code>-1</code> (all bookmarks).
+
; category
+
: (''string'') Comma separated list of bookmark category ID's.
+
; category_name
+
: (''string'') Category name of a catgeory of bookmarks to retrieve. Overrides category parameter.
+
; hide_invisible
+
: (''boolean'') TRUE causes only bookmarks with link_visible set to 'Y' to be retrieved.
+
:* <code>1</code> (True - default)
+
:* <code>0</code> (False)
+
; show_updated
+
: (''boolean'') TRUE causes an extra column called "link_category_f" to be inserted into the results, which contains the same value as "link_updated", but in a unix timestamp format. Handy for using PHP date functions on this data.
+
:* <code>1</code> (True)
+
:* <code>0</code> (False - default)
+
; 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 <code>''</code> (all Bookmarks).
+
; 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 <code>''</code> (exclude nothing).
+
 
+
== 変更履歴 ==
+
* [[Version 2.1|2.1]] : 新規テンプレートタグ
+
 
+
<div id="Related">
+
== 関連 ==
+
</div>
+
 
+
{{Tag bookmark Manager Tags}}
+
 
+
{{PHP Function Tag Footer}}
+
 
+
{{原文|Template Tags/get_bookmarks|51914}}<!-- 18:20, December 6, 2007 Otto42 版 -->
+
 
+
{{DEFAULTSORT:get_bookmarks}}
+
 
+
[[en:Template Tags/get_bookmarks]]
+

2014年2月8日 (土) 20:22時点における版