Мультиязычность modx – Мультиязычность в MODX с Babel. Развернутое руководство. Автоматический перенос ресурсов

В расширенной конфигурации Вы можете определить несколько групп контекстных клавиш с помощью точки с запятой (;) в качестве разделителя. Это пригодится для администрирования нескольких многоязычных сайтов в одном образце MODx.

Пример:

ёsite1: en, de, fr. c контекстами web, site1de, site1fr<

site2: en, de. с контекстами site2en, site2de

Вы выбираете babel.contextKeys для « web,site1de,site1fr;site2en,site2de«.

• Имя Babel TV (babel.babelTvName): Имя шаблонной переменной (TV), в которой Babel будет хранить ссылки между мультиязычными ресурсами. Эту TV будет поддерживать Babel. Пожалуйста, не изменяйте TV в ручном режиме, иначе Ваши ссылки между переведенными версиями могут быть утрачены.

• ID шаблонных переменных должны быть синхронизированы (babel. syncTvs): разделенный запятыми список идентификаторов шаблонных переменных (TV), которые Babel должен синхронизировать.

Как пользоваться

При открытии ресурса для редактирования Babel Box будет отображаться в верхней части формы ресурса. Там же находятся ссылки в виде кнопок для каждого из языков (контекстов), заданных в настройках системы babel.contextKeys.

Три различных цвета, в которых могут отображаться кнопки, означают:

• Черный: язык ресурса, отображающегося в данный момент.

• Зеленый: язык, для которого определена переведенная версия ресурса.

• Светло-серый: язык, для которого переведенная версия пока не была создана или определена.

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

Если перевод не определен для данного языка (серая кнопка), наведите курсор мыши на языковую кнопку – появляется окно, в котором можно задать Babel создать перевод текущего ресурса, или вставить ссылку перевода на существующий ресурс вручную, для чего требуется ввести ID переведенного ресурса.

Кликая на «Create Translation», Вы задаете Babel создать новый ресурс в контексте языка и скопировать все содержимое текущего ресурса для вновь созданного. Далее Вы можете перевести вест контент, TV и опубликовать переведенный ресурс.
Если Вы хотите удалить ссылку на переведенную версию, просто наведите курсор мыши на зеленую кнопку языка: появляется окно с опцией «Unlink translation» для ее удаления.

Сниппеты

В настоящее время два сниппета доступны для Babel: BabelLinks и BabelTranslation.

Изменение настроек Babel после установки

Вы можете изменить настройки Babel после установки. Например, если Вы хотите определить новую TV, которая должна быть синхронизирована, или добавить новый контекст. Для этого перейдите в System/Settings в менеджере MODx и выберите местоположение babel. Теперь Вы можете редактировать все параметры Babel:

BabelLinks

BabelLinks – это snippet, который отображает ссылки на другие языки (контексты) для конечного пользователя.

Доступные параметры

BabelLink Chunk

Если параметр &tpl не установлен, по умолчанию Chunk будет использоваться со следующим кодом:

<li><a href="[[+url]]">[[%babel.language_[[+cultureKey]]? &topic=`default` &namespace=`babel`]]</a></li>

Используя собственный блок для отображения языковых ссылок, Вы можете использовать следующие идентификаторы (placeholders):

Пример

[[BabelLinks]]

BabelTranslation

Snippet BabelTranslation возвращают ID переведенных ресурсов в данном контексте.

Доступные параметры

Имя	Описание	По умолчанию
resourceId	(опция) ID ресурса, на основе которого должен быть определен переведенный ресурс.	ID текущего ресурса
contextKey	Ключ контекста, в котором переведенный ресурс должен быть определен.
showUnpublished	(опция) Флажок, для просмотра неопубликованных переводов	0

Пример

Чтобы вернуть ID переведенного ресурса, который находится в «de» контексте текущего ресурса.

---

что оптимальнее? / Блог им. MrJenika / MODX.im

Здравствуйте, по роду занятий приходится делать в основном мультиязычные сайты. Пробовал и на revo и на evo.
Пройдя через все возможные глюки, неудобство и просто непонимание со стороны заказчика, в рамках изучения модх решил придумать что-то своё. В связи с этим хочу спросить совета у более опытных коллег для выявления оптимального варианта.
Часть рассмотренных проблем также взяты из большого количества постов на эту тему.

Речь идет о ветке ево — уж очень она симпатична мне.
Рассмотрю возможные варианты.

1) YAMS — хранение перевода в дополнительных полях (tv)

