模板标签：Tuts+ 指南继续-php教程-PHP中文网

模板标签：tuts+ 指南继续

在本系列的第二部分中，我们介绍了第一批 WordPress 模板标签。在第三部分中，我们将介绍第二批近 200 个模板标签。在整个教程中，我们将看到有关分类法和术语的模板标签。

获取类别的描述：category_description()

此模板标记返回类别的描述。

参数

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

$category_ID （可选—整数）：
类别ID。

（默认：查询的类别） >

用法

<?php

$cat_desc = get_category_description( 15 );

?>

登录后复制

获取标签的描述：tag_description()

此模板标记返回标记的描述。

参数

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

$tag_ID （可选 - 整数）：
标签的 ID。

（默认：当前标签）

用法

<?php

// Display the description of current tag.
echo tag_description();

// Get the description of a specific tag.
$special_tag_desc = tag_description( 42 );

?>

登录后复制

获取术语的描述：term_description()

此模板标记仅返回术语的描述。

参数

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

$term_ID （可选 - 整数）：
术语的 ID。

（默认：当前术语）
$taxonomy （可选—字符串）：
术语的分类。

（默认：'post_tag'） >

用法

<?php

// Display the description of current term.
echo term_description();

// Get the description of a specific term from a specific taxonomy.
$special_term_desc = term_description( 14, 'laptop_inches' );

?>

登录后复制

获取并显示类别档案的页面标题：single_cat_title()

此模板标记返回并显示类别的标题，以便在页面标题中使用。

参数

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

$prefix （可选—字符串）：
标题前缀。

（默认：空）
$echo （可选 - 布尔值）：
是否 echo (TRUE) 或返回 (FALSE) 标签。

（默认：TRUE）

用法

<?php

// Display the category title with a prefix.
single_cat_title( 'Category: ' );

// Get the category title.
$cat_title = single_cat_title( '', false );

?>

登录后复制

获取并显示标签档案的页面标题：single_tag_title()

此模板标记返回并显示标记的标题，以便在页面标题中使用。

参数

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

$prefix （可选—字符串）：
标题前缀。

（默认：空）
$echo （可选 - 布尔值）：
是否 echo (TRUE) 或返回 (FALSE) 标签。

（默认：TRUE）

用法

<?php

// Display the tag title with a prefix.
single_tag_title( 'Tag Archive: ' );

// Get the tag title.
$tag_title = single_tag_title( '', false );

?>

登录后复制

获取并显示术语档案的页面标题：single_term_title()

此模板标记返回并显示在页面标题中使用的术语标题。

参数

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

$prefix （可选—字符串）：
标题前缀。

（默认：空）
$echo （可选 - 布尔值）：
是否 echo (TRUE) 或返回 (FALSE) 标签。

（默认：TRUE）

用法

<?php

// Display the term title with a prefix.
single_term_title( 'Term Archive: ' );

// Get the term title.
$term_title = single_term_title( '', false );

?>

登录后复制

获取并显示帖子的类别：get_the_category_list() & the_category()

这些模板标签获取并输出分配给帖子的类别。

参数

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

$separator （可选—字符串）：
分隔符文本。

（默认：空—如果此参数为空，则函数将返回并显示类别的无序列表）
$parents （可选—字符串）：
如何显示父类别（“多个”、“单个”或空）。

（默认：空）
$post_ID （可选 - 整数）：
帖子 ID。

（默认：当前帖子）

用法

<?php

// Get an unordered list of current post's categories.
get_the_category_list();

// Display current post's categories separated by commas and with their parents (if there are any).
the_category( ', ', 'multiple' );

?>

登录后复制

获取并显示提要帖子的类别： get_the_category_rss() & the_category_rss()

这些模板标签使分配给帖子的类别准备好供提要并返回或显示它。

参数

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

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

（默认：默认提要类型）

用法

<?php

// Get feed items of categories for the default feed type.
get_the_category_rss();

// Display feed items of categories for atom feeds.
the_category_rss( 'atom' );

?>

登录后复制

获取并显示帖子的标签：get_the_tag_list() & the_tags()

这些模板标签返回或显示您帖子的标签。

参数

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

$before （可选 — 字符串）：
在输出之前显示的文本或 HTML 代码。

（默认值：为空get_the_tag_list() 和 '标签：' the_tags())
$sep （可选 — 字符串）：
用作分隔符的文本。

