【WordPressテンプレートタグ】category_description():カテゴリーの説明を取得
公開日: : 最終更新日:2016/03/24 テンプレートタグ
概要
管理画面「投稿」>「カテゴリー」の「カテゴリーの説明」を取得する。
カテゴリーアーカイブページでカテゴリーIDが省略された場合、表示中のカテゴリーの説明となる。
書式
パラメーター
- category_id
- カテゴリーID (初期値:0)
位置
カテゴリーIDを指定すれば、カテゴリーアーカイブ以外でも使用可能。
使用例
echoを使用しての表示
<?php echo category_description(); ?>
<?php echo category_description(3); ?>
表示例
WordPressにはテンプレートタグと呼ばれる、独自のユーザー定義関数が用意されています。
このテンプレートタグを利用すれば、最小限のPHPの知識でWordpressから情報を取り出してWebサイトに表示することができるようになっています。
カテゴリー名と一緒に表示
<h5><?php single_cat_title(); ?></h5> <?php echo category_description(); ?>
表示例
テンプレートタグ
WordPressにはテンプレートタグと呼ばれる、独自のユーザー定義関数が用意されています。
このテンプレートタグを利用すれば、最小限のPHPの知識でWordpressから情報を取り出してWebサイトに表示することができるようになっています。
条件分岐を使って、カテゴリーの説明がある場合のみ表示
<?php if ( category_description() ) : ?> <div> <?php echo category_description(); ?> </div> <?php endif; ?>
MEMO
<p></p>の削除
category_description()を使用の際、<p>タグが自動的に付与されてしまうので、それを避けたい場合はfunctions.phpに下記の一行を追加すれば、<p>タグを除去できる。
remove_filter('term_description','wpautop');
関連
関連記事
-
【WordPressテンプレートタグ】the_tags():投稿の属するタグ名とリンクを表示
概要 投稿につけられたタグ名とタグアーカイブへのリンクを表示する。 書式 <?php the_...
-
【WordPressテンプレートタグ】the_date():記事の公開日を表示または取得
概要 記事の公開日を表示または取得する。 同じ日に複数の記事がある場合は一度だけ表示される。 書式 ...
-
【WordPressテンプレートタグ】next_posts_link():次のアーカイブへのリンクを表示
概要 記事一覧ページ(メインページ・アーカイブページ・カテゴリーなど)の次ページ(日付の古い記事一覧...
-
【WordPressテンプレートタグ】the_date_xml():フィード向けにY-m-d形式で記事の投稿日を表示
概要 フィード向けにY-m-d形式 (例 2015-07-10)で記事の投稿日を表示する 書式 &l...
-
【WordPressテンプレートタグ】the_search_query():検索キーワードを表示
概要 検索が行われたとき、検索キーワードを表示する。 書式 <?php the_search_...
-
【WordPressテンプレートタグ】get_the_author():作成者名を取得
概要 記事の作成者名を文字列として取得する。 (「ユーザー」>「あなたのプロフィール」>「ブログ上の...
-
【WordPressテンプレートタグ】the_author_posts():作成者の総投稿数を表示
概要 作成者の総投稿数を表示する。下書きや非公開の記事はカウントしない。 書式 <?php t...
-
【WordPressテンプレートタグ】the_author_posts_link():作成者別アーカイブへのリンクを表示
概要 投稿の作成者別アーカイブへのリンクを表示する。 「ユーザー」>「あなたのプロフィール」>「ブロ...
-
【WordPressテンプレートタグ】has_post_thumbnail():アイキャッチ画像が登録されているかを判別
概要 アイキャッチ画像が登録されているかどうかを判別する。 書式 <?php has_post...
-
【WordPressテンプレートタグ】the_permalink():記事のパーマリンクのURLを表示
概要 投稿や固定ページなど記事詳細ページへのURLを表示する 書式 <?php the_per...