Tuts +模板标签指南：第六批

最新推荐文章于 2024-11-04 20:33:37 发布

cunjie3951

最新推荐文章于 2024-11-04 20:33:37 发布

阅读量176

点赞数

文章标签：列表 java javascript python html ViewUI

在本系列的第六部分中，我们介绍了第五批WordPress模板标签。在第七部分中，我们将通过第六批近200个模板标签。在整个教程中，我们将看到有关作者和附件的模板标签。

获取作者的帖子档案的URL： `get_author_posts_url()`

此模板标记返回指向作者的帖子档案的链接。

参量

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

$author_ID （必需-整数） ：
作者的ID。
（默认：当前作者）
$author_nicename （可选-字符串） ：
作者的“好名字”。（“好的名称”是可以在URL等中使用的“用户名”的净化版本。）
（默认：空）

用法

<?php

// Getting and displaying current author's archives link.
echo '<a href="' . get_author_posts_url() . '">' . __( 'Author\'s Archives', 'translation-domain' ) . '</a>';

?>

显示作者文章存档的链接： `the_author_posts_link()`

该模板标签输出指向作者帖子档案的链接。

参量

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

用法

<?php

the_author_posts_link();

?>

获取并显示作者的网站链接： `get_the_author_link()`和`the_author_link()`

这些模板标签返回或回显指向作者网站的链接。

参量

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

用法

<?php

// Echoes the author link.
the_author_link();

// Returns the author link.
$the_author_link = get_the_author_link();

?>

获取并显示作者的元数据： `get_the_author_meta()`和`the_author_meta()`

这些模板标签获取并显示作者的元数据。

参量

这两个模板标签都接受两个参数：

$field （必填-字符串） ：
要获取的字段（“登录名”，“ nicename”，“电子邮件”，“ url”，“已注册”或“状态”）。
（默认：空）
$user_ID （可选-整数） ：
用户的ID。
（默认：全局$authordata ）

用法

<?php

// Get current author's registration date.
get_the_author_meta( 'registered' );

// Display a specific author's email address.
the_author_meta( 'email', 9 );


?>

获取并显示作者的帖子数： `get_the_author_posts()`和`the_author_posts()`

这些模板标记可统计作者撰写的帖子数，并返回或显示结果。

参量

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

用法

<?php

the_author_posts();

?>

获取和显示作者列表： `wp_list_authors()`

此模板标记返回或显示在您的网站上撰写的作者列表。

参量

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

$args （可选-数组） ：
以下参数的数组：
- 'orderby' （字符串）：如何订购链接。接受“ user_nicename”，“ user_email”，“ user_url”，“ user_registered”，“ name”，“ display_name”，“ post_count”，“ ID”，“ meta_value”和“ user_login”。
  （默认：“名称”）
- 'order' （字符串）：是以升序（'ASC'）还是降序（'DESC'）排序商品。
  （默认值：“ ASC”）
- 'number' （整数）：要检索的作者数。
  （默认值： NULL表示没有限制）
- 'option_count' （布尔值）：是否在作者姓名旁边显示帖子计数。
  （默认： FALSE ）
- 'exclude_admin' （布尔值）：是否从列表中排除“ admin”（并非所有管理员，只有具有“ admin”用户名的管理员）。
  （默认： TRUE ）
- 'show_fullname' （布尔值）：是显示名字和姓氏（ TRUE ）还是显示名称（ FALSE ）。
  （默认： FALSE ）
- 'hide_empty' （布尔值）：隐藏没有帖子的作者。
  （默认： TRUE ）
- 'echo' （布尔值）：是回显输出（ TRUE ）还是返回输出（ FALSE ）。
  （默认： TRUE ）
- 'feed' （字符串）：如果设置为任何非空白值，则作者提要链接将出现在作者链接旁边。该值将是链接的锚文本。
  （默认：空）
- 'feed_type' （字符串）：提要的类型（'rss'，'rss2'，'atom'或'rdf'）。
  （默认：空）
