ホームページ >バックエンド開発 >PHPチュートリアル >Tuts+ テンプレートタグの第 8 バッチのガイド

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

WBOYオリジナル: 2023-09-03 17:33:051584ブラウズ

このシリーズのパート 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 コード。＃＃＃＃＃＃＃＃＃（デフォルト：'＃＃＃'）＃＃＃
- (文字列): カテゴリを並べ替える方法。「名前」、「ID」、「スラッグ」、および「カウント」を受け入れます。 (デフォルト: "名前")
- (文字列): カテゴリを昇順 ('ASC') または降順 ('DESC') のどちらで並べ替えるか。 (デフォルト: 'ASC')
- すべてのブックマークの配列を取得します: get_bookmarks()
  このテンプレートタグは、WordPress ブックマークの配列を返します。
$args
(オプション - 配列) :
次のパラメーターの配列: 'orderby'
(文字列): リンクの順序付け方法。名前、ID、タイトル、日付などの投稿フィールドを受け入れます。

'order'

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

(デフォルト: 'ASC')

'limit'

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

'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 （可选—字符串）：
显示链接的文本。

（默认：“编辑此”） EM>
$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 );

?>

获取并显示您网站的信息：`get_bloginfo()` & `bloginfo()`

这些非常流行的模板标签返回并显示您网站的一般信息。

参数

get_bloginfo() 接受两个参数：

$show （可选—字符串）：
要获取的信息位。以下值之一：
- 'url'（字符串）：主页 URL。
- 'wpurl'（字符串）：安装 WordPress 的 URL。
- 'description'（字符串）：站点描述。
- 'rdf_url'（字符串）：RDF/RSS 1.0 提要 URL。
- 'rss_url'（字符串）：RSS 0.92 提要 URL。
- 'rss2_url'（字符串）：RSS 2.0 提要 URL。
- 'atom_url'（字符串）：Atom 提要 URL。
- 'comments_rss2_url'（字符串）：评论的 RSS 2.0 提要 URL。
- 'comments_atom_url'（字符串）：评论的 Atom 提要 URL。
- 'pingback_url'（字符串）：pingback XML-RPC 文件的 URL。
- 'stylesheet_url'（字符串）：主题主 CSS 文件的 URL。
- 'stylesheet_directory'（字符串）：主题主 CSS 文件目录的 URL。
- 'template_directory' 或 'template_url' （字符串）：活动主题目录的 URL。
- 'admin_email'（字符串）：安装WordPress时输入的电子邮件地址。
- 'charset'（字符串）：站点的字符集。
- 'html_type'（字符串）：WordPress HTML 页面的内容类型。
- 'version'（字符串）：WordPress 版本。
- 'language'（字符串）：WordPress 安装的语言。
- 'text_direction'（字符串）：语言的文本方向。
- 'name'（字符串）：站点名称。
（默认：'名称'）
$filter （可选—字符串）：
将其设置为 'filter' 以过滤从此模板标记返回的 URL。

（默认：'原始'）

而 bloginfo() 只接受一个参数：

$show （可选—字符串）：
与上面相同的详细信息。

（默认：'blogname'）

用法

<?php

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

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

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

?>

获取并显示自动类：`get_body_class()` & `body_class()`

这些非常流行的模板标签生成语义类并让我们回显或返回它们。他们还让我们添加额外的类名。

参数

两个模板标签只接受一个参数：

$class （可选 - 字符串或数组）：
要添加的额外 CSS 类名称。

（默认：空） EM>

用法

<?php

// Display the body class.
body_class();

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

?>

获取并显示导航菜单：`wp_nav_menu()`

此模板标签返回或显示导航菜单，这是 WordPress 的核心功能。您可能会在 2013 年或以后发布的所有新 WordPress 主题中看到此模板标签。

参数

此模板标记仅接受一个参数：

$args （可选—数组）：
以下参数的数组：
- 'menu'（字符串）：菜单的 ID、slug 或名称。
  （默认：空）
- 'menu_class'（字符串）：菜单的 UL 元素的 CSS 类。
  （默认：'menu'）
- 'menu_id'（字符串）：菜单的 UL 元素的 ID。
  （默认：菜单slug，递增）
- 'container' (string): 是否包裹UL，以及用什么包裹它。
  （默认：DIV）
- 'container_class'（字符串）：包装元素的 CSS 类。
  （默认：'menu-{menu slug}-container'）
- 'container_id'（字符串）：包装元素的 ID。
  （默认：空）
- 'fallback_cb' （回调或布尔值）：菜单不存在时运行的后备函数的名称。设置为 false 则不进行回退。
  （默认：'wp_page_menu'）
- 'before'（字符串）：链接文本之前的文本。
  （默认：空）