（默认值： get_the_tag_list() 和 ', ' 表示 the_tags())
$after （可选—字符串）：
输出后显示的文本或 HTML 代码。

（默认：空）

用法

<?php

// Get a plain list of tag links.
get_the_tag_list();

// Display the tags with custom parameters.
the_tags( '<div class="mytheme-tags">' . __( 'Tags: ', 'translation-domain' ) , ' &middot; ', '</div>' );

?>

登录后复制

获取并显示帖子的条款：get_the_term_list() & the_terms()

这些模板标签获取并回显为帖子分配的术语列表。

参数

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

$post_ID （可选 - 整数）：
帖子 ID。

（默认：当前帖子）
$taxonomy （必需 - 字符串）：
显示其术语的分类法。

（默认：空）
$before （可选—字符串）：
在输出之前显示的文本或 HTML 代码。

（默认：空）
$sep （可选 — 字符串）：
分隔符文本。

（默认：', '）
$after （可选—字符串）：
输出后显示的文本或 HTML 代码。

（默认：空）

用法

<?php

// Getting current post's terms from the "Available Brands" taxonomy.
get_the_term_list( $post->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()

此模板标记显示分类法以及与这些分类法关联的术语。

参数

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

$args （可选—数组）：
以下参数的数组：
- 'post'（整数）：帖子 ID。
  （默认：0）
- 'before'（字符串）：在输出之前添加的 HTML 代码。
  （默认：空）
- 'sep'（字符串）：分隔符文本。
  （默认：' '）
- 'after'（字符串）：在输出后添加的 HTML 代码。
  （默认：空）
- 'template'（字符串）：用于显示分类术语的模板。
  （默认值：'%s: %l。'，其中 %s 是分类标签%t 是术语链接列表）

用法

<?php

$args = array(
    'before' => '<div class="taxonomies">',
	'sep'    => ', ',
	'after'  => '</div>'
);

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）

用法

<?php

// Retrieving the current tag's "edit tag" link.
$edit_tag_link = get_edit_tag_link();

// Retrieving a specific term's "edit term" link.
$edit_tag_link = get_edit_tag_link( 4, 'keyboard-brand' );

// Displaying the current tag's "edit tag" link.
edit_tag_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );

// 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' 生成以
  s 分隔的链接列表。
  （默认：'列表'）
- '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'）

用法

<?php

$args = array(
    
    // Show an "All Posts" link.
	'show_option_all' => __( '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'）

用法

<?php

$args = array(
    'show_option_none' => __( '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)

用法

<?php

$args = array(
    
	// Smallest & largest font sizes.
	'smallest' => 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 （可选—数组）：
以下参数的数组：
- 'smallest'（整数）：最小文本大小。
  （默认：8）
- 'largest'（整数）：最大文本大小。
  （默认：22）
- 'unit'（字符串）：文本大小单位。
  （默认：'pt'）
- 'number'（字符串）：返回多少个标签
  （默认：0）
- 'format'（字符串）：如何返回标签列表 - 'flat' 表示以空格分隔的平面列表，'list' 表示 HTML 无序列表，'array' 表示 PHP 数组。
  （默认：'平坦'）
- 'separator'（字符串）：分隔符文本。
  （默认：“\n”）
- 'orderby'（字符串）：如何按（'name' 或 'count'）对标签进行排序。
  （默认：'name'）
- 'order'（字符串）：是否按升序（'ASC'）或降序（'DESC'）排序项目。
  （默认：'ASC'）
- 'topic_count_text'（字符串）：这是 _n_noop() 的 noooped 复数形式，用于生成标签链接工具提示的文本。
  （默认：NULL） EM>
- 'topic_count_text_callback'（字符串）：这是回调函数，它给出带有该标签的帖子的计数，返回标签链接工具提示的文本。
  （默认： NULL)
- 'topic_count_scale_callback'（字符串）：这是与 'smallest' 和 'largest' 参数一起使用的回调函数，用于计算生成标签的字体大小。
  （默认：'default_topic_count_scale'）
- 'filter'（整数）：如果设置为0，函数将不会通过同名的过滤器。
  （默认：1）

用法

<?php

// Get an array of the tags from current post.
$tags = get_the_tags( '', ', ', '' );

// Set arguments.
$args = array(
    'smallest' => 10,
	'largest'  => 36,
	'orderby'  => 'count'	
);

wp_generate_tag_cloud( $tags, $args );

?>

登录后复制