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 об'єкт.
 *
 * @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 = workers (див. register_post_type() ), тоді плейсхолдер для цього типу запису можна змінити так:

add_filter( 'enter_title_here', 'workers_enter_title_here', 10, 2);
function workers_enter_title_here( $text, $post ) {
	if ( $post->post_type === 'workers' ) {
		$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;
}