Displays the classes for the post container element.
Parameters
$css_class
string|string[]optional- One or more classes to add to the class list.
Default:
''
$post
int|WP_Postoptional- Post ID or post object. Defaults to the global
$post
.Default:
null
Source
function post_class( $css_class = '', $post = null ) {
// Separates classes with a single space, collates classes for post DIV.
echo 'class="' . esc_attr( implode( ' ', get_post_class( $css_class, $post ) ) ) . '"';
}
Changelog
Version | Description |
---|---|
2.7.0 | Introduced. |
Add more classes.
You can add a class to the
post_class
defaults:The above prints HTML with your added class and the defaults:
[html]<div id="post-4564" class="class-name post-4564 post type-post status-publish format-standard hentry category-news">[/html]
Use an array to add multiple classes:
To print
post_class
CSS classes for a post other then the current one, specify its ID (integer):The above prints (depending on category and tags):
class="post-22 post type-post status-publish format-standard hentry category-another-cat tag-tag1 tag-tag2
Example of the template tag (and its default CSS classes).
This example shows the
post_class
template tag as commonly used in a theme file (such assingle.php
):The output of the above prints this HTML (for a post in the ‘news’ category and a theme that supports Post Formats):
[html]<div id="post-4564" class="post-4564 post type-post status-publish format-standard hentry category-news">[/html]
Using these CSS classes you can then style this specific post, or all posts assigned the same category (or post format):
A simple way to add multiple classes to the
post_class
defaults, is to just write them as a string argument:which will add those classes to the default class list.
post_class filter
You can also add classes using the
post_class
filter.