post_class( string|array $class = '', int|WP_Post $post_id = null )
Displays the classes for the post container element.
Description
Parameters
- $class
-
(string|array) (Optional) One or more classes to add to the class list.
Default value: ''
- $post_id
-
(int|WP_Post) (Optional) Post ID or post object. Defaults to the global
$post.Default value: null
Source
File: wp-includes/post-template.php
function post_class( $class = '', $post_id = null ) {
// Separates classes with a single space, collates classes for post DIV
echo 'class="' . join( ' ', get_post_class( $class, $post_id ) ) . '"';
}
Changelog
| Version | Description |
|---|---|
| 2.7.0 | Introduced. |
Add more classes.
You can add a class to the
post_classdefaults:The above prints HTML with your added class and the defaults:
Use an array to add multiple classes:
To print
post_classCSS 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-tag2post_class filter
You can also add classes using the
post_classfilter.A simple way to add multiple classes to the
post_classdefaults, is to just write them as a string argument:which will add those classes to the default class list.
Example of the template tag (and its default CSS classes).
This example shows the
post_classtemplate 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):
Using these CSS classes you can then style this specific post, or all posts assigned the same category (or post format):
.post { /* Styles for all posts */ } .post-4564 { /* Styles for only this post (ID number 4564) */ } .category-news { /* Styles for all posts in the 'news' category */ } .format-standard { /* Styles for all posts assigned the post-format of 'standard' */ }Expand full source codeCollapse full source code