Question

single_cat_title( string $prefix = '',  bool $display = true )

Display or retrieve page title for category archive.

---

description

Useful for category template files for displaying the category page title. The prefix does not automatically place a space between the prefix, so if there should be a space, the parameter value will need to have it at the end.

---

参数

$prefix

(string) (Optional) What to display before the title.

Default value: ''

$display

(bool) (Optional) Whether to display or retrieve title.

Default value: true

---

返回值

(string|void) Title when retrieving.

---

源代码

File: wp-includes/general-template.php

function single_cat_title( $prefix = '', $display = true ) {
	return single_term_title( $prefix, $display );
}

---

更新日志

Version	description
0.71	Introduced.

---

相关函数

Uses

• wp-includes/general-template.php: single_term_title()

---

Used By

• wp-includes/general-template.php: get_the_archive_title()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note Contributed by Codex

   Examples
   This example displays the text “Currently browsing ” followed by the category title.

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

   Result:

   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); ?>
   

The example above (https://developer.wordpress.org/reference/functions/single_cat_title/#comment-478) misses translation support. All strings should be translatable.

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