Переводы интерфейса администратора
В интерфейсе бэкенда 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'
Вы можете предложить улучшение документации или задать вопрос в комментариях.
Если вам нужна полноценная консультация — вы можете заказать её на нашем сайте.