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

テンプレートタグ/category description

提供: WordPress Codex 日本語版
< テンプレートタグ
2013年4月8日 (月) 20:12時点におけるGatespace (トーク | 投稿記録)による版 (01:34, 21 February 2011 Ramiy 版を反映。一部未翻訳です。)

移動先: 案内検索

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

説明

カテゴリー管理画面(投稿 > カテゴリー)で設定したカテゴリーの説明をPHPの値として返します。 archive.php テンプレートで使う場合、条件文 is_category() の内側で使ってください。そうでない場合、この関数は日別アーカイブやその他のアーカイブページの処理を停止します。

使い方

<?php echo category_description( $category_id ); ?>

パラメータ

$category_id
整数) (オプション) 説明を取得したいカテゴリーID(数字)。
初期値: 現在のページのカテゴリーID。

用例

基本

Displays the description of a category, given its id, by echoing the return value of the tag. If no category given and used on a category page, it returns the description of the current category.

<div><?php echo category_description(3); ?></div>

出力例:

WordPress is a favorite blogging tool of mine and I share tips and tricks for using WordPress here.

注意: if there is no category description, the function returns a br tag.

カテゴリースラッグから取得する

Displays the description of a category, using a category slug.

<?php echo category_description( get_category_by_slug('category-slug')->term_id ); ?>

カテゴリータイトルと一緒に表示

<div><strong><?php single_cat_title('Currently browsing'); ?>
</strong>: <?php echo category_description(); ?></div> 

出力例:

Currently browsing WordPress: WordPress is a favorite blogging tool of mine and I share tips and tricks for using WordPress here.

変更履歴

  • Since: 1.0.0

ソースファイル

category_description()wp-includes/category-template.php にあります。


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

最新英語版: WordPress Codex » Template Tags/category_description最新版との差分