Позволяет изменить текст перевода.
Использование
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; }
До применения фильтра
![До применения фильтра](https://wp-kama.ru/wp-content/cache/thumb/0b/9bec3fd426cf80b_600x0_notrise.webp)
После применения фильтра
![После применения фильтра](https://wp-kama.ru/wp-content/cache/thumb/f5/457a3f57d7c51f5_600x0_notrise.webp)
Возникает вопрос, почему на скриншотах слово "Комментарии" не изменились в правом меню? В файле 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)
Использование не найдено.