- 'feed_image' （字符串）：覆盖锚文本并显示图像的图像路径。
  （默认：空）
- 'style' （字符串）：显示作者的样式-'list'生成无序列表，或'none'生成以逗号分隔的链接列表。
  （默认：“列表”）
- 'html' （布尔值）：是生成HTML还是纯文本。
  （默认： TRUE ）
- 'include' （字符串）：要包含的ID的逗号分隔列表。
  （默认：空）
- 'exclude' （字符串）：要排除的ID的逗号分隔列表。
  （默认：空）

用法

<?php

$args = array(

    // Order by registration date.
    'orderby' => 'user_registered',
    
    // Display post counts next to the names.
    'option_count' => true,
    
    // Show full names.
    'show_fullname' => true,
    
    // Show authors who doesn't have any posts.
    'hide_empty' => false,
    
    // Exclude Mike, he has betrayed us!
    'exclude' => 31
    
);

wp_list_authors( $args );

?>

获取和显示用户HTML下拉列表： `wp_dropdown_users()`

此模板标记返回或回显用户的下拉菜单（ <select> ）。

参量

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

$args （可选-数组） ：
以下参数的数组：
- 'show_option_all' （字符串）：显示为默认下拉菜单的文本。
  （默认：空）
- 'show_option_none' （字符串）：找不到用户时显示为下拉菜单默认值的文本。
  （默认：空）
- 'option_none_value' （整数或字符串）：未找到用户时用于'show_option_none'的值。
  （默认值：-1）
- 'hide_if_only_one_author' （字符串）：如果只有一位作者，是否隐藏下拉列表。
  （默认：空）
- 'orderby' （字符串）：用于订购用户的列。
  （默认值：“ display_name”）
- 'order' （字符串）：订购用户的方向。
  （默认值：“ ASC”）
- 'include' （数组或字符串）：要显示（但不包括其余部分）的用户ID的数组或列表，以逗号分隔。
  （默认：空）
- 'exclude' （数组或字符串）：要从列表中排除的用户ID的数组或列表，以逗号分隔。
  （默认：空）
- 'multi' （布尔值或整数）：是否跳过SELECT元素的ID。（如果要显示多个用户下拉菜单，则很有用。）
  （默认值：0）
- 'show' （字符串）：显示为列表项名称的内容。
  （默认值：“ display_name”）
- 'echo' （布尔或整数）：是显示还是检索内容。
  （默认值：1）
- 'selected' （整数）：默认情况下要选择的用户ID。
  （默认值：0）
- 'include_selected' （布尔值）：是否始终在下拉列表中包含所选的用户ID。
  （默认： FALSE ）
- 'name' （字符串）： SELECT元素的NAME属性值。
  （默认：“用户”）
- 'id' （字符串）： SELECT元素的ID。
  （默认：空）
- 'class' （字符串）： SELECT元素CSS类。
  （默认：空）
- 'blog_id' （可选；整数）：用于检索用户的博客的ID。
  （默认：当前博客）
- 'who' （字符串）：要查询的用户类型（接受“作者”或空字符串）。
  （默认：空）

用法

<?php

$args = array(
    
    // Order by registration date.
    'orderby' => 'user_registered',
    
    // Exclude admin.
    'exclude' => 1,
    
    // I'm going to use more than one users dropdown, so don't put a unique id.
    'multi' => 1,
    
    // Don't echo, just return the output.
    'echo' => 0,
    
    // NAME parameter of the SELECT tag.
    'name' => 'brands',
    
    // Get only authors.
    'who' => 'authors'
    
);

$brands_dropdown = wp_categories_dropdown( $args );

?>

获取并显示帖子的特色图片： `get_the_post_thumbnail()`和`the_post_thumbnail()`

好吧，标题说明了一切。

参量

get_the_post_thumbnail()接受三个参数：

