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

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

Дозволяє залишити лише потрібні блоки для Редактора Блоків (Гутенберг).

Значення стандартного фільтра — true — це означає виводити всі доступні блоки.

Хук спрацьовує на сторінці редагування запису при увімкненому редакторі блоків.

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

add_filter( 'allowed_block_types', 'wp_kama_allowed_block_types_filter', 10, 3);

/**
 * Function for `allowed_block_types` filter-hook.
 *
 * @param bool|string[] $allowed_block_types Array of block type slugs, або boolean to enable/disable all. Default true (all registered block types supported)
 * @param WP_Post $post The post resource data.
 * @param $string              
 *
 * @return bool|string[]
 */
function wp_kama_allowed_block_types_filter( $allowed_block_types, $post, $string ){

	// Filter...
	return $allowed_block_types;
}

$allowed_block_types (true/false/масив): Масив ярликів блоків, які потрібно залишити (показувати) у редакторі. Або true/false, щоб повністю увімкнути або вимкнути всі блоки. Список ярликів дивіться нижче.
$post (WP_Post): Об’єкт поточного посту.

Приклади

#1 Відключаємо всі блоки крім зазначених

add_filter( 'allowed_block_types', 'allow_my_block_types', 10, 2);
function disallow_noneed_block_types( $allowed_blocks, $post ){

	return [
		'core/heading',
		'core/paragraph',
		'core/image',
		'core/list'
	];

}

#2 Включаємо блоки для типу запису

Цей приклад дає змогу включити блок shortcodeтільки для типів записів post і page:

add_filter( 'allowed_block_types', 'allow_my_block_types', 10, 2);
function allow_my_block_types( $allowed_blocks, $post ){

	$allowed_blocks = [
		'core/image',
		'core/paragraph',
		'core/heading',
		'core/list'
	];

	if( in_array( $post->post_type, ['post','page'] ) ){
		$allowed_blocks[] = 'core/shortcode';
	}

	return $allowed_blocks;

}

#3 Список можливих ярликів для `$allowed_block_types`

Common blocks

core/paragraph
core/image
core/heading
core/gallery
core/list
core/quote
core/audio
core/cover
core/file
core/video

Formatting

core/table
core/verse
core/code
core/freeform
core/html
core/preformatted
core/pullquote

Layout Elements

core/button
core/columns
core/text-columns
core/media-text
core/more
core/nextpage
core/separator
core/spacer

Widgets

core/shortcode
core/archives
core/categories
core/latest-comments
core/latest-posts

Embeds

core/embed
core-embed/twitter
core-embed/youtube
core-embed/facebook
core-embed/instagram
core-embed/wordpress
core-embed/soundcloud
core-embed/spotify
core-embed/flickr
core-embed/vimeo
core-embed/animoto
core-embed/cloudup
core-embed/collegehumor
core-embed/dailymotion
core-embed/funnyordie
core-embed/hulu
core-embed/imgur
core-embed/issuu
core-embed/kickstarter
core-embed/meetup-com
core-embed/mixcloud
core-embed/photobucket
core-embed/polldaddy
core-embed/reddit
core-embed/reverbnation
core-embed/screencast
core-embed/scribd
core-embed/slideshare
core-embed/smugmug
core-embed/speaker
core-embed/ted
core-embed/tumblr
core-embed/videopress
core-embed/wordpress-tv