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

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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2008年4月4日 (金) 01:30時点におけるBono (トーク | 投稿記録)による版 (en:Template Tags/the_category_head 2008年2月2日 (土) 18:47 Kafkaesqui 版)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

この関数は 非推奨となりました。これは新しい関数に置き換えられた、またはサポート外になった、あるいは将来バージョンにて削除されるためです。この関数を用いる全てのコードは、置き換えとなる関数が存在する場合、書き換えられる必要があります。wp-includes/deprecated.phpもご参照ください。 これらの関数から適切なものを代わりに用いてください。

Description

Displays the name of a category if it's different from the previous category. This tag must be used within The Loop.

Replace With

This tag was deprecated when multiple categories were added to WordPress, and there is no one-to-one correspondence with another tag.

To display the name of the category when on a category page, use:

<?php echo get_the_category_by_ID($cat); ?>

To display category name(s) on a single post page, this code block (which would need to run in The Loop) provides an example:

<?php
foreach(get_the_category() as $category) {
    echo $category->cat_name . ' '; 
}
?>

Usage

%%% <?php the_category_head('before', 'after'); ?> %%%

Example

Displays the text "Category: " followed by the name of the category.

<h2><?php the_category_head('Category: '); ?></h2>

Parameters

before 
(string) Text to output before the category. Defaults to '' (no text).
after 
(string) Text to output after the category. Defaults to '' (no text).

Related

カテゴリータグ: 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 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。