WordPress中get_the_taxonomies()的功能和用法

问题

答案 ( 1 )

    0
    2024-01-08T14:52:51+00:00

    WordPress中的get_the_taxonomies()函数是一个强大的工具,用于检索和显示与特定文章相关联的分类法。以下是该函数的详细解释以及如何使用它的示例:

    函数:

    get_the_taxonomies( int|WP_Post $post, array $args = array() ): string[]

    描述:

    该函数旨在获取与给定文章相关联的所有分类法(如分类、标签或自定义分类法)。它在“循环”内特别有用,这是WordPress通过一个重复的过程来显示文章的方式。该函数返回一个分类法数组,每个分类法都格式化为链接到其各自分类法页面和分类法名称的方式。

    参数:

    $post(int|WP_Post,可选):

    描述:该参数可以是文章的ID或WP_Post对象。

    默认值:如果未指定,则函数使用全局的$post变量,该变量表示“循环”中的当前文章。

    $args(array,可选):

    描述:一个用于控制分类法列表格式的参数数组。

    关键参数:

    template:用于显示每个分类法标签及其术语列表的字符串模板。默认格式为“标签:术语”。

    term_template:用于显示分类法列表内的每个术语的模板。默认情况下,它显示链接到其存档页面的术语名称。

    默认值:一个空数组array()。

    返回:

    string[]:该函数返回一个字符串数组。每个字符串都是一个经过格式化的单个分类法及其术语列表,根据指定的参数。

    示例用法:

    // 在WordPress循环内
    if ( have_posts() ) {
        while ( have_posts() ) {
            the_post();
            
            // 获取当前文章的分类法
            $taxonomies = get_the_taxonomies( get_the_ID(), array( 
                'template' => '<strong>%s:</strong> %l', 
                'term_template' => '<a href="%1$s">%2$s</a>' 
            ));
            // 输出分类法
            foreach ( $taxonomies as $taxonomy ) {
                echo '<p>' . $taxonomy . '</p>';
            }
        }
    }
    

    在这个示例中,get_the_taxonomies()函数在“循环”内用于获取每篇文章的分类法。输出格式使用$args参数进行了自定义,其中%s表示分类法标签,%l表示术语列表。每个术语都链接到其存档页面。这将以格式化的方式显示当前文章的每个分类法及其术语。

留下一个答案