【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テンプレートタグ】comments_link():コメント部分へのリンクを表示
概要 記事のコメント部分へのURLを表示する。 書式 <?php comments_link(...
-
【WordPressテンプレートタグ】wp_register():ユーザー登録ページのURLを表示または取得
概要 管理画面「一般設定」>「誰でもユーザー登録ができるようにする」 にチェックが入っていると...
-
【WordPressテンプレートタグ】the_post_thumbnail():アイキャッチ画像を表示
概要 記事に設定されたアイキャッチ画像を指定された大きさで表示する。 引数に、管理画面もしくはadd...
-
【WordPressテンプレートタグ】body_class():表示している状況に応じたCSSのclass名を出力
概要 トップページや固定ページ、投稿、カテゴリーなど、表示している状況に応じたCSSのclass名を...
-
【WordPressテンプレートタグ】get_page_link():固定ページのパーマリンクを取得
概要 固定ページのパーマリンクを取得する。固定ページIDを渡せばそのページのURLを取得でき、引数を...
-
【WordPressテンプレートタグ】the_content():記事の本文を表示
概要 記事の本文を表示する。 本文中に <!--more--> クイックタ...
-
【WordPressテンプレートタグ】the_tags():投稿の属するタグ名とリンクを表示
概要 投稿につけられたタグ名とタグアーカイブへのリンクを表示する。 書式 <?php the_...
-
【WordPressインクルードタグ】get_footer():「footer.php」を読み込む
概要 テンプレートファイル「footer.php」を読み込む 書式 <?php get_foo...
-
【WordPressテンプレートタグ】get_author_posts_url():作成者IDを指定して、作成者別アーカイブURLを取得
概要 投稿の作成者をIDで指定して、作成者別アーカイブページのURLを取得する。 書式 <?p...
-
【WordPressテンプレートタグ】next_posts_link():次のアーカイブへのリンクを表示
概要 記事一覧ページ(メインページ・アーカイブページ・カテゴリーなど)の次ページ(日付の古い記事一覧...