block_categories хук-фільтрWP 5.0.0

Застарів із версії 5.8.0 . Більше не підтримується і може бути видалено.
Дивіться block_categories_all .

Дозволяє додати/видалити/змінити категорії блоків Gutenberg.

Щоб нова категорія відобразилася в меню, потрібно додати до неї хоча б один блок!

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

add_filter( 'block_categories', 'wp_kama_block_categories_filter', 10, 3);

/**
 * Function for `block_categories` filter-hook.
 *
 * @param array[] $block_categories Опис категорії для блокових типів.
 * @param WP_Post $post Post being loaded.
 * @param $string           
 *
 * @return array[]
 */
function wp_kama_block_categories_filter( $block_categories, $post, $string ){

	// Filter...
	return $block_categories;
}
$default_categories
(масив)
Масив категорій блоків.
$post
(об’єкт)
Поточний завантажений запис.

Приклади

0

#1 Додамо нову категорію для групування блоків

add_filter( 'block_categories', 'custom_block_category', 10, 2);

function custom_block_category( $default_categories, $post ) {

	if ( $post->post_type !== 'post' ) {
		return $default_categories;
	}

	return array_merge(
		$default_categories,
		[
			[
				'slug' => 'glum-category', // Слаг категорії який будемо використовувати при реєстрації блоку
				'title' => __( 'Glum Category', 'my-plugin' ), // Назва категорії, що відображається
				'icon' => 'wordpress' // Іконка для категорії, можна передати null якщо іконка не потрібна
			],
		]
	);

}

список змін

З версії 5.0.0Введено.
Застаріла з 5.8.0Use the {@see ‘block_categories_all’} filter instead.

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

block_categories

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

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

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *