enter_title_here
Это хук WordPress - enter_title_here. Плагин его просто использует.
Позволяет изменить текст плейсхолдера (подсказку) у поля "Заголовок" при добавлении нового поста (записи).


Относится только к записям (post_type = post)
Использование
add_filter( 'enter_title_here', 'wp_kama_enter_title_here_filter', 10, 2 );
/**
* Function for `enter_title_here` filter-hook.
*
* @param string $text Placeholder text.
* @param WP_Post $post Post object.
*
* @return string
*/
function wp_kama_enter_title_here_filter( $text, $post ){
// filter...
return $text;
}
- $text(строка)
- Текст плейсхолдера (подсказки).
По умолчанию: __( 'Enter title here' ) (Введите заголовок) - $post(WP_Post)
- Объект поста. Структуру объекта смотрите в описании к get_post().
Примеры
#1 Изменим текст плейсхолдера для своего типа записи
Пусть создан тип поста "Сотрудники" со slug = worker (см. register_post_type()), тогда плейсхолдер для этого типа записи можно изменить так:
add_filter( 'enter_title_here', 'worker_enter_title_here', 10, 2 );
function worker_enter_title_here( $text, $post ) {
if ( $post->post_type === 'worker' ) {
$text = 'Введите ФИО сотрудника';
}
return $text;
}
#2 Изменим плейсхолдер при добавлении поста или страницы
## Изменим плейсхолдер при добавлении поста или страницы
add_filter( 'enter_title_here', 'post_enter_title_here', 10, 2 );
function post_enter_title_here( $text, $post ){
// при добавлении поста
if ( $post->post_type === 'post' ) {
$text = 'Как будет называться ваша чудесная статья?';
}
// при добавлении страницы
if ( $post->post_type === 'page' ) {
$text = 'Введите короткое и понятное название страницы';
}
return $text;
}
#3 Изменим плейсхолдер при создании черновика через виджет в дашборде
add_filter( 'enter_title_here', 'dashboard_enter_title_here' );
function dashboard_enter_title_here( $text ) {
if ( get_current_screen()->base === 'dashboard' ) {
$text = 'Введите заголовок будущей статьи';
}
return $text;
}Где вызывается хук
enter_title_here
acf/includes/admin/views/global/form-top.php 13
$acf_title_placeholder = apply_filters( 'enter_title_here', __( 'Add title' ), $post );
Где используется хук в Advanced Custom Fields PRO
acf/includes/acf-post-type-functions.php 293
$export .= "\r\nadd_filter( 'enter_title_here', function( \$default, \$post ) {\r\n";
acf/includes/post-types/class-acf-post-type.php 85
add_filter( 'enter_title_here', array( $this, 'enter_title_here' ), 10, 2 );