$post_ID （可选-整数） ：
帖子的ID。
（默认：当前帖子）
$size （可选-字符串） ：
图片大小。
（默认值：“ post-thumbnail”）
$attr （可选-字符串或数组） ：
以下属性的数组：
- 'src'：图片来源
- 'class'：CSS类（或多个类，用空格分隔）
- 'alt'：替代文字

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

$size （可选-字符串） ：
图片大小。
（默认值：“ post-thumbnail”）
$attr （可选-字符串或数组） ：
以下属性的数组：
- 'src'：图片来源
- 'class'：CSS类（或多个类，用空格分隔）
- 'alt'：替代文字

用法

<?php

// Get the post's featured image with default options.
get_the_post_thumbnail();

// Display the post's featured image with custom options.
$attr = array(
    'class' => 'post-featured-image',
	'alt'   => __( 'Featured Image', 'translation-domain' )
);

the_post_thumbnail( 'medium', $attr );

?>

获取并显示附件页面的永久链接： `wp_get_attachment_link()`和`the_attachment_link()`

这些模板标记返回或显示附件的永久链接，因此可以在另一页中打开它。

参量

wp_get_attachment_link()接受五个参数：

$post_ID （可选-整数或对象） ：
帖子的ID。
（默认：当前帖子）
$size （可选-string） ：
图片大小。
（默认：“缩略图”）
$permalink （可选-布尔值） ：
是否包括永久链接。
（默认： FALSE ）
$icon （可选-布尔值） ：
是否包含图标。
（默认： FALSE ）
$text （可选-字符串或布尔值） ：
链接显示的文本。
（默认： FALSE ）

并且the_attachment_link()接受四个参数：

$post_ID （可选-整数或对象） ：
帖子的ID。
（默认：当前帖子）
$fullsize （可选-布尔值） ：
是否使用全尺寸图像。
（默认： FALSE ）
$deprecated （不建议使用-布尔值） ：
不建议使用此参数，您只需将其传递为TRUE或FALSE （与哪一个无关）。
$permalink （可选-布尔值） ：
是否包括永久链接。
（默认： FALSE ）

用法

<?php

// Get current attachment's link with a large image.
wp_get_attachment_link( $post->ID, 'large' );

// Display current attachment's link.
the_attachment_link();

?>

获取帖子的特色图片的ID： `get_post_thumbnail_id()`

此模板标签获取帖子的特色图片的ID。

参量

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

$post_ID （可选-整数） ：
从中检索缩略图ID的帖子ID。
（默认：当前帖子）

用法

<?php

// Get current post's featured image's id.
$featured_image_ID = get_post_thumbnail_id();

// Rcho a specific post's featured image's id.
echo get_post_thumbnail_id( 39 );

?>

获取附件图像： `wp_get_attachment_image()`

此模板标记返回给定附件图像HTML代码（ <img /> ）。

参量

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

$attachment_ID （可选-整数） ：
附件的ID。
（默认：当前附件）
$size （可选-字符串） ：
图像尺寸。
（默认：“缩略图”）
$icon （可选-布尔值） ：
是否包含图标。
（默认： FALSE ）
$attr （可选-字符串或数组） ：
以下属性的数组：
- 'src'：图片来源
- 'class'：CSS类（或多个类，用空格分隔）
- 'alt'：替代文字

用法

<?php

$attr = array(
    'class' => 'mytheme-attachment',
);

echo wp_get_attachment_image( $post->ID, 'thumbnail', false, $attr );

?>

获取附件图像URL： `wp_get_attachment_image_src()`

该模板标记返回您选择的附件图像的URL。

参量

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

$attachment_ID （可选-整数） ：
附件的ID。
（默认：当前附件）
$size （可选-字符串） ：
图像尺寸。
（默认：“缩略图”）
$icon （可选-布尔值） ：
是否包含图标。
（默认： FALSE ）

用法

<?php

// Get a specific attachment's url.
$special_attachment_url = wp_get_attachment_image_src( 199 );