+++ все на одной странице
+ добавить новый язык просто

— сложность в настройке
— куча tv параметров
— сложная выборка всех этих tv
— проблем с Ditto и с Wayfinder
— проблема с пагинацией
— не работает со сборкой Dmi3yy

2) Дублирование дерева ресурсов

(по версии Dmi3yy — e-kao.ru/multilingual)

+ каждая версия может существенно отличаться
+ относительно просто в настройке
+ все сниппеты работают без проблем

— для перевода необходимо бегать по всему дереву
— больше 2-х языков уже превращается в головную боль
— секретарша возмущалось что «как-то все замудренно…»
— к готовому сайту это решение уже не применить

Как вариант можно дописать плагин на подобие Babel для рево (идея Dmi3yy), это немного облегчит задачу создания переведенного документа, но не на много.

3) Свой вариант

Хранить перевод в своей таблице с выводом всех полей для перевода во вкладках ресурса

+ все на одной странице
+ это СВОЕ
+ прикручивать можно к уже готовым сайтам

— продумать
— написать
— протестировать
— и пока непонятно как оно должно работать

Оптимально ли это и не получится ли такая же ерунда как и с хранением перевода в tv? Или это не так уж и страшно?

Жду вашей критики.

Мультиязычность ТВ параметров / Русскоязычное сообщество MODX

На сайте реализована мультиязычность через Babel.
Разным языкам соответствует свой домен.

например:
ru.domain.com — для контекста web (ru)
en.domain.com — для контекста en
it.domain.com — для контекста it

вывод в шаблоне разноязычных частей (где это необходимо) реализован различными чанками через:

[[*context_key:is=`web`:then=`[[$header-ru]]`:else=``]]
  [[*context_key:is=`en`:then=`[[$header-en]]`:else=``]]
  [[*context_key:is=`it`:then=`[[$header-it]]`:else=``]]

соответственно пример для вывода ТВ-параметров реализован так (Тип вывода: Список (одиночный выбор)):

Golf / Golf / Гольф==[[*context_key:is=`web`:then=`Гольф`:else=``]][[*context_key:is=`en`:then=`Golf`:else=``]][[*context_key:is=`it`:then=`Golf`:else=``]]
||Sci / Ski resorts / Горнолыжные курорты==[[*context_key:is=`web`:then=`Горнолыжные курорты`:else=``]][[*context_key:is=`en`:then=`Ski resorts`:else=``]][[*context_key:is=`it`:then=`Sci`:else=``]]
||Città / Town / Город==[[*context_key:is=`web`:then=`Город`:else=``]][[*context_key:is=`en`:then=`Town`:else=``]][[*context_key:is=`it`:then=`Città`:else=``]]
||Centro storico / Historical centers / Историческиe центры==[[*context_key:is=`web`:then=`Историческиe центры`:else=``]][[*context_key:is=`en`:then=`Historical centers`:else=``]][[*context_key:is=`it`:then=`Centro storico`:else=``]]
||Mare / Seaside / Море==[[*context_key:is=`web`:then=`Море`:else=``]][[*context_key:is=`en`:then=`Seaside`:else=``]][[*context_key:is=`it`:then=`Mare`:else=``]]
||Laghi / Lakes / Озера==[[*context_key:is=`web`:then=`Озера`:else=``]][[*context_key:is=`en`:then=`Lakes`:else=``]][[*context_key:is=`it`:then=`Laghi`:else=``]]
||Colline / Hills / Холмы==[[*context_key:is=`web`:then=`Холмы`:else=``]][[*context_key:is=`en`:then=`Hills`:else=``]][[*context_key:is=`it`:then=`Colline`:else=``]]

