首页 视频课程 主题开发课程第04章、常用函数 WordPress主题插件开发中分类相关函数

WordPress主题插件开发中分类相关函数

2023-06-11 / 365阅

分类相关函数

在 WordPress 主题或插件的开发中,有着许多与分类有关的函数,这些函数可以用来获取、显示或修改与分类相关的信息。

获取分类列表函数(get_terms)

get_terms 函数用于获取分类列表,可以接收多个参数,可根据需要设置。

例如,以下代码将获取所有分类列表:

$terms = get_terms( array(
    'taxonomy' => 'category',
    'hide_empty' => false,
) ); 

其中,taxonomy 用于指定需要获取的分类法(这里是文章分类法),hide_empty 用于设置是否隐藏空分类(如果值为 false,则显示所有分类)。

获取分类名称函数(single_cat_title)

single_cat_title 函数用于获取当前页面所属分类的标题,可以接收一个可选的参数,用于设置标题的前缀和后缀。

以下代码将获取当前页面所属分类的标题,并将其包含在一对 <h1> 标签中:

<h1><?php single_cat_title( '', true ); ?></h1> 

获取分类链接函数(get_category_link)

get_category_link 函数用于获取指定分类的链接地址,需要指定一个分类 ID 或对象。

例如,以下代码将获取 ID 为 3 的分类的链接地址:

$category_link = get_category_link( 3 ); 

获取分类文章数函数(wp_count_posts)

wp_count_posts 函数用于获取分类下文章的数量,需要指定一个分类 ID 或对象。

以下代码将获取 ID 为 3 的分类下文章的数量:

$category_count = wp_count_posts( 'category', '3' );
echo $category_count->publish; 

其中,publish 属性为发布状态的文章数量。

示例代码

以下是一个示例代码,演示如何获取当前页面所属分类的信息,并在页面上显示相关内容:

<?php
$category = get_queried_object();
$category_name = $category->name;
$category_description = $category->description;
$category_thumb = get_field('category_thumb', $category);
?>

<div class="category">
    <h1><?php single_cat_title( '', true ); ?></h1>
    <?php if ( $category_thumb ) { ?>
        <img src="<?php echo esc_url( $category_thumb ); ?>" alt="<?php echo esc_attr( $category_name ); ?>">
    <?php } ?>
    <?php if ( $category_description ) { ?>
        <div class="description"><?php echo esc_html( $category_description ); ?></div>
    <?php } ?>
    <?php get_template_part( 'template-parts/content', 'archive' ); ?>
</div> 

在上述代码中,首先使用 get_queried_object 函数获取当前页面所属分类的对象,然后分别获取分类的名称、描述和缩略图等信息,最后将这些信息呈现在页面上。

阅读文章或者观看视频过程中有任何问题,请下方留言或者联系我Q248758228

大家谈论
    我的见解
    目录