Gettext хук-фильтр . WP 2.0.11

Click here to view original web page at wp-kama.ru

Позволяет изменить текст перевода.

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

add_filter( 'gettext', 'filter_function_name_1010', 10, 3 );
function filter_function_name_1010( $translation, $text, $domain ){
	// Изменяем...

	return $translation;
}

$translation(строка): Переведённый текст. В файлах *.po помечен как msgstr.
$text(строка): Текст для перевода. В файлах *.po помечен как msgid.
$domain(строка): Текстовый домен. Уникальный идентификатор для получения переведенных строк. Указывается при подключении MO файла перевода в функции load_textdomain().

Примеры

#1 Заменим "Комментарии" на "Отзывы"

Заменим в админке на странице управления комментариями заголовок с "Комментарии" на "Отзывы".

На странице управления комментариями (edit-comments.php) слово "Комментарии" выводится с помощью этого кода:

Так как через фильтр проходит огромное количество переводов, а нам необходимо перевести определенную фразу и только в нужном месте, то используем условие:

Запрашивается перевод слова "Comments"
Запрашивается домен default (перевод самого WordPress)

add_filter( 'gettext', 'filter_gettext', 10, 3 );

function filter_gettext( $translation, $text, $domain ) {
	if ( $text === 'Comments' && $domain === 'default' ) {
		$translation = 'Отзывы';
	}

	return $translation;
}

Возникает вопрос, почему на скриншотах слово "Комментарии" не изменились в правом меню? В файле wp-admin/menu.php мы можем найти код этого пункта меню:

$menu[25] = array(
	/* translators: %s: Number of comments. */
	sprintf( __( 'Comments %s' ), '<span class="awaiting-mod count-' . absint( $awaiting_mod ) . '"><span class="pending-count" aria-hidden="true">' . $awaiting_mod_i18n . '</span><span class="comments-in-moderation-text screen-reader-text">' . $awaiting_mod_text . '</span></span>' ),
	'edit_posts',
	'edit-comments.php',
	'',
	'menu-top menu-icon-comments',
	'menu-comments',
	'dashicons-admin-comments',
);

То есть, фраза для переводов здесь уже Comments %s, а значит наш код должен быть таким:

add_filter( 'gettext', 'filter_gettext', 10, 3 );

function filter_gettext( $translation, $text, $domain ) {
	if ( $text === 'Comments %s' && $domain === 'default' ) {
		$translation = 'Отзывы %s';
	}

	return $translation;
}

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

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

gettext

Где используется хук (в ядре WP)

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

Читать полностью wp-kama.ru

Статьи

gettext хук-фильтр . WP 2.0.11