Должен ли я использовать t () в описании hook

11

Я всегда использовал t () для заголовка и описания hook_menus следующим образом:

$items['some-path'] = array(
    'title' => t('My Page Title'),
    'description' => t('This is a description about what my page is for'),
    'page callback' => 'profile_user_page',
);

Это имеет смысл для меня, поэтому пользователи могут переводить заголовок и описание на разные языки, если это необходимо.

Однако этот комментарий к обзору модуля на DO говорит:

Нет, это неправильно, не делайте этого - описания в hook_menu () никогда не должны использовать t ().

В чем причина этого и действительно ли это лучшая практика?

Кроме того, если это так, то не должны ли мы использовать t () для заголовка?

7 i18n-l10n routes

— Феликс Ева
источник

Ясно, что это не должно использоваться тогда, но если вы ищете на странице справки hook_menu «description» => t («есть 6 случаев, так что очевидно, что это распространенная ошибка!

— Феликс Ева

1

Обычное или нет, это не оправдание;) И эти случаи есть в комментариях - люди могут ошибаться там.

— Молот

1

@ Mołot Они могут ошибаться, но многие новые пользователи будут копировать и вставлять этот код, так что это будет распространенной ошибкой. Я думаю, что кто-то с правами администратора на DO должен отредактировать эти комментарии, чтобы удалить t ().

— Феликс Ева

Вы можете подать вопрос, если хотите.

— Молот

1

Хорошее предложение. Готово .

— Феликс Ева

17

См. Строки в известных местах: встроенные меню, разрешения, сообщения журнала и документация сообщества .info-файлов :

Система меню Drupal 6 и 7 хранит названия и описания пунктов меню на английском языке. Это позволяет системе кэшировать данные, но отображать их пользователям по запросу на разных языках. Чтобы это работало, вы не должны использовать t () в заголовке или описании пунктов меню в вашей реализации hook_menu (). Кроме того, вы должны попытаться использовать буквальную строку (а не динамическую строку) для этих двух ключей, чтобы экстрактор шаблона перевода мог найти использованную вами строку.

Акцент мой.

— МОЛОТ
источник

Я бы добавил: Только если title callbackне установлено, потому что по умолчанию title callbackэто t()функция

— milkovsky

1

@milkovsky, если установлен обратный вызов заголовка, он должен позаботиться о t()вас, и вы все равно не должны использовать его в hook menu()кешировании.

— Молот

11

Если вы видите документацию по аргументам hook_menu ..

"название": обязательно. Непереведенный заголовок пункта меню.
«обратный вызов заголовка»: функция для создания заголовка; по умолчанию t (). Если вам требуется выводить только необработанную строку, установите для этого параметра значение FALSE.
«аргументы заголовка»: Аргументы для отправки в t () или в ваш пользовательский обратный вызов с подстановкой компонента пути, как описано выше.
«описание»: непереведенное описание пункта меню.

По умолчанию заголовок обратного вызова является функцией t .. Так что он всегда переводится ..

— Анил Сагар
источник

7

Так как Drupal 6 больше не нужен.

Пожалуйста, прочитайте https://drupal.org/node/140311 . Цитируя это:

Начиная с 6.x, Drupal внутренне обрабатывает перевод названий и описаний меню на местный язык пользователя. Описания, если они есть, всегда переводятся с помощью t (); нет никакой возможности передать дополнительные данные для замены заполнителей (в D5 и ранее передача замен была нежелательной практикой - с этим изменением система меню непосредственно применяет это правило). По умолчанию заголовки переводятся с помощью t (), но замена строки в стиле t () возможна благодаря использованию нового свойства аргументов заголовка. Вы также можете заменить t () своим собственным обратным вызовом.

— penyaskito
источник

6

Вы не должны использовать t()в hook_menu()реализациях, потому что t()позже вызывается автоматически, и это приведет к двойному переводу.

— Арам Бояджян
источник

* Обратите внимание, что если вы добавляете a title callbackв hook_menu, а если нет t, обратный вызов заголовка отвечает за перевод строки.

— АйешК

0

Это ясно говорит на странице документации для hook_menu () т.е.

https://api.drupal.org/api/drupal/modules%21system%21system.api.php/function/hook_menu/7.x

"название": обязательно. Непереведенный заголовок пункта меню.

«описание»: непереведенное описание пункта меню.

Так что нет необходимости использовать функцию t () для обоих выше.

— webdevfreak
источник

Должен ли я использовать t () в описании hook_menu?