docs.modx.pro
  1. Компоненты
  2. Localizator3

Localizator3 ​

Мультиязычность для MODX Revolution 3 без отдельных контекстов. Для MODX 2.x остаётся Localizator.

Возможности ​

  • Языки в меню Localizator3 (страница «Локализации»)
  • Вкладка Локализация у ресурса и товара MiniShop3
  • Автоперевод: Yandex, Google, DeepL, LibreTranslate, MyMemory или копирование без перевода
  • Выборка через getLocalizedResources поверх pdoResources, pdoMenu, msProducts и ms3Products
  • Fenom-модификаторы locfield, locoptioncaption, locproductoptionvalue
  • SEO: getLocalizedCanonical, getLocalizedSitemap
  • Индексация локализованных полей в mSearch
  • Событие OnBuildLocalizationTabs для своих полей формы

Системные требования ​

ТребованиеВерсия
MODX Revolution3.0+
PHP8.2+
VueTools1.1.2-pl+
pdoTools2.11.3-pl или новее
ЧПУвключены

По желанию: MiniShop3, mSearch.

Жёсткие требования транспорта: только PHP и MODX.

  • Если VueTools нет, резолвер пытается скачать первую запись vuetools у провайдера. Резолвер сам не обновляет уже стоящий VueTools ниже 1.1.2-pl.
  • Резолвер скачивает первую запись pdoTools, если пакета нет или установленная версия старше 2.11.3-pl.
  • Ошибка скачивания VueTools или pdoTools установку Localizator3 не откатывает.

Вкладка и страница «Локализации» показывают предупреждение, если сервис vuetools не поднялся или нет собранного languages.min.js / бандла вкладки. Без pdoTools сниппет getLocalizedResources не находит pdoResources.

Зависимости ​

  • pdoTools: выборка и вывод ресурсов
  • VueTools: Vue-интерфейс вкладки и страницы «Локализации»

Установка ​

Через ModStore ​

  1. Подключите провайдер modstore.pro.
  2. Установите VueTools 1.1.2-pl+, если его ещё нет.
  3. Найдите Localizator3 в Управление пакетами, скачайте и установите.
  4. Очистите кэш MODX.

Пакет: modstore.pro/packages/utilities/localizator3.

После установки ​

  1. Создайте языки в меню Localizator3 (страница «Локализации»).
  2. Задайте localizator3_default_language. Пустой ключ заменяется первым активным языком по рангу: страница, автоперевод в менеджере, CLI translate_resources.php. Без настройки и без активного языка автоперевод и CLI останавливаются с ошибкой.
  3. Включите нужные TV флагом «TV доступно в локализациях».
  4. Заполните вкладку Локализация у ресурсов.
  5. Списки на сайте выводите через getLocalizedResources.

Резолвер пишет pdotools_fetch_class = ModxPro\PdoTools\FetchLocalizator (наследник Fetch). Класс подключает bootstrap пространства имён Localizator3 через Composer PSR-4, поэтому getLocalizedResources и сниппеты pdoTools отдают локализованные поля.

Быстрый старт и Системные настройки.