第八批模板标签的Tuts+指南

在本系列的第八部分中，我们浏览了第七批 WordPress 模板标签。在第九部分中，我们将浏览最后一批近 200 个模板标签。在整个教程中，我们将看到有关书签的模板标签以及其他“杂项”模板标签。

有关书签的警告：从 WordPress 3.5 开始，“书签”默认在管理面板中隐藏。要使用书签，您需要安装链接管理器插件。

获取并显示书签列表：wp_list_bookmarks()

此模板标记返回或回显书签列表，这是 WordPress 的一项旧功能。

参数

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

<li> $args （可选—数组）：

以下参数的数组：

<li> 'orderby'（字符串）：如何排序书签。接受“名称”、“link_id”、“url”、“目标”、“描述”、“所有者”（添加书签的用户）、“评级”、“更新”（更新日期）、“rel”（XFN）书签关系）、'notes'、'rss'、'length'（书签名称长度）、'rand'（随机）。

（默认：'name'）

<li> 'order'（字符串）：是否按升序（'ASC'）或降序（'DESC'）排序项目。

（默认：'ASC'）

<li> 'limit'（整数）：要显示的项目数。

（默认：-1 表示所有书签）

<li> 'category'（字符串）：以逗号分隔的类别 ID，从中获取项目。

（默认值：' ' 表示所有类别）

<li> 'exclude_category'（字符串）：要排除的书签类别 ID。

（默认：' '）

<li> 'category_name'（字符串）：显示书签的类别名称（覆盖'category'）。

（默认：''）

<li> 'hide_invisible'（整数）：是否隐藏不可见链接或显示它们。

（默认：1）

<li> 'show_updated'（整数）：是否显示最后更新的时间戳。

（默认：0）

<li> 'echo'（整数）：是否回显输出（1）或返回它（0）。

（默认：1）

<li> 'categorize'（整数）：是否按类别对书签进行分组（1）或不按类别（0）。

（默认：1）

<li> <code>'title_li'（字符串）：使用 <code>'title_li'（字符串）：使用 <li> 标记包装输出，并在书签列表之前显示标题。您可能希望将其设置为空字符串并禁用换行。

（默认：“书签”）

<li> 'title_before'（字符串）：在每个标题之前添加的 HTML 代码。

（默认：'

'）

<li> 'title_after'（字符串）：在每个标题后添加的 HTML 代码。

（默认：''）

<li> 'class'（字符串）：添加到每个类别的 CSS 类名称。

（默认：'linkcat'）

<li> 'category_before'（字符串）：在每个类别之前添加的 HTML 代码。

（默认：'

• '）
<li> 'category_after'（字符串）：在每个类别之后添加的 HTML 代码。

（默认：'

'）
<li> 'category_orderby'（字符串）：如何对类别进行排序。接受“name”、“id”、“slug”和“count”。

（默认：“name”）

<li> 'category_order'（字符串）：是否按升序（'ASC'）或降序（'DESC'）对类别进行排序。

（默认：'ASC'）

用法

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

此模板标记返回 WordPress 书签的数组。

参数

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

<li> $args （可选—数组）：

以下参数的数组：

<li> 'orderby'（字符串）：如何对链接进行排序。接受“名称”、“ID”、“标题”、“日期”等帖子字段。

（默认：“名称”） <li> 'order'（字符串）：是否按升序（'ASC'）或降序（'DESC'）排序项目。

（默认：'ASC'） <li> 'limit'（整数）：要显示的项目数。

（默认值：-1 表示全部） <li> 'category'（字符串）：以逗号分隔的类别 ID，从中获取项目。

（默认：空） <li> 'category_name'（字符串）：从中获取项目的类别名称。

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

（默认：1|TRUE） <li> 'show_updated'（整数或布尔值）：是否显示书签上次更新时间。

（默认：0|FALSE） <li> 'include'（字符串）：要包含的以逗号分隔的 ID 列表。

（默认：空） <li> '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()

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

参数

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

<li> $bookmark （必需 - 混合）：

书签 ID 或对象。

（默认：NULL） > <li> $output （可选 - 字符串）：

OBJECT、ARRAY_N 或 ARRAY_A 常量。

（默认：OBJECT） <li> $filter （可选—字符串）：

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

（默认：“raw”）

用法

<?php

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

?>

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

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

参数

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

<li> $field （必填—字符串）：

字段名称。

（默认：NULL） <li> $bookmark （必需 — 整数）：

书签 ID。

（默认：NULL） <li> $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() 只接受一个参数：

<li> $bookmark_id （必需 - 整数）：

书签的 ID。

（默认：0）

而 edit_bookmark_link() 接受四个参数：

<li> $text （可选—字符串）：

显示链接的文本。

（默认：“编辑此”） <li> $before （可选—字符串）：

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

（默认：空） <li> $after （可选—字符串）：

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

（默认：空） <li> $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();

?>