模板标签：Tuts+ 指南继续
PHPz
发布时间：2023-08-31 18:17:05
|
1235人浏览过
|
来源于php中文网
原创
在本系列的第二部分中，我们介绍了第一批 WordPress 模板标签。在第三部分中，我们将介绍第二批近 200 个模板标签。在整个教程中，我们将看到有关分类法和术语的模板标签。
获取类别的描述：category_description()
此模板标记返回类别的描述。
参数
此模板标记仅接受一个参数：
-
$category_ID （可选—整数）：类别ID。
（默认：查询的类别） >
用法
获取标签的描述：tag_description()
此模板标记返回标记的描述。
参数
此模板标记仅接受一个参数：
-
$tag_ID （可选 - 整数）：标签的 ID。
（默认：当前标签）
用法
获取术语的描述：term_description()
此模板标记仅返回术语的描述。
参数
此模板标记接受两个参数：
-
$term_ID （可选 - 整数）：术语的 ID。
（默认：当前术语）
-
$taxonomy （可选—字符串）：术语的分类。
（默认：'post_tag'） >
用法
获取并显示类别档案的页面标题：single_cat_title()
此模板标记返回并显示类别的标题，以便在页面标题中使用。
参数
此模板标记接受两个参数：
用法
获取并显示标签档案的页面标题：single_tag_title()
此模板标记返回并显示标记的标题，以便在页面标题中使用。
参数
此模板标记接受两个参数：
用法
获取并显示术语档案的页面标题：single_term_title()
此模板标记返回并显示在页面标题中使用的术语标题。
参数
此模板标记接受两个参数：
用法
获取并显示帖子的类别：get_the_category_list() & the_category()
这些模板标签获取并输出分配给帖子的类别。
参数
两个模板标签都接受三个参数：
唱鸭
音乐创作全流程的AI自动作曲工具，集 AI 辅助作词、AI 自动作曲、编曲、混音于一体
下载
用法
获取并显示提要帖子的类别： get_the_category_rss() & the_category_rss()
这些模板标签使分配给帖子的类别准备好供提要并返回或显示它。
参数
两个模板标签只接受一个参数：
-
$feed_type （可选 - 字符串）：提要类型。
（默认：默认提要类型）
用法
获取并显示帖子的标签：get_the_tag_list() & the_tags()
这些模板标签返回或显示您帖子的标签。
参数
两个模板标签都接受三个参数：
用法
' . __( 'Tags: ', 'translation-domain' ) , ' · ', '
' );
?>
获取并显示帖子的条款：get_the_term_list() & the_terms()
这些模板标签获取并回显为帖子分配的术语列表。
参数
两个模板标签都接受五个参数：
-
$post_ID （可选 - 整数）：帖子 ID。
（默认：当前帖子）
-
$taxonomy （必需 - 字符串）：显示其术语的分类法。
（默认：空）
-
$before （可选—字符串）：在输出之前显示的文本或 HTML 代码。
（默认：空）
-
$sep （可选 — 字符串）：分隔符文本。
（默认：', '）
-
$after （可选—字符串）：输出后显示的文本或 HTML 代码。
（默认：空）
用法
ID, 'available-brands' );
// Display current post's terms from the "Available Brands" taxonomy with some customization.
the_terms( $post->ID, 'available-brands', __( 'Available Brands: ', 'translation-domain' ), ' - ' );
?>
显示帖子的分类法：the_taxonomies()
此模板标记显示分类法以及与这些分类法关联的术语。
参数
此模板标记仅接受一个参数：
用法
'',
'sep' => ', ',
'after' => '
'
);
the_taxonomies( $args );
?>
获取并显示“编辑标签”链接：get_edit_tag_link() & edit_tag_link()
这些模板标记返回或回显“编辑此标记”链接，供您在模板中使用。
参数
get_edit_tag_link() 接受两个参数：
-
$tag_ID （必需 - 整数）：标签的 ID。
（默认：NULL） >
-
$taxonomy （可选—字符串）：分类法的类型。
（默认：'post_tag'）
而 edit_tag_link() 接受四个参数：
-
$link （可选—字符串）：链接显示的文本。
（默认：“编辑此”）
-
$before （可选—字符串）：在输出之前显示的文本或 HTML 代码。
（默认：空）
-
$after （可选—字符串）：输出后显示的文本或 HTML 代码。
（默认：空）
-
$tag （必需—对象）：标记对象。
（默认：NULL）
用法
', '' );
// Displaying a specific tag's "edit tag" link.
edit_tag_link( __( 'Edit', 'translation-domain' ), '', '', 11 );
?>
获取并显示类别列表：wp_list_categories()
此模板标记返回或显示任何类型分类法中的类别或术语列表。
参数
此模板标记仅接受一个参数：
-
$args （可选—数组）：以下参数的数组：
-
'show_option_all'（字符串）：如果将其设置为非空值，则显示主页（或设置>阅读中设置的“帖子”页面）的链接。该值将是链接的锚文本。（默认：空）
-
'show_option_none'（字符串）：如果没有任何类别，则显示文本。（默认：“无类别”）
-
'orderby'（字符串）：如何对链接进行排序。接受“name”、“ID”、“slug”、“count”和“term_group”。（默认：“name”）
-
'order'（字符串）：是否按升序（'ASC'）或降序（'DESC'）排序项目。（默认：'ASC'）
-
'style'（字符串）：显示类别的样式 - 'list' 生成无序列表或 'none' 生成以
（默认：'列表'）
-
'show_count'（整数）：在每个类别链接旁边显示帖子计数。（默认值：0）
-
'hide_empty'（整数）：是否隐藏空类别。（默认：1）
-
'use_desc_for_title'（整数）：使用描述作为链接的“标题”属性。（默认：1）
-
'child_of'（整数）：仅显示类别给定 ID 的子级。（默认值：0）
-
'feed'（字符串）：如果设置为任何非空值，类别提要链接将出现在类别链接旁边。该值将是链接的锚文本。（默认：空）
-
'feed_type'（字符串）：提要类型（'rss'、'rss2'、'atom' 或 'rdf'）。（默认：空）
-
'feed_image'（字符串）：覆盖锚文本并显示图像的图像路径。（默认：空）
-
'exclude'（字符串）：要排除的以逗号分隔的类别 ID 列表。（默认：空）
-
'exclude_tree' (string): 与“exclude”相同，但如果“hierarchical”参数设置为 1，则必须使用这个（默认：空）
-
'current_category'（整数）：在合适的情况下添加“current-cat”类。（默认：0）
-
'hierarchical'（整数）：是否显示具有分层顺序的项目。（默认：1）
-
'title_li'（字符串）：使用 （默认：“类别”）
-
'echo'（整数）：是否回显输出（1）或返回它（0）。（默认：1）
-
'depth'（整数）：最大深度。（默认：0）
-
'taxonomy'（字符串）：要列出的分类法。（默认：'category'）
用法
__( 'All Posts', 'translation-domain' ),
// Order by post count.
'orderby' => 'count',
// Show post count.
'show_count' => 1,
// Show feed links.
'feed' => 'Feed',
// Remove title_li.
'title_li' => ''
);
wp_list_categories( $args );
?>
获取并显示 HTML 类别下拉列表：wp_dropdown_categories()
此模板标记返回或回显您选择的分类中的类别或术语的下拉菜单 (
参数
此模板标记仅接受一个参数：
-
$args （可选—数组）：以下参数的数组：
-
'show_option_all'（字符串）：用于显示所有类别/分类的文本。（默认：空）
-
'show_option_none'（字符串）：显示不显示类别/分类的文本。（默认：空）
-
'option_none_value'（混合）：未选择类别/分类时使用的值。（默认值：-1）
-
'orderby'（字符串）：用于对类别/分类进行排序的列。（默认：'ID'）
-
'order'（字符串）：按什么方向排序类别/分类。（默认：'ASC'）
-
'show_count'（布尔值或整数）：是否显示类别/分类中有多少帖子。（默认：0）
-
'hide_empty'（布尔值或整数）：是否隐藏没有附加任何帖子的类别/分类法。（默认：1）
-
'child_of'（整数）：显示给定 ID 的后代的所有类别。（默认值：0）
-
'exclude'（字符串）：要从列表中排除的以逗号分隔的类别/分类 ID 列表。（默认：空）
-
'echo'（布尔值或整数）：是否显示或检索内容。（默认：1）
-
'depth'（整数）：最大深度。（默认：0）
-
'tab_index'（整数）：SELECT 元素的选项卡索引。（默认值：0）
-
'name'（字符串）：SELECT 元素的 NAME 属性值。（默认：'cat'）
-
'id'（字符串）：SELECT 元素的 ID。（默认：空）
-
'class'（字符串）：SELECT 元素的 CSS 类。（默认：'postform'）
-
'selected'（整数）：默认选择的类别/分类ID。（默认：0）
-
'taxonomy'（字符串）：要检索的分类法的名称。（默认：'category'）
用法
__( 'Nothing!', 'translation-domain' ),
'orderby' => 'title',
'show_count' => 1,
'echo' => 0,
'name' => __( 'brands', 'translation-domain' ),
'taxonomy' => __( 'available-brands', 'translation-domain' )
);
$brands_dropdown = wp_categories_dropdown( $args );
?>
获取并显示标签云：wp_tag_cloud()
此模板标签返回或显示根据您选择的分类法（默认为标签）生成的术语云。
参数
此模板标记仅接受一个参数：
-
$args （可选—数组）：以下参数的数组：
-
'smallest'（整数）：最小文本大小。（默认：8）
-
'largest'（整数）：最大文本大小。（默认：22）
-
'unit'（字符串）：文本大小单位。（默认：'pt'）
-
'number'（字符串）：返回多少个标签（默认：45）
-
'format'（字符串）：如何返回标签列表 - 'flat' 表示以空格分隔的平面列表，'list' 表示 HTML 无序列表，'array' 表示 PHP 数组。 （默认：'平坦'）
-
'separator'（字符串）：分隔符文本。（默认：“\n”）
-
'orderby'（字符串）：如何按（'name' 或 'count'）对标签进行排序。（默认：'name'）
-
'order'（字符串）：是否按升序（'ASC'）或降序（'DESC'）排序项目。（默认：'ASC'）
-
'include'（数组）：要包含的 ID 数组。（默认：空）
-
'exclude'（数组）：要排除的 ID 数组。（默认：空）
-
'taxonomy'（字符串）：从中获取术语的分类法。（默认：'post_tag'）
-
'link' (string): 'view' 为前端查看， 'edit' 为后端编辑链接。与“post_type”参数一起使用。（默认：“view”）
-
'post_type'（字符串）：如果'link'参数设置为'edit'，则必须将'post_type'设置为帖子类型，以设置“编辑链接”列表中的帖子类型。（默认：空）
-
'echo' (boolean): 是否回显模板标签。(默认: TRUE)
用法
10,
'largest' => 32,
// Get only 20 tags.
'number' => 20,
// Order by term popularity.
'orderby' => 'count',
// Custom taxonomy.
'taxonomy' => 'brands',
// Return output instead of echoing.
'echo' => 0
);
$tag_cloud = wp_tag_cloud( $args );
?>
获取自定义生成的标签云：wp_generate_tag_cloud()
此模板标签返回标签云，但这一次，您可以选择自己的标签。
参数
此模板标记接受两个参数：
-
$tags （必需 — 数组）：标签列表的数组。
（默认：NULL）
-
$args （可选—数组）：以下参数的数组：
用法
10,
'largest' => 36,
'orderby' => 'count'
);
wp_generate_tag_cloud( $tags, $args );
?>
结论
希望您喜欢第二批模板标签。还有六批要进行，请继续关注更多模板标签！
如果您有任何问题、意见或更正，您可以在评论部分与我们分享您的想法。如果您喜欢这篇文章，请不要忘记与您的朋友分享！
