Home > Article > Backend Development > Tuts+ Guide to the Eighth Batch of Template Tags

Tuts+ Guide to the Eighth Batch of Template Tags

WBOYOriginal: 2023-09-03 17:33:051531browse

In part eight of this series, we looked at the seventh batch of WordPress template tags. In Part 9, we'll take a look at the final batch of nearly 200 template tags. Throughout this tutorial we'll see template tags for bookmarks as well as other "miscellaneous" template tags.

Warning about Bookmarks: Starting with WordPress 3.5, “Bookmarks” are hidden by default in the admin panel. To use bookmarks, you need to install the link manager plugin.

Get and display the bookmark list: `wp_list_bookmarks()`

This template tag returns or echoes a list of bookmarks, which is an old feature of WordPress.

parameter

This template tag accepts only one parameter:

$args

(optional - array)

Array of the following parameters:

'orderby'

(Default: 'name')

'order'

(Default: 'ASC')

'limit'

(Default: -1 means all bookmarks)

'category'

(Default: ' ' means all categories)

'exclude_category'

(default:' ')

'category_name'

(default:'')

'hide_invisible'

(Default: 1)

'show_updated'

(Default: 0)

'echo'

(Default: 1)

'categorize'

(Default: 1)

'title_li'

<li>

(Default: "Bookmark")

'title_before'

(default:'

')

'title_after'

(default:'')

'class'

(Default: 'linkcat')

'category_before'

(default:'

'category_after'

(default:'

'category_orderby'

(default: "name")

'category_order'

(Default: 'ASC')

usage

<?php

$args = array(
    
    // Random order.
    'orderby' => 'rand',
    
    // Take just 5 bookmarks.
    'limit' => 5,
    
    // Take bookmarks from a specific category.
    'category_name' => 'Friends',
    
    // Don't echo.
    'echo' => 0,
    
    // Custom class.
    'class' => 'friends-bookmark-list'
    
);

$bookmarks_list = wp_list_bookmarks( $args );

?>

Get the array of all bookmarks: `get_bookmarks()`

This template tag returns an array of WordPress bookmarks.

parameter

This template tag accepts only one parameter:

$args

(optional - array)

Array of the following parameters:

'orderby'

(default: "name")

'order'

(Default: 'ASC')

'limit'

(Default value: -1 means all)

'category'

(default: empty)

'category_name'

（默认：空）

'hide_invisible'

（默认：1|TRUE）

'show_updated'

（默认：0|FALSE）

'include'

（默认：空）

'exclude'

（默认：空）

用法

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

'wpurl'

'description'

'rdf_url'

'rss_url'

'rss2_url'

'atom_url'

'comments_rss2_url'

'comments_atom_url'

'pingback_url'

'stylesheet_url'

'stylesheet_directory'

'template_directory'

'template_url'

'admin_email'

'charset'

'html_type'

'version'

'language'

'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'

（默认：空）

'menu_class'

UL

（默认：'menu'）

'menu_id'

UL

（默认：菜单slug，递增）

'container'

UL

（默认：DIV）

'container_class'

（默认：'menu-{menu slug}-container'）

'container_id'

（默认：空）

'fallback_cb'

（默认：'wp_page_menu'）

'before'

（默认：空）

'after'

（默认：空）

'link_before'

（默认：空）

'link_after'

（默认：空）

'echo'

(默认: TRUE)

'depth'

（默认：0，表示所有级别）

'walker'

（默认：空）

'theme_location'

（默认：空）

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

?>

结论

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

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

The above is the detailed content of Tuts+ Guide to the Eighth Batch of Template Tags. For more information, please follow other related articles on the PHP Chinese website!

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

Statement：

The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Previous article：How to write a PHP script to get data from a MySQL table based on certain conditions?Next article：How to write a PHP script to get data from a MySQL table based on certain conditions?

See more

Tuts+ Guide to the Eighth Batch of Template Tags

Get and display the bookmark list: wp_list_bookmarks()

parameter

')

usage

Get the array of all bookmarks: get_bookmarks()

parameter

用法

获取书签数据：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()

参数

用法

结论

Related articles

Get and display the bookmark list: `wp_list_bookmarks()`

Get the array of all bookmarks: `get_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()`