the_category( string $separator = '', string $parents = '', int $post_id = false )
Displays category list for a post in either HTML list or custom format.
Parameters
-
$separator
string Optional -
Separator between the categories. By default, the links are placed in an unordered list. An empty string will result in the default behavior.
Default:
''
-
$parents
string Optional -
How to display the parents. Accepts
'multiple'
,'single'
, or empty.
Default:
''
-
$post_id
int Optional -
ID of the post to retrieve categories for. Defaults to the current post.
Default:
false
Source
File: wp-includes/category-template.php
.
View all references
function the_category( $separator = '', $parents = '', $post_id = false ) {
echo get_the_category_list( $separator, $parents, $post_id );
}
Changelog
Version | Description |
---|---|
0.71 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Separated by Space
List categories with a space as the separator.
$parents
▪ ‘multiple’ – Display separate links to parent and child categories, exhibiting “parent/child” relationship. (Exhibiting the parents and child with links pointing for both)
▪ ‘single’ – Display link to child category only, with link text exhibiting “parent/child” relationship. (Exhibiting the parents and child but the link points only to the child category)
Top ↑
Feedback
$parents is stated as defaulting to empty string, without an indication of whether this will be interpreted as ‘multiple’ or ‘single’. — By douglasuk —
Separated by Comma
Displays links to categories, each category separated by a comma (if more than one).
Separated by Arrow
Displays links to categories with an arrow (>) separating the categories. Note: Take care when using this, since some viewers may interpret a category following a > as a subcategory of the one preceding it.
Separated by a Bullet
Displays links to categories with a bullet (•) separating the categories.