Мультиязычность в MODx EVO. Модуль YAMS

Для реализации в MODx мультиязычности существует модуль YAMS. Гугл выдает множество ссылок на форумы, где обсуждается этот вопрос, однако так просто YAMS мне не дался. Поэтому делюсь опытом.

Установка

1. Скачиваем модуль здесь. В файле readme есть инструкция по установке и настройке, конечно же на английском языке. 
2. Распаковываем содержимое архива в папку модулей (assets/modules/).
3. Создаем плагин

   Название	YAMS
   Описание	Плагин для решения мультиязычности
   Код плагина	require( $modx->config['base_path'] . 'assets/modules/yams/yams.plugin.inc.php');
   Системные события	OnLoadWebDocument OnParseDocument OnWebPageInit OnWebPagePrerender OnLoadWebPageCache OnPageNotFound OnBeforeDocFormSave

   
   
4. Создаем сниппет

   Название	YAMS
   Описание	Получение мультиязыкового контента
   Код сниппета	<? require( $modx->config['base_path'] . 'assets/modules/yams/yams.snippet.inc.php' ); ?>

5. Создаем сам модуль YAMS

   Название	YAMS
   Описание	Решение мультиязычности
   Код сниппета	require_once( $modx->config['base_path'] . 'assets/modules/yams/yams.module.inc.php' );

6. Перезагружаем страницу, чтобы модуль появился в меню и открываем. При первом открытии запустится установка модуля. 
   Внимание! Не забудьте проверить, что папка yams доступна для записи. Модулю YAMS требуется возможность записи файла конфига (yams.config.ini.php).

Настройка

Если у вас еще не были включены дружественные URL - включите их в конфигурации сайта. Также необходимо разрешить вложенные URL.
Модуль представлен пятью вкладками:

1. Общая информация с кучей ссылок и историей версий.
2. Настройки языков. По умолчанию на этой вкладке представлены сразу 5 языков! Английский, французский, японский, немецкий и русский. Английский язык стоит как язык по умолчанию. Я при первом же осмотре страницы удалила все ненужные мне языки, оставив лишь английский и русский. Русский язык активировала и установила языком по умолчанию.
3. Конфигурация сервера, а точнее настройки .htaccess для дружественных URL. Скопируйте все, приведенное там в свой .htaccess, а старые настройки сотрите.
4. Прочие параметры. Эту вкладку я не трогала, оставила все по умолчанию.
5. Мультиязыковые шаблоны. Здесь представлены все шаблоны сайта, для которых можно добавить мультиязычность или удалить. Стоит отметить, что YAMS при добавлении мультиязычности шаблону, создает для него tv-параметры заголовка (pagetitle), расширенного заголовка (longtitle), описания (description), пункта меню (menutitle) и контента (content) ДЛЯ КАЖДОГО ЯЗЫКА. Делает это он добавлением к названию tv-параметра соответствующей приставки (например, _ru или _en).
   Необходимо отметить, что при удалении шаблона или самого YAMS все TV-параметры останутся, их нужно удалять вручную.

Переключение языка на сайте

И вот, казалось бы, все готово, пора и проверить модуль в действии. Для этого добавляем один из вызовов сниппета в нужный шаблон или чанк:

[[YAMS? &get=`list`]]// будет выведен список языков ссылками

или

[[YAMS? &get=`selectform`]] // будет выведен выпадающий список языков

Для задания собственного шаблона (более подробно - в документации по сниппету) используйте

[[YAMS? &get=`repeat` &repeattpl=`otherFlagItemTpl` &currenttpl=`currentFlagItemTpl` ]]

Ditto и YAMS

Как я только не извращалась с вызовом плейсхолдеров дитто, чтобы эта мультиязычность заработала. Но все гениальное просто! Для некэшируемого вызова дитто (напоминаю - [! !]) я изменила параметр id и добавила два новых:
&id=`(yams_id)_old_ditto_id` 
&language=`(yams_mname)`
&extenders=`@FILE assets/modules/yams/yams.extender.inc.php`
При таком вызове Ditto нет необходимости менять шаблоны. Если посмотреть расширение, которое мы подключили, то обнаружим в нем переопределение плейсхолдеров, которое позволяет нам не париться больше ни о чем :)

Другие полезности

Для перевода конкретного куска текста на нужный язык используйте конструкцию:

[[YAMS? &get=`text` &from=`ru::Пример||en::Example`]]

(yams_docr:docId) // ссылка на docId с учетом языка

Полезные ссылки:

• Установка модуля, плагина и сниппета YAMS в Modx
• MODx Yams - мультиязычные сайты на modx Evo
• Документация, которая представлена сразу в трех языках