use_block_editor_for_post_type
Позволяет включить/отключить возможность редактировать контент через Gutenberg (редактор блоков WordPress) для типа записи.
В версии WP 5.0 появился новый редактор кода - Gutenberg. Используется ли такой редактор для указанного типа записи можно проверить функцией use_block_editor_for_post_type( $post_type ). Хук use_block_editor_for_post_type
срабатывает в конце этой функции и позволяет включить или отключить редактор Гутенберг для отдельного типа записи или для всех типов записей сразу.
Перебить работу этого хука и включить/отключить Гутенберг для отдельной записи (поста), можно через хук use_block_editor_for_post.
Для отключения Гутенберга также можно использовать плагин Classic Editor. Подробнее читайте в отдельной заметке.
Использование
add_filter( 'use_block_editor_for_post_type', 'wp_kama_use_block_editor_for_post_type_filter', 10, 2 ); /** * Function for `use_block_editor_for_post_type` filter-hook. * * @param bool $use_block_editor Whether the post type can be edited or not. * @param string $post_type The post type being checked. * * @return bool */ function wp_kama_use_block_editor_for_post_type_filter( $use_block_editor, $post_type ){ // filter... return $use_block_editor; }
- $use_block_editor(true/false)
- Нужно или нет использовать Гутенберг редактор для типа записи.
По умолчанию: true - $post_type(строка)
- Тип записи для которого проверяется возможность использования блочного редактора Гутенберг.
Примеры
#1 Полностью отключим Гутенберг на сайте
Этот пример показывает как отключить Gutenberg для всех типов записей на сайте, т.е. полностью выключить новый Редактор блоков WordPress.
add_filter( 'use_block_editor_for_post_type', '__return_false', 100 );
#2 Отключение Гутенберга только для указанного типа записи
Разрешим Гутенберг для типа записи post
и отключим его для остальных типов записей.
// Разрешим Гутенберг для типа записи post. add_filter( 'use_block_editor_for_post_type', function( $use, $post_type ){ return in_array( $post_type, [ 'post' ] ); }, 100, 2 );
Список изменений
С версии 5.0.0 | Введена. |
Где вызывается хук
return apply_filters( 'use_block_editor_for_post_type', true, $post_type );
Где используется хук в WordPress
add_action( 'use_block_editor_for_post_type', '_disable_block_editor_for_navigation_post_type', 10, 2 );