|
|
| 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>''</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]]
| + | |
