post_class
Позволяет изменить список CSS классов для текущей записи.
Этот хук срабатывает в конце функции post_class().
Использование
add_filter( 'post_class', 'wp_kama_post_class_filter', 10, 3 );
/**
* Function for `post_class` filter-hook.
*
* @param string[] $classes An array of post class names.
* @param string[] $css_class An array of additional class names added to the post.
* @param int $post_id The post ID.
*
* @return string[]
*/
function wp_kama_post_class_filter( $classes, $css_class, $post_id ){
// filter...
return $classes;
}
- $classes(строка[])
- Массив CSS классов для текущей записи.
- $class(строка[])
- Массив дополнительных CSS классов, добавленных к записи.
- $post_id(число)
- ID записи.
Примеры
#1 Добавим CSS класс, если у записи нет миниатюры
При использовании функции post_class() в списке CSS классов присутствует класс has-post-thumbnail, если у текущей записи есть миниатюра, но если её нет - ничего не добавляет. Исправим это следующим кодом:
add_filter( 'post_class', 'add_class_without_post_thumbnail', 10, 3 );
function add_class_without_post_thumbnail( $classes, $class, $post_id ){
if( ! has_post_thumbnail( $post_id ) ){
$classes[] = 'no-post-thumbnail';
}
return $classes;
}
Список изменений
| С версии 2.7.0 | Введена. |
Где вызывается хук
post_class
wp-includes/post-template.php 607
$classes = apply_filters( 'post_class', $classes, $css_class, $post->ID );