- 'after'（字符串）：链接文本后的文本。
  （默认：空）
- 'link_before'（字符串）：链接之前的文本。
  （默认：空）
- 'link_after'（字符串）：链接后的文本。
  （默认：空）
- 'echo' (boolean): 是否回显模板标签。
  (默认: TRUE)
- 'depth'（整数）：要包含多少级层次结构。
  （默认：0，表示所有级别）
- 'walker'（对象）：自定义 walker 类的实例。
  （默认：空）
- 'theme_location'（字符串）：要使用的主题位置。必须使用 register_nav_menu() 注册才能被用户选择。
  （默认：空）
- 'items_wrap'（字符串）：列表项应如何包装。
  （默认：<ul id="%1$s" class="%2$s ">%3$s</ul>)

用法

<?php

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

wp_nav_menu( $args );

?>

获取并显示页面标题：`wp_title()`

此模板标记返回或回显您页面的页面标题。

参数

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

$sep （可选 — 字符串）：
用作分隔符的文本。

（默认值：'»' ）
$echo （可选—布尔值）：
是否回显（TRUE）或返回（FALSE）标签。

（默认：TRUE）
$seplocation （可选—字符串）：
分隔符的位置和面包屑的方向。将其设置为“right”以反转面包屑。

（默认：空）

用法

<?php

wp_title( ' - ', true );

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

?>

获取并显示主页 URL：`get_home_url()` & `home_url()`

这些模板标签仅返回主页 URL。

参数

get_home_url() 接受三个参数：

$blog_id （可选—整数）：
博客的 ID。

（默认：NULL） >
$path （可选—字符串）：
附加到 URL 的可选路径。

（默认：空） >
$scheme （可选—字符串）：
提供主页 URL 上下文的方案（“http”、“https”或“相对”）。

（默认：NULL）

并且 home_url() 接受两个参数：

$path （可选—字符串）：
附加到 URL 的可选路径。

（默认：空） >
$scheme （可选—字符串）：
提供主页 URL 上下文的方案（“http”、“https”或“相对”）。

（默认：NULL）

不要将这两个函数误认为“一个返回输出，另一个显示它”——我知道我就是这么做的。区别有点奇怪： get_home_url() 函数返回特定博客的主页 URL，而 home_url() 函数返回当前站点.请记住：它们都没有回应任何内容！

用法

<?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' );

?>

获取并显示站点 URL：`get_site_url()` & `site_url()`

这些模板标签获取并回显“站点 URL”，即安装 WordPress 的地址。

参数

get_site_url() 接受三个参数：

$blog_id （可选 - 整数）：
博客的 ID。

（默认：当前站点）
$path （可选—字符串）：
附加到 URL 的可选路径。

（默认：空） >
$scheme （可选—字符串）：
提供主页 URL 上下文的方案（“http”、“https”或“相对”）。

（默认：正常或安全连接，取决于is_ssl()）

并且 site_url() 接受两个参数：

$path （可选—字符串）：
附加到 URL 的可选路径。

（默认：空） >
$scheme （可选—字符串）：
提供主页 URL 上下文的方案（“http”、“https”或“相对”）。

（默认：正常或安全连接，取决于is_ssl()）

与 home_url() 和 get_home_url() 一样，不要将这两个函数误认为“一个返回输出，另一个显示输出”。 get_site_url() 函数返回特定博客的站点 URL，而 site_url() 函数返回当前站点的站点 URL。请记住：它们都没有回应任何内容！

用法

<?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();

?>

获取当前站点的 ID：`get_current_blog_id()`

此模板标记仅返回多站点网络中当前站点的 ID。

参数

此模板标记不接受任何参数。

用法

<?php

get_current_blog_id();

?>

获取并显示管理面板的 URL：`get_admin_url()` & `admin_url()`

这些模板标签返回并显示您网站仪表板的 URL。

参数

get_admin_url() 接受三个参数：

$blog_id （可选 - 整数）：
博客的 ID。

（默认：当前站点）
$path （可选—字符串）：
附加到 URL 的可选路径。

（默认：空） >
$scheme （可选 - 字符串）：
要使用的方案。 “admin”遵循定义的方案（使用 is_ssl() 函数），但您可以通过设置此参数来覆盖它。接受“http”、“https”、“admin”、“rpc”、“login”和“login_post”。

（默认：“admin”）

并且 admin_url() 接受两个参数：

$path （可选—字符串）：
附加到 URL 的可选路径。

（默认：空） >
$scheme （可选 - 字符串）：
要使用的方案。 “admin”遵循定义的方案（使用 is_ssl() 函数），但您可以通过将此参数设置为“http”或“https”来覆盖它。

（默认值：“管理员')

用法

<?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' );

?>

