WordPress.org

Function Reference/single cat title

Languages: English • 日本語 • Português do Brasil • (Add your language)

Description

Displays or returns the category title for the current page. For pages displaying WordPress tags rather than categories (e.g. "/tag/geek") the name of the tag is displayed instead of the category. Can be used only outside The Loop.

Usage

<?php single_cat_title( $prefix, $display ); ?>

Default Usage

<?php single_cat_title( 'prefix' => , 'display' => true ); ?>

Parameters

$prefix

(string) (optional) Text to output before the title.

Default: None

$display

(boolean) (optional) Should the title be displayed (TRUE) or returned for use in PHP (FALSE).

Default: TRUE

Examples

This example displays the text "Currently browsing " followed by the category title.

<p><?php single_cat_title('Currently browsing '); ?>.</p>

Currently browsing WordPress.

This example assigns the current category title to the variable $current_category for use in PHP.

<?php $current_category = single_cat_title("", false); ?>

Change Log

3.1.0: uses single_term_title()
Since: ?

Source File

single_cat_title() is located in wp-includes/general-template.php.

Categories: 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()

See also index of Function Reference and index of Template Tags.

WordPress.org

Codex

Function Reference/single cat title

Contents