docs.modx.pro
  1. Компоненты
  2. Localizator3
  3. Быстрый старт

Быстрый старт ​

Требования ​

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

Шаг 1: Установка ​

  1. Подключите провайдер modstore.pro.
  2. Установите VueTools, затем Localizator3.
  3. Управление → Очистить кэш.

Шаг 2: Язык по умолчанию ​

В системных настройках задайте localizator3_default_language ключом одного из языков (например ru). Пустой ключ заменяется первым активным языком по рангу. Без настройки и без активного языка автоперевод в менеджере и CLI translate_resources.php останавливаются с ошибкой.

Шаг 3: Языки и локализации ​

  1. Откройте меню Localizator3 (страница «Локализации») и создайте языки:
    • «Ключ локализации» (ru, en)
    • «Название»
    • «HTTP HOST»
    • «Ключ языка»
    • «Активно»
  2. В форме TV включите «TV доступно в локализациях» у нужных полей.
  3. У ресурса откройте вкладку Локализация, выберите язык, сохраните локализацию. Кнопка «Автоматический перевод» включается у уже сохранённой записи. После этого заполните поля или запустите автоперевод.

Адреса вида site.ru/en/: Системные настройки.

Шаг 4: Вывод контента на сайте ​

Поля ресурса подменяются локализованными значениями. Поле content идёт в localizator3_content. В Fenom это {$_modx->resource.localizator3_content}.

Списки ресурсов выводите через getLocalizedResources. Резолвер пишет pdotools_fetch_class = ModxPro\PdoTools\FetchLocalizator. Класс подключает bootstrap пространства имён, локализованная выборка через pdoTools работает.

fenom
{'!getLocalizedResources' | snippet : [
  'snippet' => 'pdoMenu',
  'parents' => 0,
  'level' => 1,
]}
modx
[[!getLocalizedResources?
  &snippet=`pdoMenu`
  &parents=`0`
  &level=`1`
]]

Переключатель: Переключение языков. Параметры сниппета: getLocalizedResources.

Что дальше ​