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().

Примеры

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

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

С версии 3.1.0

Введена.

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

В файле: /wp-admin/edit-form-advanced.php

wp_editor_expand

post_updated_messages

post_edit_form_tag

edit_form_top

enter_title_here

edit_form_before_permalink

edit_form_after_title

edit_form_after_editor

wp-admin/edit-form-advanced.php 545

$title_placeholder = apply_filters( 'enter_title_here', __( 'Add title' ), $post );

wp-admin/includes/dashboard.php 591

echo apply_filters( 'enter_title_here', __( 'Title' ), $post );

wp-admin/edit-form-blocks.php 226

'titlePlaceholder'     => apply_filters( 'enter_title_here', __( 'Add title' ), $post ),

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

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