post_class │ хук-фільтр │ WP 2.7.0

Дозволяє змінити список класів CSS для поточного запису.

Цей хук спрацьовує наприкінці функції post_class() .

Використання

add_filter( 'post_class', 'wp_kama_post_class_filter', 10, 3);

/**
 * Function for `post_class` filter-hook.
 *
 * @param string[] $classes На array of post class names.
 * @param string[] $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, $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

Введено.

Де викликається хук

get_post_class()

post_class

$classes = apply_filters( 'post_class', $classes, $class, $post->ID );

Де використовується хук у WordPress

Використання не знайдено.