the_category( string $separator = '', string $parents = '', int $post_id = false )
Display category list for a post in either HTML list or custom format.
Description Description
Parameters 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 value: ''
- $parents
-
(string) (Optional) How to display the parents.
Default value: ''
- $post_id
-
(int) (Optional) Post ID to retrieve categories.
Default value: false
Source Source
File: wp-includes/category-template.php
function the_category( $separator = '', $parents = '', $post_id = false ) {
echo get_the_category_list( $separator, $parents, $post_id );
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |
User Contributed Notes 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.
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.
$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)