在本系列的第二部分中,我們介紹了第一批 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。
(預設:目前術語)
<li>$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
(可選—字串):標題前綴。
(預設:空)
<li>$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
(可選—字串):標題前綴。
(預設:空)
<li>$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
(可選—字串):標題前綴。
(預設:空)
<li>$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
(可選—字串):分隔符號文字。
(預設:空—如果此參數為空,則函數將傳回並顯示類別的無序列表)
<li>$parents
(可選—字串):如何顯示父類別(「多個」、「單一」或空)。
(預設:空)
<li>$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' ) , ' · ', '</div>' ); ?>
get_the_term_list()
& the_terms()
这些模板标签获取并回显为帖子分配的术语列表。
两个模板标签都接受五个参数:
$post_ID
(可选 - 整数):帖子 ID。
(默认:当前帖子)
<li>$taxonomy
(必需 - 字符串):显示其术语的分类法。
(默认:空)
<li>$before
(可选—字符串):在输出之前显示的文本或 HTML 代码。
(默认:空)
<li>$sep
(可选 — 字符串):分隔符文本。
(默认:', ')
<li>$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)
<li>'before'
(字符串):在输出之前添加的 HTML 代码。(默认:空)
<li>'sep'
(字符串):分隔符文本。(默认:' ')
<li>'after'
(字符串):在输出后添加的 HTML 代码。(默认:空)
<li>'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
(可选—字符串):链接显示的文本。
(默认:“编辑此”)
<li>$before
(可选—字符串):在输出之前显示的文本或 HTML 代码。
(默认:空)
<li>$after
(可选—字符串):输出后显示的文本或 HTML 代码。
(默认:空)
<li>$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'
(字符串):如果将其设置为非空值,则显示主页(或设置>阅读中设置的“帖子”页面)的链接。该值将是链接的锚文本。(默认:空)
<li>'show_option_none'
(字符串):如果没有任何类别,则显示文本。(默认:“无类别”)
<li>'orderby'
(字符串):如何对链接进行排序。接受“name”、“ID”、“slug”、“count”和“term_group”。(默认:“name”)
<li>'order'
(字符串):是否按升序('ASC')或降序('DESC')排序项目。(默认:'ASC')
<li>'style'
(字符串):显示类别的样式 - 'list' 生成无序列表或 'none' 生成以 <br>
s 分隔的链接列表。(默认:'列表')
<li>'show_count'
(整数):在每个类别链接旁边显示帖子计数。(默认值:0)
<li>'hide_empty'
(整数):是否隐藏空类别。(默认:1)
<li>'use_desc_for_title'
(整数):使用描述作为链接的“标题”属性。(默认:1)
<li>'child_of'
(整数):仅显示类别给定 ID 的子级。(默认值:0)
<li>'feed'
(字符串):如果设置为任何非空值,类别提要链接将出现在类别链接旁边。该值将是链接的锚文本。(默认:空)
<li>'feed_type'
(字符串):提要类型('rss'、'rss2'、'atom' 或 'rdf')。(默认:空)
<li>'feed_image'
(字符串):覆盖锚文本并显示图像的图像路径。(默认:空)
<li>'exclude'
(字符串):要排除的以逗号分隔的类别 ID 列表。(默认:空)
<li>'exclude_tree'
(string): 与“exclude”相同,但如果“hierarchical”参数设置为 1,则必须使用这个(默认:空)
<li>'current_category'
(整数):在合适的情况下添加“current-cat”类。(默认:0)
<li>'hierarchical'
(整数):是否显示具有分层顺序的项目。(默认:1)
<li>'title_li'
(字符串):使用 <li>
标签包装输出,并在类别列表之前显示标题。您可能希望将其设置为空字符串并禁用换行。(默认:“类别”)
<li>'echo'
(整数):是否回显输出(1)或返回它(0)。(默认:1)
<li>'depth'
(整数):最大深度。(默认:0)
<li>'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 ); ?>
wp_dropdown_categories()
此模板标记返回或回显您选择的分类中的类别或术语的下拉菜单 (<select></select>
)。
此模板标记仅接受一个参数:
$args
(可选—数组):以下参数的数组:
'show_option_all'
(字符串):用于显示所有类别/分类的文本。(默认:空)
<li>'show_option_none'
(字符串):显示不显示类别/分类的文本。(默认:空)
<li>'option_none_value'
(混合):未选择类别/分类时使用的值。(默认值:-1)
<li>'orderby'
(字符串):用于对类别/分类进行排序的列。(默认:'ID')
<li>'order'
(字符串):按什么方向排序类别/分类。(默认:'ASC')
<li>'show_count'
(布尔值或整数):是否显示类别/分类中有多少帖子。(默认:0)
<li>'hide_empty'
(布尔值或整数):是否隐藏没有附加任何帖子的类别/分类法。(默认:1)
<li>'child_of'
(整数):显示给定 ID 的后代的所有类别。(默认值:0)
<li>'exclude'
(字符串):要从列表中排除的以逗号分隔的类别/分类 ID 列表。(默认:空)
<li>'echo'
(布尔值或整数):是否显示或检索内容。(默认:1)
<li>'depth'
(整数):最大深度。(默认:0)
<li>'tab_index'
(整数):SELECT
元素的选项卡索引。(默认值:0)
<li>'name'
(字符串):SELECT
元素的 NAME
属性值。(默认:'cat')
<li>'id'
(字符串):SELECT
元素的 ID。(默认:空)
<li>'class'
(字符串):SELECT
元素的 CSS 类。(默认:'postform')
<li>'selected'
(整数):默认选择的类别/分类ID。(默认:0)
<li>'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)
<li>'largest'
(整数):最大文本大小。(默认:22)
<li>'unit'
(字符串):文本大小单位。(默认:'pt')
<li>'number'
(字符串):返回多少个标签(默认:45)
<li>'format'
(字符串):如何返回标签列表 - 'flat' 表示以空格分隔的平面列表,'list' 表示 HTML 无序列表,'array' 表示 PHP 数组。 (默认:'平坦')
<li>'separator'
(字符串):分隔符文本。(默认:“\n”)
<li>'orderby'
(字符串):如何按('name' 或 'count')对标签进行排序。(默认:'name')
<li>'order'
(字符串):是否按升序('ASC')或降序('DESC')排序项目。(默认:'ASC')
<li>'include'
(数组):要包含的 ID 数组。(默认:空)
<li>'exclude'
(数组):要排除的 ID 数组。(默认:空)
<li>'taxonomy'
(字符串):从中获取术语的分类法。(默认:'post_tag')
<li>'link'
(string): 'view' 为前端查看, 'edit' 为后端编辑链接。与“post_type”参数一起使用。(默认:“view”)
<li>'post_type'
(字符串):如果'link'参数设置为'edit',则必须将'post_type'设置为帖子类型,以设置“编辑链接”列表中的帖子类型。(默认:空)
<li>'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)
<li>'largest'
(整数):最大文本大小。(默认:22)
<li>'unit'
(字符串):文本大小单位。(默认:'pt')
<li>'number'
(字符串):返回多少个标签(默认:0)
<li>'format'
(字符串):如何返回标签列表 - 'flat' 表示以空格分隔的平面列表,'list' 表示 HTML 无序列表,'array' 表示 PHP 数组。 (默认:'平坦')
<li>'separator'
(字符串):分隔符文本。(默认:“\n”)
<li>'orderby'
(字符串):如何按('name' 或 'count')对标签进行排序。(默认:'name')
<li>'order'
(字符串):是否按升序('ASC')或降序('DESC')排序项目。(默认:'ASC')
<li>'topic_count_text'
(字符串):这是 _n_noop() 的 noooped 复数形式,用于生成标签链接工具提示的文本。(默认:NULL
) EM>
'topic_count_text_callback'
(字符串):这是回调函数,它给出带有该标签的帖子的计数,返回标签链接工具提示的文本。(默认: NULL
)
'topic_count_scale_callback'
(字符串):这是与 'smallest'
和 'largest'
参数一起使用的回调函数,用于计算生成标签的字体大小。(默认:'default_topic_count_scale')
<li>'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 ); ?>
希望您喜欢第二批模板标签。还有六批要进行,请继续关注更多模板标签!
如果您有任何问题、意见或更正,您可以在评论部分与我们分享您的想法。如果您喜欢这篇文章,请不要忘记与您的朋友分享!
以上是範本標籤:Tuts+ 指南繼續的詳細內容。更多資訊請關注PHP中文網其他相關文章!