Tuts+ テンプレート タグの第 8 バッチのガイド

このシリーズのパート 8 では、WordPress テンプレート タグの 7 番目のバッチを検討しました。パート 9 では、約 200 個のテンプレート タグの最終バッチを見ていきます。このチュートリアルでは、ブックマークのテンプレート タグとその他の「その他の」テンプレート タグについて説明します。

ブックマークに関する警告: WordPress 3.5 以降、「ブックマーク」は管理パネルでデフォルトで非表示になります。ブックマークを使用するには、リンク マネージャー プラグインをインストールする必要があります。

ブックマークリストを取得して表示します: wp_list_bookmarks()

このテンプレート タグは、WordPress の古い機能であるブックマークのリストを返すかエコーします。

パラメータ

このテンプレート タグはパラメータを 1 つだけ受け入れます:

• $args (オプション - 配列) :

  次のパラメーターの配列:

  • 'orderby' (文字列): ブックマークの順序付け方法。 「name」、「link_id」、「url」、「target」、「description」、「owner」（ブックマークを追加したユーザー）、「評価」、「update」（更新日）、「rel」（XFN）を受け入れます。ブックマーク関係)、'notes'、'rss'、'length' (ブックマーク名の長さ)、'rand' (ランダム)。

    (デフォルト: '名前')

  • 'order' (文字列): 項目を昇順 ('ASC') または降順 ('DESC') のどちらで並べ替えるか。

    (デフォルト: 'ASC')

  • 'limit' (整数): 表示する項目の数。

    (デフォルト: -1 はすべてのブックマークを意味します)

  • 'category' (文字列): アイテムを取得するカンマ区切りのカテゴリ ID。

    (デフォルト:「 」はすべてのカテゴリを意味します)

  • 'exclude_category' (文字列): 除外するブックマーク カテゴリの ID。 ＃＃＃＃＃＃＃＃＃（デフォルト：' '）＃＃＃

    'category_name' (文字列): ブックマークのカテゴリ名を表示します ('category' をオーバーライドします)。 ＃＃＃＃＃＃＃＃＃（デフォルト：''）＃＃＃

  • 'hide_invisible' (整数): 非表示のリンクを非表示にするか表示するか。

    (デフォルト: 1)

  • 'show_updated' (整数): 最終更新されたタイムスタンプを表示するかどうか。

    (デフォルト: 0)

  • 'echo' (整数): 出力をエコーするか (1)、返すか (0)。

    (デフォルト: 1)

  • 'categorize' (整数): ブックマークをカテゴリ別にグループ化するか (1)、グループ化しないか (0)。

    (デフォルト: 1)

  • 'title_li' (文字列): 出力を

    タグで囲み、ブックマーク リストの前にタイトルを表示します。空の文字列に設定し、改行を無効にすることもできます。

  • (デフォルト:「ブックマーク」) <li>'title_before'</li> (文字列): 各タイトルの前に追加する HTML コード。 ＃＃＃＃＃＃＃＃＃（デフォルト：'＃＃＃'）＃＃＃

    'title_after' (文字列): 各タイトルの後に追加される HTML コード。 ＃＃＃＃＃＃＃＃＃（デフォルト：'＃＃＃'）＃＃＃

  • 'class' (文字列): 各カテゴリに追加する CSS クラス名。

    (デフォルト: 'linkcat')

  • 'category_before' (文字列): 各カテゴリの前に追加する HTML コード。 ＃＃＃＃＃＃＃＃＃（デフォルト：'＃＃＃'）＃＃＃

    'category_after' (文字列): 各カテゴリの後に追加される HTML コード。 ＃＃＃＃＃＃＃＃＃（デフォルト：'＃＃＃'）＃＃＃

  'category_orderby'
  • (文字列): カテゴリを並べ替える方法。 「名前」、「ID」、「スラッグ」、および「カウント」を受け入れます。 (デフォルト: "名前")

  'category_order'
  • (文字列): カテゴリを昇順 ('ASC') または降順 ('DESC') のどちらで並べ替えるか。 (デフォルト: 'ASC')

  ＃＃＃使用法＃＃＃ リーリー
  • すべてのブックマークの配列を取得します: get_bookmarks()

    このテンプレート タグは、WordPress ブックマークの配列を返します。

  パラメータ
このテンプレート タグはパラメータを 1 つだけ受け入れます:
• $args

  (オプション - 配列) :

• 次のパラメーターの配列: 'orderby'

  (文字列): リンクの順序付け方法。名前、ID、タイトル、日付などの投稿フィールドを受け入れます。

(デフォルト: "名前")

'order'

(デフォルト: 'ASC')

'limit'

(デフォルト値: -1 はすべてを意味します)
• 'category' (文字列): アイテムを取得するカンマ区切りのカテゴリ ID。
  (デフォルト: 空)
  • 'category_name'

    (文字列): アイテムの取得元のカテゴリ名。

    （默认：空）

  • 'hide_invisible'（整数或布尔值）：是否显示或隐藏标记为“不可见”的链接。

    （默认：1|TRUE）

  • 'show_updated'（整数或布尔值）：是否显示书签上次更新时间。

    （默认：0|FALSE）

  • 'include'（字符串）：要包含的以逗号分隔的 ID 列表。

    （默认：空）

  • 'exclude'（字符串）：要排除的 ID 的逗号分隔列表。

    （默认：空）

