• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2014年2月13日 (木) 21:26時点におけるShizumi (トーク | 投稿記録)による版 (引数と返り値についての情報追加、及び表示の整理)

移動先: 案内検索

説明

このテンプレートタグ get_the_category は、現在の記事が属するカテゴリをオブジェクト形式で返します。このタグはパラメータとして投稿IDを渡すことで、ループの外でも使うことが出来ます。

使い方

<?php get_the_category( $post_id ); ?>

パラメータ

$post_id
整数) (オプション) 投稿 ID。
初期値: $post->ID(現在の投稿ID)

用例

ポストに登録された全てのカテゴリをリンクで表示します。これはget_the_category_list()と同様の動きです。

<?php
$categories = get_the_category();
$separator = ' ';
$output = ;
if($categories){
	foreach($categories as $category) {
		$output .= '<a href="'.get_category_link( $category->term_id ).'" title="' . esc_attr( sprintf( __( "View all posts in %s" ), $category->name ) ) . '">'.$category->cat_name.'</a>'.$separator;
	}
echo trim($output, $separator);
}
?>

返り値

(配列)
カテゴリオブジェクトの配列

返す配列内のメンバ変数

term_id
(文字列)カテゴリID
name
(文字列)カテゴリ名
slug
(文字列)カテゴリスラッグ名
term_group
(文字列)カテゴリグループ
term_taxonomy_id
(文字列)カテゴリタクソノミーID
taxonomy
(文字列)タクソノミー名
description
(文字列)カテゴリの説明
parent
(文字列)親カテゴリ
count
(文字列)カテゴリに登録されている記事数
filter
(文字列)
cat_ID
(文字列)カテゴリID
category_count
(文字列)カテゴリに登録されている記事数
category_description
(文字列)カテゴリの説明
cat_name
(文字列)カテゴリ名
category_nicename
(文字列)カテゴリスラッグ名
category_parent
(文字列)親カテゴリ


カテゴリータグ: 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()


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。