获取并显示 Feed 类型的固定链接：`get_feed_link()` & `the_feed_link()`

这些模板标记返回并输出提要的永久链接。

参数

get_feed_link() 只接受一个参数：

$feed_type （可选 — 字符串）：
提要类型。

（默认：默认提要类型）

并且 the_feed_link() 接受两个参数：

$anchor （必需 — 字符串）：
链接显示的文本。

（默认：NULL） EM>
$feed_type （可选 — 字符串）：
提要类型。

（默认：默认提要类型）

用法

<?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' );

?>

使字符串结尾有或没有尾部斜杠：`user_trailingslashit()`

此模板标记检查您的永久链接结构，并在给定 URL 末尾添加尾部斜杠或删除现有的尾部斜杠。

参数

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

$string （必需 — 字符串）：
带或不带尾部斜杠的 URL。

（默认：NULL）
$type_of_url （已弃用 - 字符串）：
这在技术上并没有被弃用，但它没有在函数中使用，因此它没有任何效果。

用法

<?php

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

?>

获取自本周开始以来的天数：`calendar_week_mod()`

这个奇怪的模板标签获取自一周开始以来的天数。它基本上是一个“模运算”。

老实说，我不知道如何使用它或为什么使用它。如果您知道为什么存在此模板标签，请发表评论以告知我和我们的读者！

参数

此模板标记仅接受一个参数：

$number （必需 - 整数）：
自本周开始以来的天数。

（默认值：0） >

用法

<?php

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

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

?>

获取并显示日历：`get_calendar()`

还记得我们曾经放在博客侧边栏中的那些日历吗？此模板标记正是这样做的：它返回或显示日历。

参数

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

$initial （可选 - 布尔值）：
使用初始日历名称 (TRUE) 或不使用 (FALSE)。

（默认：TRUE）
$echo （可选—布尔值）：
是否回显（TRUE）或返回（FALSE）输出。

（默认：TRUE）

用法

<?php

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

// Display the calendar. 
get_calendar();

?>

结论

希望您喜欢最后一批模板标签。在下一部分，即系列结局中，我们将回顾我们所学到的内容并结束该系列。

如果您有任何问题、意见或更正，您可以在评论部分与我们分享您的想法。如果您喜欢这篇文章，请不要忘记与您的朋友分享！

以上がTuts+ テンプレートタグの第 8 バッチのガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

css html echo String Boolean Object NULL 常量 count include xml Filter 字符串 class Length Attribute JS number 对象 display ul http https rpc WordPress atom

声明：

この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。

前の記事：特定の条件に基づいて MySQL テーブルからデータを取得する PHP スクリプトを作成するにはどうすればよいですか?次の記事：特定の条件に基づいて MySQL テーブルからデータを取得する PHP スクリプトを作成するにはどうすればよいですか?

続きを見る

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

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

パラメータ

'order'

(デフォルト: 'ASC')

'limit'

用法

获取书签数据：get_bookmark()

参数

用法

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

参数

用法

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

参数

用法

获取并显示您网站的信息：get_bloginfo() & bloginfo()

参数

用法

获取并显示自动 类：get_body_class() & body_class()

参数

用法

获取并显示导航菜单：wp_nav_menu()

参数

用法

获取并显示页面标题：wp_title()

参数

用法

获取并显示主页 URL：get_home_url() & home_url()

参数

用法

获取并显示站点 URL：get_site_url() & site_url()

参数

用法

获取当前站点的 ID：get_current_blog_id()

参数

用法

获取并显示管理面板的 URL：get_admin_url() & admin_url()

参数

用法

获取并显示 Feed 类型的固定链接：get_feed_link() & the_feed_link()

参数

用法

使字符串结尾有或没有尾部斜杠：user_trailingslashit()

参数

用法

获取自本周开始以来的天数：calendar_week_mod()

参数

用法

获取并显示日历：get_calendar()

参数

用法

结论

関連記事

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

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

获取书签数据：`get_bookmark()`

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

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

获取并显示您网站的信息：`get_bloginfo()` & `bloginfo()`

获取并显示自动类：`get_body_class()` & `body_class()`

获取并显示导航菜单：`wp_nav_menu()`

获取并显示页面标题：`wp_title()`

获取并显示主页 URL：`get_home_url()` & `home_url()`

获取并显示站点 URL：`get_site_url()` & `site_url()`

获取当前站点的 ID：`get_current_blog_id()`

获取并显示管理面板的 URL：`get_admin_url()` & `admin_url()`

获取并显示 Feed 类型的固定链接：`get_feed_link()` & `the_feed_link()`

使字符串结尾有或没有尾部斜杠：`user_trailingslashit()`

获取自本周开始以来的天数：`calendar_week_mod()`

获取并显示日历：`get_calendar()`