用法

<?php

$args = array(
    'orderby' => 'title',
    'order' => 'ASC',
    'limit' => 15,
    'hide_invisible' => false,
    'exclude' => '12,16,23'
);

$bookmarks_array =  get_bookmarks( $args );

?>

获取书签数据：get_bookmark()

此模板标记返回给定书签的所有数据。

参数

此模板标记接受三个参数：

• $bookmark （必需 - 混合）：

  书签 ID 或对象。

  （默认：NULL） >

• $output （可选 - 字符串）：

  OBJECT、ARRAY_N 或 ARRAY_A 常量。

  （默认：OBJECT）

• $filter （可选—字符串）：

  是否转义输出。如果您想过滤输出，请将其设置为“display”。

  （默认：“raw”）

用法

<?php

// Getting a specific bookmark's fields with escaping the output.
$bookmark_data( 19, OBJECT, 'display' );

?>

获取单个书签字段的数据：get_bookmark_field()

此模板标记可让您获取单个书签字段的数据。

参数

此模板标记接受三个参数：

• $field （必填—字符串）：

  字段名称。

  （默认：NULL）

• $bookmark （必需 — 整数）：

  书签 ID。

  （默认：NULL）

• $context （可选—字符串）：

  如何过滤字段值—“raw”、“edit”、“attribute”、“js”、“db” '，或'显示'。

  （默认：'显示'）

用法

<?php

// Get the bookmark with the id 16 and escape & echo its title.
echo get_bookmark_field( 'title', 16, 'display' );

?>

获取并显示“编辑书签”链接：get_edit_bookmark_link() & edit_bookmark_link()

这些模板标签可让您获取或回显“编辑此书签”链接以在模板中使用。

参数

get_edit_bookmark_link() 只接受一个参数：

• $bookmark_id （必需 - 整数）：

  书签的 ID。

  （默认：0）

而 edit_bookmark_link() 接受四个参数：

• $text （可选—字符串）：

  显示链接的文本。

  （默认：“编辑此”）

• $before （可选—字符串）：

  在输出之前显示的文本或 HTML 代码。

  （默认：空）

• $after （可选—字符串）：

  输出后显示的文本或 HTML 代码。

  （默认：空）

• $bookmark_id （必需 - 整数）：

  书签的 ID。

  （默认：NULL） >

<?php

// Retrieve the current bookmark's "edit bookmark" link.
$edit_bookmark_link = get_edit_bookmark_link();

// Retrieve a specific bookmark's "edit bookmark" link.
$edit_bookmark_link = get_edit_bookmark_link( 98 );

// Display the current bookmark's "edit bookmark" link.
edit_bookmark_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );

// Display a specific bookmark's "edit bookmark" link.
edit_bookmark_link( __( 'Edit', 'translation-domain' ), '', '', 98 );

?>

<?php

// Display the name of the site.
bloginfo();

// Get the stylesheet url.
$stylesheet = get_bloginfo( 'stylesheet_url' );

// Display the WordPress version.
bloginfo( 'version' );

?>

<?php

// Display the body class.
body_class();

// Retrieve the body class with an extra class.
$body_class = get_body_class( 'mytheme-body' );

?>

<?php

$args = array(
    'container_id' => 'primary-nav',
    'link_before' => '<i class="icon-link"></i>',
    'theme_location' => 'primary'
);

wp_nav_menu( $args );

?>

<?php

wp_title( ' - ', true );

// Reverse the separator location to use left-hand indicators.
$page_title = wp_title( ' &laquo ', false, 'right' );

?>

<?php

// Getting a specific blog's home url with https.
$home_url_of_petes_blog = get_home_url( 2, '', 'https' );

// Echoes the current home url with a little addition.
echo home_url( '?rel=navlink' );

?>

<?php

// Getting a specific blog's site url with https.
$site_url_of_janes_blog = get_site_url( 3, '', 'https' );

// Echoes the current site url.
echo site_url();

?>

<?php

get_current_blog_id();

?>

<?php

// Get the dashboard url of the current blog.
$admin_url = get_admin_url();

// Display the admin url and force a secure connection.
admin_url( '', 'https' );

?>

<?php

// Get default feed type's link.
get_feed_link();

// Display a link for the "atom" feed.
the_feed_link( __( 'Atom Feed', 'translation-domain' ), 'atom' );

?>

<?php

$url_to_fix = user_trailingslashit( get_home_url() . 'some-special-page' );

?>

<?php

// Umm...
echo calendar_week_mod( 199 );

// Right? (it echoes "3" by the way).

?>

<?php

// Return the calendar.
$my_calendar = get_calendar( true, false );

// Display the calendar. 
get_calendar();

?>