wp_default_editor
Визначає, який редактор (яка вкладка) повинен бути показаний за умовчанням (tynimce або html).
Цей фільтр дозволяє встановити вкладку редактора за промовчанням, для цього у фільтрі потрібно повернути одне з двох значень: tynimce
(Вкладка “Візуально”) або html
(Вкладка “Текст”). Так ми можемо жорстко встановити, яку вкладку при редагуванні запису буде виставлено за замовчуванням.
Зазвичай виставляється остання вкладка, тобто. якщо ви редагували запис у візуальному редакторі, то це налаштування зберігається і при наступному заході у вас за умовчанням буде виставлений візуальний редактор і навпаки. Але при встановленні цього фільтра ми жорстко визначимо вкладку за замовчуванням.
Використання
add_filter( 'wp_default_editor', 'wp_kama_default_editor_filter' ); /** * Function for `wp_default_editor` filter-hook. * * @param string $r Which editor повинен бути displayed by default. Either 'tinymce', 'html', або 'test'. * * @return string */ function wp_kama_default_editor_filter( $r ){ // Filter... return $r; }
-
$r
(рядок) -
Тип редактора, який буде встановлено за замовчуванням. Можливо:
tynimce
,
html
,
test
.
Приклади
#1 Налаштування вкладки редактора за замовчуванням
Розмістіть один з наступних кодів у темі functions.php і у вас завжди за замовчуванням буде виставлятися вказана вкладка редактора:
# Встановимо візуальний редактор, за замовчуванням редактором add_filter( 'wp_default_editor', create_function('', 'return "tinymce";') ); # Встановимо HTML (текстовий) редактор, за замовчуванням редактором add_filter( 'wp_default_editor', create_function('', 'return "html";') );
#2 Вкладка за замовчуванням лише при редагуванні певних типів записів
Тут показано, як виставити HTML редактор за замовчуванням, тільки для записів типу post
, func
, hook
:
## Текстовий редактор (text editor) за замовчуванням. Встановлює вкладку текстового редактора як дефолтну, навіть якщо до цього було обрано вкладку tinymce add_filter( 'wp_default_editor', function( $type ){ // Тільки для зазначених типів сторінок $html = in_array( get_current_screen()->post_type, array('post','func','hook') ); return $html? 'html': $type; });
список змін
З версії 2.5.0 | Введено. |
Де викликається хук
return apply_filters( 'wp_default_editor', $r );
Де використовується хук у WordPress
Використання не знайдено.