WordPress 的文章导航

/**
 * 获取父级分类 (包含分隔符).
 *
 * @since 1.2.0
 *
 * @param int $id 分类 ID.
 * @param bool $link 默认为 false, 为真时返回的分类包含链接.
 * @param string $separator 分类间分隔符, 默认是 '/'.
 * @param bool $nicename 默认为 false, 为真时返回分类显示为分类别名, 否则显示分类名.
 * @param array $visited 防止分类重复显示 (调用该方法时请不用理会这个参数, 本人认为这只是为了顺利完成迭代处理).
 * @return string
 */
function get_category_parents( $id, $link = false, $separator = '/', $nicename = false, $visited = array() ) {
	// 准备返回的 HTML 字符串
	$chain = '';
 
	// 通过 ID 获取分类
	$parent = &get_category( $id );
 
	// 如果该分类已经定义过, 立即返回
	if ( is_wp_error( $parent ) )
		return $parent;
 
	// 以分类别名或者分类名作为分类链接的显示文本
	if ( $nicename )
		$name = $parent->slug;
	else
		$name = $parent->cat_name;
 
	// 如果该分类还有父分类, 分类不是连向自己, 并且还没有处理过
	if ( $parent->parent && ( $parent->parent != $parent->term_id ) && !in_array( $parent->parent, $visited ) ) {
		// 把当前分类的父分类添加到已处理的数组中, 避免以后被重复处理
		$visited[] = $parent->parent;
		// 迭代处理父分类
		$chain .= get_category_parents( $parent->parent, $link, $separator, $nicename, $visited );
	}
 
	// 以链接或者文本形式 (包含分隔符) 将分类拼接到准备返回的 HTML 字符串中
	if ( $link )
		$chain .= '<a href="' . get_category_link( $parent->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $parent->cat_name ) . '">'.$name.'</a>' . $separator;
	else
		$chain .= $name.$separator;
 
	// 返回 HTML 字符串 (结果)
	return $chain;
}

/**
 * 获取分类列表, 并以 HTML 列表方式或者自定义格式返回.
 *
 * @since 1.5.1
 *
 * @param string $separator 默认为空, 显示在各分类之间的分隔符.
 * @param string $parents 指示如何显示父级的分类.
 * @param int $post_id 获取某一文章 ID 对应的分类.
 * @return string
 */
function get_the_category_list( $separator = '', $parents='', $post_id = false ) {
	global $wp_rewrite;
 
	// 找到当前文章对应的分类 (数组, 因为文章可以属于多个分类)
	$categories = get_the_category( $post_id );
 
	// 如果分类数组为空, 在 the_category 方法中当作 '未分类' 进行处理
	if ( empty( $categories ) )
		return apply_filters( 'the_category', __( 'Uncategorized' ), $separator, $parents );
 
	$rel = ( is_object( $wp_rewrite ) && $wp_rewrite->using_permalinks() ) ? 'rel="category tag"' : 'rel="category"';
 
	// 准备返回的 HTML 字符串
	$thelist = '';
 
	// 如果分隔符为空, 返回分类的 HTML 列表
	if ( '' == $separator ) {
		// 列表的开头, 是一个 unordered list
		$thelist .= '<ul class="post-categories">';
 
		// 循环处理所有分类
		foreach ( $categories as $category ) {
			// 每个分类项的开头
			$thelist .= "\n\t<li>";
			switch ( strtolower( $parents ) ) {
 
				// 如果以 'multiple' 模式显示父分类, 每层的分类会独立成一个链接
				case 'multiple':
					// 父分类存在的话, 获取父分类的 HTML 代码并拼接到准备输出的 HTML 字符串中
					if ( $category->parent )
						$thelist .= get_category_parents( $category->parent, true, $separator );
					// 最后把当前分类的 HTML 代码和分类也拼接到准备输出的 HTML 字符串中
					$thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . $rel . '>' . $category->name.'</a></li>';
					break;
 
				// 如果以 'single' 模式显示父分类, 所有分类作为一个链接
				case 'single':
					// 链接的开头
					$thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . $rel . '>';
					// 父分类存在的话, 获取父分类的 HTML 代码并拼接到准备输出的 HTML 字符串中
					if ( $category->parent )
						$thelist .= get_category_parents( $category->parent, false, $separator );
					// 当然分类的名字和链接的结尾
					$thelist .= $category->name.'</a></li>';
					break;
 
				// 如果以默认模式显示父分类, 即不显示父分类
				case '':
				default:
					$thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . $rel . '>' . $category->cat_name.'</a></li>';
			}
		}
 
		// 列表的结尾
		$thelist .= '</ul>';
 
	// 如果分隔符不为空, 返回一段格式化的 HTML
	} else {
		// 计数器
		$i = 0;
 
		// 循环处理所有分类
		foreach ( $categories as $category ) {
			// 第一个分类的前面不显示分隔符
			if ( 0 < $i )
				$thelist .= $separator . ' ';
			switch ( strtolower( $parents ) ) {
 
				// 如果以 'multiple' 模式显示父分类, 每层的分类会独立成一个链接
				case 'multiple':
					if ( $category->parent )
						$thelist .= get_category_parents( $category->parent, true, $separator );
					$thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . $rel . '>' . $category->cat_name.'</a>';
					break;
 
				// 如果以 'single' 模式显示父分类, 所有分类作为一个链接
				case 'single':
					$thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . $rel . '>';
					if ( $category->parent )
						$thelist .= get_category_parents( $category->parent, false, $separator );
					$thelist .= "$category->cat_name</a>";
					break;
				case '':
 
				// 如果以默认模式显示父分类, 即不显示父分类
				default:
					$thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . $rel . '>' . $category->name.'</a>';
			}
 
			// 计数器自增
			++$i;
		}
	}
 
	return apply_filters( 'the_category', $thelist, $separator, $parents );
}

<a title="Go to homepage" href="<?php echo get_settings('home'); ?>/">Home</a> <!-- 首页链接 -->
 &gt; <?php the_category(', '); ?> <!-- 每个分类以逗号分隔 -->
 &gt; <?php the_title(); ?> <!-- 文章链接 -->

<a title="Go to homepage" href="<?php echo get_settings('home'); ?>/">Home</a> <!-- 首页链接 -->
 &gt; <?php the_category(' &gt; ', 'multiple'); ?> <!-- 每个分类以 > 分隔, 父级分类在前, 子分类在后 -->
 &gt; <?php the_title(); ?> <!-- 文章链接 -->