WordPress網(wǎng)站分類目錄代碼實(shí)現(xiàn)指南

來自：素雅營銷研究院

方知筆記

2025年07月01日 09:47

在WordPress網(wǎng)站建設(shè)中，分類目錄是組織內(nèi)容的重要工具。本文將詳細(xì)介紹幾種實(shí)現(xiàn)WordPress分類目錄功能的代碼方法，幫助開發(fā)者更好地管理和展示網(wǎng)站內(nèi)容。

一、基本分類目錄調(diào)用代碼

最基本的分類目錄調(diào)用可以使用WordPress內(nèi)置函數(shù)wp_list_categories()：

<?php
$args = array(
'show_count' => 1,
'hide_empty' => 0,
'title_li' => __('Categories'),
'exclude' => '1,5' // 排除ID為1和5的分類
);
wp_list_categories($args);
?>

這段代碼會輸出一個帶計(jì)數(shù)的分類列表，包含所有非空分類。

二、自定義分類目錄樣式

如果需要自定義分類目錄的顯示樣式，可以使用以下代碼：

<?php
$categories = get_categories(array(
'orderby' => 'name',
'order' => 'ASC'
));

foreach($categories as $category) {
echo '<div class="custom-category-item">';
echo '<a href="' . get_category_link($category->term_id) . '">';
echo $category->name;
echo '</a> (<span class="count">' . $category->count . '</span>)';
echo '</div>';
}
?>

三、多級分類目錄顯示

對于有父子關(guān)系的多級分類目錄，可以使用遞歸函數(shù)實(shí)現(xiàn)：

<?php
function display_categories_hierarchical($parent_id = 0) {
$categories = get_categories(array(
'parent' => $parent_id,
'hide_empty' => false
));

if($categories) {
echo '<ul>';
foreach($categories as $category) {
echo '<li>';
echo '<a href="' . get_category_link($category->term_id) . '">';
echo $category->name;
echo '</a>';
display_categories_hierarchical($category->term_id); // 遞歸調(diào)用
echo '</li>';
}
echo '</ul>';
}
}

display_categories_hierarchical();
?>

四、分類目錄短代碼實(shí)現(xiàn)

為了方便在文章或頁面中調(diào)用，可以創(chuàng)建一個分類目錄短代碼：

// 添加到functions.php
function custom_categories_shortcode($atts) {
$atts = shortcode_atts(array(
'show_count' => true,
'hide_empty' => false,
'exclude' => ''
), $atts);

ob_start();
wp_list_categories(array(
'show_count' => $atts['show_count'],
'hide_empty' => $atts['hide_empty'],
'exclude' => $atts['exclude'],
'title_li' => ''
));
return ob_get_clean();
}
add_shortcode('custom_categories', 'custom_categories_shortcode');

使用方式：[custom_categories show_count="1" hide_empty="0"]

五、分類目錄小工具增強(qiáng)

如果需要在小工具中使用更靈活的分類目錄，可以創(chuàng)建自定義小工具：

class Enhanced_Categories_Widget extends WP_Widget {
public function __construct() {
parent::__construct(
'enhanced_categories',
__('Enhanced Categories', 'text_domain'),
array('description' => __('An enhanced categories widget', 'text_domain'))
);
}

public function widget($args, $instance) {
// 小工具前端顯示代碼
echo $args['before_widget'];
if(!empty($instance['title'])) {
echo $args['before_title'] . apply_filters('widget_title', $instance['title']) . $args['after_title'];
}

$cat_args = array(
'orderby' => 'name',
'show_count' => $instance['count'],
'hide_empty' => $instance['hide_empty']
);

wp_list_categories($cat_args);
echo $args['after_widget'];
}

public function form($instance) {
// 小工具后臺表單代碼
}

public function update($new_instance, $old_instance) {
// 小工具更新處理代碼
}
}

function register_enhanced_categories_widget() {
register_widget('Enhanced_Categories_Widget');
}
add_action('widgets_init', 'register_enhanced_categories_widget');

六、分類目錄緩存優(yōu)化

對于大型網(wǎng)站，分類目錄查詢可能會影響性能，可以使用緩存優(yōu)化：

function get_cached_categories() {
$cache_key = 'cached_categories_list';
$categories = get_transient($cache_key);

if(false === $categories) {
$categories = get_categories(array(
'orderby' => 'count',
'order' => 'DESC',
'hide_empty' => true
));

set_transient($cache_key, $categories, 12 * HOUR_IN_SECONDS);
}

return $categories;
}