>백엔드 개발 >PHP 튜토리얼 >템플릿 태그: Tuts+ 튜토리얼 계속

템플릿 태그: Tuts+ 튜토리얼 계속

PHPz
PHPz원래의
2023-08-31 18:17:051048검색

模板标签:Tuts+ 指南继续

이 시리즈의 2부에서는 첫 번째 WordPress 템플릿 태그를 소개했습니다. 3부에서는 거의 200개에 달하는 템플릿 태그의 두 번째 배치를 소개합니다. 튜토리얼 전체에서 분류 및 용어에 대한 템플릿 태그를 볼 수 있습니다.

카테고리 설명 보기: category_description()

이 템플릿 태그는 카테고리에 대한 설명을 반환합니다.

매개변수

이 템플릿 태그는 하나의 매개변수만 허용합니다:

    <li> $category_ID (선택 사항 — 정수) :

    카테고리 ID.

    (기본값: 검색어 카테고리) >

사용법

으아악

태그 설명 가져오기: tag_description()

이 템플릿 태그는 태그에 대한 설명을 반환합니다.

매개변수

이 템플릿 태그는 하나의 매개변수만 허용합니다:

    <li> $tag_ID (선택 사항 - 정수) :

    태그의 ID입니다.

    (기본값: 현재 라벨)

사용법

으아악

용어 설명 보기: term_description()

이 템플릿 태그는 용어 설명만 반환합니다.

매개변수

이 템플릿 태그는 두 가지 매개변수를 허용합니다:

    <li> $term_ID (선택 사항 - 정수) :

    용어의 ID입니다.

    (기본값: 현재 기간)

    <li> $taxonomy (선택 사항 — 문자열) :

    용어 분류.

    (기본값: 'post_tag') >

사용법

으아악

카테고리 아카이브의 페이지 제목 가져오기 및 표시: single_cat_title()

이 템플릿 태그는 페이지 제목에 사용할 카테고리 제목을 반환하고 표시합니다.

매개변수

이 템플릿 태그는 두 가지 매개변수를 허용합니다:

    <li> $prefix (선택 사항 — 문자열) :

    제목 접두사.

    (기본값: 비어 있음)

    <li> $echo $echo (可选 - 布尔值)

    是否 echo (TRUE) 或返回 (FALSE) 标签。

    (默认:TRUE (선택 사항 - 부울) :

태그를 에코(TRUE)할지 아니면 반환(FALSE)할지 여부입니다.

(기본값: TRUE)single_tag_title()

사용법

으아악

태그 아카이브의 페이지 제목 가져오기 및 표시:

    이 템플릿 태그는 페이지 제목에 사용할 태그 제목을 반환하고 표시합니다. <li> $prefix매개변수 이 템플릿 태그는 두 가지 매개변수를 허용합니다:

    (선택 사항 — 문자열) :

    <li>제목 접두사. $echo (可选 - 布尔值)

    是否 echo (TRUE) 或返回 (FALSE) 标签。

    (默认:TRUE

    (기본값: 비어 있음)

$echo

(선택 사항 - 부울) single_term_title():

태그를 에코(TRUE)할지 아니면 반환(FALSE)할지 여부입니다.

(기본값: TRUE)

    <li>사용법$prefix 으아악 용어 아카이브의 페이지 제목 가져오기 및 표시:

    이 템플릿 태그는 페이지 제목에 사용된 용어 제목을 반환하고 표시합니다.

    매개변수 이 템플릿 태그는 두 가지 매개변수를 허용합니다:

    <li> $echo (可选 - 布尔值)

    是否 echo (TRUE) 或返回 (FALSE) 标签。

    (默认:TRUE

    (선택 사항 — 문자열)
:

제목 접두사.

get_the_category_list() & the_category()

(기본값: 비어 있음)

$echo

(선택 사항 - 부울)

:

    태그를 에코(TRUE)할지 아니면 반환(FALSE)할지 여부입니다. <li> $separator(기본값: TRUE)

    사용법

    으아악 게시물 카테고리 가져오기 및 표시:

    <li>이 템플릿 태그는 게시물에 할당된 카테고리를 가져오고 출력합니다. $parents 매개변수 두 템플릿 태그 모두 세 가지 매개변수를 허용합니다.

    (선택 사항 — 문자열)

    : <li> $post_ID 구분 기호 텍스트입니다. (기본값: 비어 있음 - 이 매개변수가 비어 있으면 함수가 반환되어 정렬되지 않은 카테고리 목록을 표시합니다.)

    (선택 사항 - 문자열)

    :

상위 카테고리를 표시하는 방법("다중", "단일" 또는 비어 있음).

get_the_category_rss() & the_category_rss()(기본값: 비어 있음)

(선택 - 정수)

:

    게시물 ID. <li> $feed_type(기본값: 현재 게시물)

    사용법

    으아악 피드 게시물 카테고리 가져오기 및 표시:

이 템플릿 태그는 게시물을 공급하고 반환하거나 표시하기 위해 게시물에 할당된 카테고리를 준비합니다.

매개변수

get_the_tag_list() & the_tags()두 개의 템플릿 태그는 하나의 매개변수만 허용합니다:

(선택 사항 - 문자열)

:

    피드 유형. <li> $before(기본값: 기본 피드 유형)

    사용법🎜 으아악 🎜게시물 태그 가져오기 및 표시: 🎜 🎜 🎜이 템플릿 태그는 게시물에 대한 태그를 반환하거나 표시합니다. 🎜 🎜매개변수🎜 🎜두 템플릿 태그 모두 세 가지 매개변수를 허용합니다. 🎜 🎜 🎜 🎜 🎜 (선택 사항 — 문자열) 🎜: 🎜🎜출력하기 전에 표시할 텍스트 또는 HTML 코드입니다. 🎜

    (默认值:为空get_the_tag_list() 和 '标签:' the_tags())

    <li> $sep (可选 — 字符串)

    用作分隔符的文本。

    (默认值: get_the_tag_list() 和 ', ' 表示 the_tags())

    <li> $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()

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

参数

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

    <li> $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()

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

参数

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

    <li> $args (可选—数组)

    以下参数的数组:

      <li> '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() 接受两个参数:

    <li> $tag_ID (必需 - 整数)

    标签的 ID。

    (默认:NULL >

    <li> $taxonomy (可选—字符串)

    分类法的类型。

    (默认:'post_tag')

edit_tag_link() 接受四个参数:

    <li> $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()

此模板标记返回或显示任何类型分类法中的类别或术语列表。

参数

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

    <li> $args (可选—数组)

    以下参数的数组:

      <li> '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 );

?>

获取并显示 HTML 类别下拉列表:wp_dropdown_categories()

此模板标记返回或回显您选择的分类中的类别或术语的下拉菜单 (<select></select>)。

参数

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

    <li> $args (可选—数组)

    以下参数的数组:

      <li> '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()

此模板标签返回或显示根据您选择的分类法(默认为标签)生成的术语云。

参数

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

    <li> $args (可选—数组)

    以下参数的数组:

      <li> '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()

此模板标签返回标签云,但这一次,您可以选择自己的标签。

参数

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

    <li> $tags (必需 — 数组)

    标签列表的数组。

    (默认:NULL

    <li> $args (可选—数组)

    以下参数的数组:

      <li> '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>

      <li> 'topic_count_text_callback'(字符串):这是回调函数,它给出带有该标签的帖子的计数,返回标签链接工具提示的文本。

      (默认: NULL)

      <li> '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 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.