Перейти к основному содержимому

Переводы интерфейса администратора

В интерфейсе бэкенда Pimcore есть несколько компонентов, которые в каждом проекте настраиваются по‑разному. К ним относятся

  • Имена классов объектов
  • Метки полей объектов
  • Компоненты макета объектов
  • Типы документов
  • Предопределенные свойства
  • Пользовательские представления
  • Редактируемые элементы документов (document editables)

Все эти элементы, за исключением document editables, можно переводить в Settings > Admin Translations аналогично общим переводам (Shared Translations). Для перевода доступны все установленные системные языки. Также возможно переопределять системные переводы, поставляемые с Pimcore, поэтому, по сути, вы можете переводить любой текст в интерфейсе бэкенда.

Строки, которые подпадают под особые переводы, но ещё не переведены, отображаются с символом "+" перед строкой и после неё, если в системных настройках (Settings > System Settings) включена опция Debug Admin-Translations (wrapped in +).

Но вы можете использовать административные переводы и в ваших собственных шаблонах. Переводы администратора используют тот же компонент переводчика (Symfony), но другой домен.

Логика чувствительности к регистру для admin translations такая же, как и для общих переводов.

Пример: перевод опций Select‑поля в языке текущего пользователя

{{ pimcore_select("select", {  
"store": [
["option1", {{ "Option One"|trans({}, 'admin', pimcore_editmode_admin_language()) }}],
["option2", {{ "Option Two"|trans({}, 'admin', pimcore_editmode_admin_language()) }}],
["option3", {{ "Option Three"|trans({}, 'admin', pimcore_editmode_admin_language()) }}]
]
}) }}

Добавление собственных языков админки (с версии 6.3.6)

Pimcore поставляется с набором переводов, которые управляются через POEditor. Есть перечень основных переводов и отдельный расширенный список переводов. Тем не менее количество доступных языков в основном дистрибутиве ограничено, поскольку включаются только те языки, у которых достигнут определённый прогресс перевода. Если вы хотите сделать дополнительные языки доступными для интерфейса админки, вы можете поместить файл перевода Symfony для нужного языка в стандартный путь для переводчика Symfony (например, поместите translations/admin.af.yaml, чтобы добавить Afrikaans, файл перевода может быть и пустым). Если вы не меняли конфигурацию, по умолчанию этот путь для проектов Symfony 4 — %kernel.project_dir%/translations.

Переопределение языка админ‑переводов в режиме редактирования документов (editmode)

В некоторых проектах требуется использовать другой язык для админских переводов в режиме редактирования документов, например английский (en) вместо хорватского (hr), или zh_Hans вместо zh.

# config/config.yaml  
pimcore:
translations:
admin_translation_mapping:
'hr': 'en'
'zh': 'zh_Hans'


Вы можете предложить улучшение документации или задать вопрос в комментариях.
Если вам нужна полноценная консультация — вы можете заказать её на нашем сайте.