Итак закончим с преамбулой и перейдем к самому вопросу.
Был приобретен великолепный mSearch3. Все работает. Но возникла проблема с фильтрацией по ТВ параметру. В выборе фильтрации выводится на нужном языке, считаются все варианты, но при выборе галочкой — не показывает ничего (((

Факт в том, что mFilter2 фильтрует значения, которые сохранены в БД. У меня, получается, в БД сохраняются значения типа:

Golf / Golf / Гольф==[[*context_key:is=`web`:then=`Гольф`:else=``]][[*context_key:is=`en`:then=`Golf`:else=``]][[*context_key:is=`it`:then=`Golf`:else=``]]

Потом это значение выбирает фильтр и выводит на экран. Дальше парсер разбирает его и получается

Гольф
или
Golf
или
Golf

И при попытке фильтрации на сервер уходит именно эта строка. А в БД, напоминаю, находится не она, а моё длинющее выражение с фильтрами. Вот и получается, что содержимое БД и запрос не совпадают, и фильтр не работает. (((

Как из этой ситуации выходить?
Есть совет поискать разработчика, который хотя-бы знает, что в MODX есть лексиконы и как их можно использовать. Как можно реализовать мультиязычность ТВ?

Допусловие: Надо, чтобы в админке выбор ТВ параметра могли видеть (понимать) как русскоговорящие админы, так и англо/итальяноговорящие, то есть на своем родном языке как в админке.

evoBabel — мультиязычные сайты на MODx EVO

Как обычно бывает — встала задача, неразрешимая средствами YAMS и очень неудобно рарзешимая другими средствами — создать мультиязычный сайт, чтобы

• заказчик мог сам добавлять языки
• переводы не были разбросаны по шаблонам, а содержались в одном месте
• чтобы переключалка языков отправляла на нужный ресурс на другом языке
• чтобы нормально без бубна работали сниппеты вроде DocLister, Wayfinder, Breadcrumbs и т.п.
• и главное — чтобы не было жесткой привязки как в YAMS, т.е. структура сайтов на разных языках могла отличаться, а не было необходимости заполнять каждую новость, каждый товар и т.п.

Из всего этого на основе некоторых идей, почерпнутых из REVO Babel и с вооружившись библиотекой MODx API от Agel_Nash был разработан прототип решения evoBabel. Пример можно посмотреть на тестовом сайте.

Ссылка на установочные файлы, там же в файле readme — очень подробное описание как и что устанавливать.

В качестве поля для связи использовал стандартное поле description, т.к. некогда было заморачиваться с дополнительными TV, для вызова самого сниппета использован TV- параметр с типом ввода Custom Input.

Основные полезности:

1. создание неграниченного количества языковых версий сайта при этом каждая версия хранится в своем дереве, что не ограничивает нас никак т.е. структура сайта на разных языках может отличаться (в отличие от YAMS), нет проблем с плейсхолдерами, другими сниппетами и т.п.
2. ресурсы разных языковых версий связаны между собой — что позволяет при навигации переключаться на нужную языковую версию ресурса (за это отвечает сниппет switchLang)
3. Возможна синхронизация значений нужных ТВ параметров для разных версий ресурса (id нужных ТВ задается в настройках плагина evoBabel)
4. Переводы и id нужных ресурсов (каталогов новостей и т.п.) указываются в соответствующих языковых чанках без всяких разделителей || — разделителем служит перенос строки \n

Если у кого-то есть интерес и желание потестировать и предложить пути доработки — пожалуйста.

upd

upd2 — обновился архивчик на github

upd3 — удален сниппет switchLang, его функционал перенесен в плагин evoBabel на событие onWebPageInit (он соответственно, тоже обновился). В результате полностью решена проблема с мультиязычными формами на кэшированных страницах 🙂

Добавлен модуль для переводов. Теперь никаких чанков. Модуль на основе jquery easy ui, с ajax-редактированием инлайн, фильтром/поиском, сортировкой по алфавиту по-умолчанию (чтоб было проще искать), возможностью добавления и удаления новых лексиконов. Плюс, соовтетственно, переписан сниппет switchLang для выборки перевода из базы.

upd 30.12.2013
Обновил до версии 0.2 — github.com/webber12/evobabel-0.2 — скачать архив можно тут

Из основного:
— убрал библиотеку MODxAPI — т.к. отслеживать ее актуальность тяжеловато, да и тягать за собой ради пары функций особого смысла нет.
— ООП
— и главное — хранение языковых связей теперь осуществляется в TV (причем в том же TV, который используется для показа этих связей в админке)
это решает сразу несколько задач:
1. поле description не используется и соответственно пользователь не может повредить связи
2. поле TV для хранения связей имеет вид custom input и также напрямую не выводит нужные связи, что мешает их повредить
3. и все таки, если нужно что-то подправить, админ может переключить тип поля с custom input на обычный text и подправить если нужно. Т.е. в отличие от хранения связей в отдельных таблицах к ней все-таки есть доступ при наличии определенных навыков админа. Ну а без навыков — пусть лучше и не лезет, да и не получится у него 🙂

— подправил плагин для языковых плейсхолдеров [%перевод%] — теперь ищет лучше.

upd 01/03/2018 — актуальный внешний вид модуля

и языковой панели в нижней части страницы

upd 27.11.2018 — актуальный вид переключалки языков

видео