?>

获取附件图像元数据： `wp_get_attachment_metadata()`

此模板标签返回给定附件的元数据。

参量

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

$attachment_ID （可选-整数） ：
附件的ID。
（默认值：0）
$unfiltered （可选-布尔值） ：
如果将其设置为TRUE ，则不会运行wp_get_attachment_metadata过滤器。
（默认： FALSE ）

用法

<?php

print_r( wp_get_attachment_metadata( $post->ID ) );

?>

获取同一帖子的下一个图像： `next_image_link()`

此模板标记返回图像附件页面的“下一张图像”链接。

参量

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

$size （可选-字符串） ：
图片大小。
（默认：“缩略图”）
$text （可选-字符串或布尔值） ：
链接显示的文本。
（默认： FALSE ）

用法

<?php

echo next_image_link( 'medium', __( 'Next Image', 'translation-domain' ) );

?>

获取同一文章的先前图像： `previous_image_link()`

此模板标记返回图像附件页面的“上一个图像”链接。

参量

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

$size （可选-字符串） ：
图片大小。
（默认：“缩略图”）
$text （可选-字符串或布尔值） ：
链接显示的文本。
（默认： FALSE ）

用法

<?php

echo previous_image_link( 'medium', __( 'Previous Image', 'translation-domain' ) );

?>

结论

希望您喜欢第六批模板标签。还有两个批次，敬请期待更多模板标签！

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

翻译自: https://code.tutsplus.com/tutorials/the-tuts-guide-to-template-tags-sixth-batch--cms-22580

cunjie3951

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

Tuts +模板标签指南：第六批

获取作者的帖子档案的URL： get_author_posts_url()

参量

用法

显示作者文章存档的链接： the_author_posts_link()

参量

用法

获取并显示作者的网站链接： get_the_author_link()和the_author_link()

参量

用法

获取并显示作者的元数据： get_the_author_meta()和the_author_meta()

参量

用法

获取并显示作者的帖子数： get_the_author_posts()和the_author_posts()

参量

用法

获取和显示作者列表： wp_list_authors()

参量

用法

获取和显示用户HTML下拉列表： wp_dropdown_users()

参量

用法

获取并显示帖子的特色图片： get_the_post_thumbnail()和the_post_thumbnail()

参量

用法

获取并显示附件页面的永久链接： wp_get_attachment_link()和the_attachment_link()

参量

用法

获取帖子的特色图片的ID： get_post_thumbnail_id()

参量

用法

获取附件图像： wp_get_attachment_image()

参量

用法

获取附件图像URL： wp_get_attachment_image_src()

参量

用法

获取附件图像元数据： wp_get_attachment_metadata()

参量

用法

获取同一帖子的下一个图像： next_image_link()

参量

用法

获取同一文章的先前图像： previous_image_link()

参量

用法

结论

获取作者的帖子档案的URL： `get_author_posts_url()`

显示作者文章存档的链接： `the_author_posts_link()`

获取并显示作者的网站链接： `get_the_author_link()`和`the_author_link()`

获取并显示作者的元数据： `get_the_author_meta()`和`the_author_meta()`

获取并显示作者的帖子数： `get_the_author_posts()`和`the_author_posts()`

获取和显示作者列表： `wp_list_authors()`

获取和显示用户HTML下拉列表： `wp_dropdown_users()`

获取并显示帖子的特色图片： `get_the_post_thumbnail()`和`the_post_thumbnail()`

获取并显示附件页面的永久链接： `wp_get_attachment_link()`和`the_attachment_link()`

获取帖子的特色图片的ID： `get_post_thumbnail_id()`

获取附件图像： `wp_get_attachment_image()`

获取附件图像URL： `wp_get_attachment_image_src()`

获取附件图像元数据： `wp_get_attachment_metadata()`

获取同一帖子的下一个图像： `next_image_link()`

获取同一文章的先前图像： `previous_image_link()`