enter_title_hereхук-фильтрWP 3.1.0

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

Пример плейсхолдера при добавление новой записи
Пример плейсхолдера в виджете в дашборде.
Относится только к записям (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().

Примеры

0

#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;
}
0

#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;
}
0

#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;
}

Список изменений

С версии 3.1.0 Введена.

Где вызывается хук

В файле: /wp-admin/edit-form-advanced.php
enter_title_here
wp-admin/edit-form-advanced.php 545
$title_placeholder = apply_filters( 'enter_title_here', __( 'Add title' ), $post );
wp-admin/edit-form-blocks.php 196
'titlePlaceholder'     => apply_filters( 'enter_title_here', __( 'Add title' ), $post ),
wp-admin/includes/dashboard.php 591
echo apply_filters( 'enter_title_here', __( 'Title' ), $post );

Где используется хук в WordPress

Использование не найдено.