当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

テンプレートタグ/get the category list

提供: WordPress Codex 日本語版
< テンプレートタグ
2014年8月3日 (日) 02:07時点におけるGblsm (トーク | 投稿記録)による版

移動先: 案内検索

このページ「テンプレートタグ/get the category list」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

このページ「テンプレートタグ/get the category list」は情報が古くなっている可能性があります。最新版英語)も合わせてご覧ください。翻訳にご協力くださる方はぜひご相談ください

概要

Retrieve category list in either HTML list or custom format. Generally used for quick, delimited (eg: comma-separated) lists of categories, as part of a post's entry meta. For a more powerful, list-based function, see wp_list_categories().

用例

<?php get_the_category_list( $separator, $parents, $post_id ); ?>

引数

$separator
string) (optional) Optional, default is empty string. Separator for between the categories.
初期値: empty string
$parents
string) (optional) Optional. How to display the parents. Values: 'multiple', 'single', empty string
初期値: empty string
$post_id
int) (optional) Optional. Post ID to retrieve categories.
初期値: false

戻り値

(string) 

Notes

Categories are ordered by name regardless of the parent-child category relationship. See this example from wp_list_categories() to display the Post categories with the category relationship intact.

用例

Implementation in WordPress default Twenty Eleven theme

In content-single.php:

<?php
	/* translators: used between list items, there is a space after the comma */
	$categories_list = get_the_category_list( __( ', ', 'twentyeleven' ) );

	/* translators: used between list items, there is a space after the comma */
	$tag_list = get_the_tag_list( '', __( ', ', 'twentyeleven' ) );
	if ( '' != $tag_list ) {
		$utility_text = __( 'This entry was posted in %1$s and tagged %2$s by <a href="%6$s">%5$s</a>. Bookmark the <a href="%3$s" title="Permalink to %4$s" rel="bookmark">permalink</a>.', 'twentyeleven' );
	} elseif ( '' != $categories_list ) {
		$utility_text = __( 'This entry was posted in %1$s by <a href="%6$s">%5$s</a>. Bookmark the <a href="%3$s" title="Permalink to %4$s" rel="bookmark">permalink</a>.', 'twentyeleven' );
	} else {
		$utility_text = __( 'This entry was posted by <a href="%6$s">%5$s</a>. Bookmark the <a href="%3$s" title="Permalink to %4$s" rel="bookmark">permalink</a>.', 'twentyeleven' );
	}

	printf(
		$utility_text,
		$categories_list,
		$tag_list,
		esc_url( get_permalink() ),
		the_title_attribute( 'echo=0' ),
		get_the_author(),
		esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) )
	);
?>

Display as List Items

By leaving the $separator value empty, it will generate an unordered list instead, complete with classes.

<?php echo get_the_category_list(); ?>

Result:

<ul class="post-categories">
	<li>
		<a href="http:myblog.com/category/business" title="View all posts in Business" rel="category tag">Business</a>
	</li>
</ul>

変更履歴

1.5.1以降

ソースファイル

get_the_category_list() is located in wp-includes/category-template.php

関連

カテゴリータグ: the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category()


関数リファレンステンプレートタグ目次もご覧ください。