Документация для конечных пользователей

Xlexicon manual

После установки пакета захожу в Приложения >> xlexicon и получаю ошибку:
 

Fatal error: require_once() [function.require]: Failed opening required 'W:/domains/holograma/core/components/xlexicon/controllers/index.class.php' (include_path='.;W:/modules/php/PHP-5.3.23/;W:/modules/php/PHP-5.3.23/PEAR') in W:\domains\holograma\core\model\modx\modmanagercontroller.class.php on line 936

После установки пакета захожу в Приложения >> xlexicon и получаю ошибку: Fatal error: require_once() [function.require]: Failed opening required 'W:/domains/holograma/core/components/xlexicon/controllers/index.class.php' (include_path='.;W:/modules/php/PHP-5.3.23/;W:/modules/php/PHP-5.3.23/PEAR') in W:\domains\holograma\core\model\modx\modmanagercontroller.class.php on line 936

После установки пакета захожу в Приложения >> xlex

Вот заплатка. Просто перепишите содержимое этого файла и все. Руки не доходят собрать новый пакет, все времени нет.

Вот заплатка. Просто перепишите содержимое этого ф

Ага, теперь все ОК. Спасибо.
 Времени никогда не хватает, если постоянно откладывать, так руки и не дойдут ;)

Ага, теперь все ОК. Спасибо.
 Времени никогда не х

А как переключатель языка сделать и как это выглядит в URL? Не пойму, что-то…

А как переключатель языка сделать и как это выгляд

Подключил чанк [[$example_xlexicon]] и все понял )
 Жаль URL получается вида: site.ru/?cultureKey=en
 site.ru/en/ — так солиднее смотрится
 

И еще не подскажите, как быть с текстами, которые остаются непосредственно в шаблонах или чанках, как их переключать на другой язык?
 Неужели все до мелочей нужно помещать в Ресурсы?
 Даже банальную надпись в footere "Компания Название 2015. Все права защищены." тоже что ли помещать в Ресурсы, по-моему, как то глупо получится…

Подключил чанк [[$example_xlexicon]] и все понял )
 Жаль URL получается вида: site.ru/?cultureKey=en
 site.ru/en/ — так солиднее смотрится И еще не подскажите, как быть с текстами, которые остаются непосредственно в шаблонах или чанках, как их переключать на другой язык?
 Неужели все до мелочей нужно помещать в Ресурсы?
 Даже банальную надпись в footere "Компания Название 2015. Все права защищены." тоже что ли помещать в Ресурсы, по-моему, как то глупо получится…

Подключил чанк [[$example_xlexicon]] и все понял )

Для фикс. записей есть лексиконы

До `site.ru/en/` все руки не доходят

Приведите пример пожалуйста.

`$modx->lexicon('school.basketball')`

Вы можете поторопить процесс:) Внизу есть форма. Штуку-другую закините на эти цели и полетит дело:) А так пока более важные дела есть (включая и другие бесплатные, но более приоритетные модули).

Вы можете поторопить процесс:) Внизу есть форма. Ш

Добрый день! ) Подскажите еще пожалуйста, почему там, где вывод через getResources текст не переключается на другой язык:
 

[[!getResources? 
&parents=`21` 
&includeTVs=`1` 
&hideContainers=`1` 
&showHidden=`1` 
&sortdir=`ASC`
&tpl=`tpl.news` 
&limit=`3`]]

В чанках все стандартно: [[+pagetitle]] [[+description]] и т.д.

Добрый день! ) Подскажите еще пожалуйста, почему там, где вывод через getResources текст не переключается на другой язык: [[!getResources? 
&parents=`21` 
&includeTVs=`1` 
&hideContainers=`1` 
&showHidden=`1` 
&sortdir=`ASC`
&tpl=`tpl.news` 
&limit=`3`]] В чанках все стандартно: [[+pagetitle]] [[+description]] и т.д.

Добрый день! ) Подскажите еще пожалуйста, почему т

Потому что текст переключает сниппетом по названию поля, а не просто так меняются плейсхолдеры.
 

[[!runprocessor?&res=`[[+docid]]`&field=`pagetitle`&ns=`xlexicon`&action=`web/dictionaries/getfield`]]

Потому что текст переключает сниппетом по названию поля, а не просто так меняются плейсхолдеры. [[!runprocessor?&res=`[[+docid]]`&field=`pagetitle`&ns=`xlexicon`&action=`web/dictionaries/getfield`]]

Потому что текст переключает сниппетом по названию

Я так пробовал, тогда просто вместо заголовка из плейсхолдера [[+pagetitle]] везде просто пишется «Главная» то есть название первого документа в ресурсах.

Я так пробовал, тогда просто вместо заголовка из п

Николай, так как правильно выводить id тогда, подскажите пожалуйста?
 

&res=`[[+docid]]` — вот тут что-то не так просто… Пробовал по разному [[*docid]] [[~[[*docid]]]] [[~[[+id]]]]
 Все равно выводит заголовок первого Ресурса — «Главная»

Николай, так как правильно выводить id тогда, подскажите пожалуйста? [[!runprocessor?&res=`[[+docid]]`&field=`pagetitle`&ns=`xlexicon`&action=`web/dictionaries/getfield`]] &res=`[[+docid]]` — вот тут что-то не так просто… Пробовал по разному [[*docid]] [[~[[*docid]]]] [[~[[+id]]]]
 Все равно выводит заголовок первого Ресурса — «Главная»

Николай, так как правильно выводить id тогда, подс

По лексикону за подсказку спасибо! ) Я им еще не пользовался поэтому пришлось разбираться…
 Ожидал ответ более конкретный конечно, ну вроде сам разобрался.
 

А на будущее может кому пригодится:
 1. В Управлении словарями >> Создаем запись — на тех языках, которые нужно
 2. Вызываем в нужном месте через модификатор [[%имя_записи]]

По лексикону за подсказку спасибо! ) Я им еще не пользовался поэтому пришлось разбираться…
 Ожидал ответ более конкретный конечно, ну вроде сам разобрался. А на будущее может кому пригодится:
 1. В Управлении словарями >> Создаем запись — на тех языках, которые нужно
 2. Вызываем в нужном месте через модификатор [[%имя_записи]]

По лексикону за подсказку спасибо! ) Я им еще не п

Смотрите какой плейсхолдер в getResources содержит id документа в итерации. Совершенно не факт, что это [[+docid]]

Смотрите какой плейсхолдер в getResources содержит

Решено! Вот что значит на свежую голову ;)
 

[[!runprocessor?&res=`[[+id]]`&field=`pagetitle`&ns=`xlexicon`&action=`web/dictionaries/getfield`]]

Решено! Вот что значит на свежую голову ;) [[!runprocessor?&res=`[[+id]]`&field=`pagetitle`&ns=`xlexicon`&action=`web/dictionaries/getfield`]]

Решено! Вот что значит на свежую голову ;) [[!runp

Вот и здорово :)

Modx Revo 2.3.3
 Почему когда открываю через Приложение — Xlexicon показывает пустую страницу…

Modx Revo 2.3.3
 Почему когда открываю через Прило

Смотрите комментарий выше.
 Пустая страница — потому что критическая ошибка, а вывод ошибок отключен в настройках сервера. Прокачивайтесь по отладке.

Смотрите комментарий выше.
 Пустая страница — пото

Доброго дня! Xlexicon не размещался в репозитарии modx.com? Не планируете?

Доброго дня! Xlexicon не размещался в репозитарии 

На данный момент есть пара багов с совместимостью. Исправить руки не доходят. Как будет исправлено — появится.

На данный момент есть пара багов с совместимостью.

Сергей, добрый день.
 У меня клиент просит именно `site.ru/en/`
 Не подскажешь, в каком направлении двигаться, чтобы допилить компонент?
 Насколько я понимаю, на входе нужно поменять логику в xlexicon::sanitizeCultureKey()
 А как сделать, чтобы на выходе получался нужный uri?

Сергей, добрый день.
 У меня клиент просит именно 

Зависит от структуры сайта. Если страницы под en нет, то ловить плагином ссылки с en на событие onPageNotFound и отсылать на обычную страницу, попутно выставляя en, как cultureKey.
 Также придется написать что-то кастомное для формирования правильного урл в зависимости от текущего языка.
 Я бы в таком ключе действовал.

Привет. Зависит от структуры сайта. Если страницы под en нет, то ловить плагином ссылки с en на событие onPageNotFound и отсылать на обычную страницу, попутно выставляя en, как cultureKey.
 Также придется написать что-то кастомное для формирования правильного урл в зависимости от текущего языка.
 Я бы в таком ключе действовал.

Привет. Зависит от структуры сайта. Если страницы 

Понял, спасибо. Буду пробовать. 
 

Здравствуете, немогу получить список языков. Можете объяснить?
 [[!runprocessor?ns=`xlexicon`&action=`web/languages/getlist`&ph=`langs`&row=`row`&outer=`outer`]] вставил на шаблон. но пусто (((

Здравствуете, немогу получить список языков. Может

[[!runprocessor?&res=`[[+id]]`&field=`content`&ns=`xlexicon`&action=`web/dictionaries/getfield`]]
 как сделать контент как [[+content:ellipsis=`100`]]

[[!runprocessor?&res=`[[+id]]`&field=`content`&ns=

Пусто в плейсхолдере `[[+langs]]`?

Для текущего ресурса нет смысла получать контент через вызов сниппета. Значение, соответствующее текущему языковому ключу, доступно напрямую.

Для текущего ресурса нет смысла получать контент ч

Для моей текущей задачи решил это вопрос путем добавления RewriteRule в файл .htaccess:
 

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule !^(ru|en)/ /ru%{REQUEST_URI} [L,R=301]
RewriteRule ^(ru|en)?/?(.*)$ index.php?cultureKey=$1&q=$2 [L,QSA]


Все на первый взгляд адекватно работает… 
 Т.е. ссылки с ./ru/ и /en/ передаются как ссылки с соответствующим параметром cultureKey. Русский язык по умолчанию. Так же необходимо в директории manager переименовать файл ht.access в .htaccess(в этом файле отключается переадресация)


Для моей текущей задачи решил это вопрос путем добавления RewriteRule в файл .htaccess: RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule !^(ru|en)/ /ru%{REQUEST_URI} [L,R=301]
RewriteRule ^(ru|en)?/?(.*)$ index.php?cultureKey=$1&q=$2 [L,QSA] Все на первый взгляд адекватно работает… 
 Т.е. ссылки с ./ru/ и /en/ передаются как ссылки с соответствующим параметром cultureKey. Русский язык по умолчанию. Так же необходимо в директории manager переименовать файл ht.access в .htaccess(в этом файле отключается переадресация)

Для моей текущей задачи решил это вопрос путем доб

Да, и в папке ./connectors/ тоже надо добавить файл .htaccess отключающий переадресацию, с содержимым:
 

Да, и в папке ./connectors/ тоже надо добавить файл .htaccess отключающий переадресацию, с содержимым: RewriteEngine Off

Да, и в папке ./connectors/ тоже надо добавить фай

Я примерно так и начинал делать, но потом сообразил, что этого мало. Нужно еще, чтобы все ссылки на сайте генерировались не как 
 «page_addr?cultureKey=en», а как
 «page_addr/en»
 вот тут и застопорилась разработка :(


Я примерно так и начинал делать, но потом сообрази

В шаблонах вывода просто учитывать 
 

$modx->getOption('classKey').'/'.[alias]


И так по мере необходимости везде учитывать classKey и, на мой взгляд, проблем не должно быть

В шаблонах вывода просто учитывать $modx->getOption('classKey').'/'.[alias] И так по мере необходимости везде учитывать classKey и, на мой взгляд, проблем не должно быть

В шаблонах вывода просто учитывать $modx->getOptio

Конечно, это вариант. Но я в то время переносил сайт, в котором в самом контенте было немало ссылок типа [[~444]]. Вот тут дело и встало, а не тот момент я не рискнул лезть в парсер MODX

Конечно, это вариант. Но я в то время переносил са

То что xlexicon по умолчанию передает просто параметр cultureKey — это нормально, по такому же принципу построены практически все мультиязычные сайты и компоненты, только параметр может называться по другому, а формирование СЕО-дружесвенных урлов из GET параметра происходит на уровне сервера. В том же самом Babel еще надо плагином переключать контент и в два раза увеличивать дерево ресурсов.

То что xlexicon по умолчанию передает просто парам

описался
 переключать контекст

знаю, на babel и делал. требование заказчика было конкретным — ...page/en/…
 и чтобы в контенте все ссылки были именно такие. :)

знаю, на babel и делал. требование заказчика было 

Плагин на событие OnBeforeDocFormSave, в котором урлам добавлять [[++cultureKey]]/, при отсутствии такого.
 все же можно решить)

Плагин на событие OnBeforeDocFormSave, в котором у

здравствуйте, хотела бы вернутся к вышеупомянутой задаче. Как все-таки сделать ссылки, к примеру, не site.com/text/text/?cultureKey=en, а site.com/en/text/text?? Не используя контексты

здравствуйте, хотела бы вернутся к вышеупомянутой 

Изучите это: modxclub.ru/blog/168.html
 Перехватывайте запросы на OnHandleRequest, подменяйте УРЛ и выставляйте culture_key, должно все работать без проблем. Компонент просто реагирует на то, какой culture_key сейчас выставлен в MODX.

Изучите это: modxclub.ru/blog/168.html
 Перехватыв

[[!runprocessor::strip_tags:ellipsis=`50`?..
 или просто
 [[!runprocessor:ellipsis=`50`?..

[[!runprocessor::strip_tags:ellipsis=`50`?..
 или 

internationalization

modx

modx extra

xlexicon

# Николай Ланец aka Fi1osof
**Lead Fullstack Developer / Ментор / Евангелист современного JS‑стека**

---

## О себе

Я — не просто Senior Developer с 2007 года. Я — тот, кто строит продукты будущего на базе современных технологий и помогает другим подниматься на новую ступень айти-карьеры. Создатель и идейный вдохновитель freecode.academy — платформы, где обучение перестает быть скучной обязаловкой и становится настоящим технологическим приключением.

---

## Мой стек и философия разработки

Основу моего рабочего арсенала составляют:

- [Javascript](/technologies/ck1faudv928l40a89c4u9zxlm), [TypeScript](/technologies/ckcvwwx010kov08009u7y2rav)
- [React](/technologies/ck1fawbdw28v20a891k4wlh27), [Next.js](/technologies/ckg2jd4ffr9260730aog66dri)
- [Node.js](/technologies/ckt55wm59272831wo9gg9r8ynx), [GraphQL](/technologies/ck1fawhqk28vu0a8995lqvlsj), [Apollo Client](/technologies/ck2zdcg0vpvc10a89xjmhj1e0), [Nexus](/technologies/ckl2pbh0fxew60730ifl3zozp), [Prisma](/technologies/ck2zdbmi7pv8r0a89ntc2r0f1)
- DevOps: [Docker](/technologies/ck2y1x9lho9cy0a8953xzfjr8), [docker-compose](/technologies/ck2y1xqino9g80a89tsftxin2), [Caddy](/technologies/ck2zd8ovqpuyl0a8909748sbu), [Ubuntu](/technologies/cktu8giks3593911vmle30ztqxt)
- UI-инструменты: [Styled-Components](/technologies/ckk8myysio7lw0730csszvrdw), [Material-UI](/technologies/ckljv3jwd7bgf0730huxlko9n), [react-hook-form](/technologies/ckmx8cn9fmwrv073032e67722)
- Всё актуальное для разработки, CI/CD и автоматизации 
- Эксперименты с [WebGL](/technologies/ckan9anntc12f08003saqttrq), [A‑Frame](/technologies/ck2tgoiz8j37y0a89c7gxsrxc), [Three.js](/technologies/ck2tgns1nj32z0a89vmw7xw3f), [Unreal Engine 4](/technologies/ck7puswy6g4yb07004cdp6lbr), [Elixir](/technologies/ckn0olavrnnzi0730xs8rctn8), [C++](/technologies/cknin1y8lu2fr07307mskn2fn)

---

## Разработка и менторство

- Более 15 лет **hands-on** разработки и проджект‑менеджмента
- Главный разработчик и преподаватель платформы [freecode.academy](https://freecode.academy)
- **Ведущий менти-пул на платформе** — лично выращиваю новых звезд отрасли

### Мои менти и их результаты

| Менти (ФИО \| username)                               | Уровень | Рейтинг |
|-------------------------------------------------------|---------|---------|
| [Попов Дмитрий \| linklib](/users/cjoe890c706ji0d962oismzoe)           | 3       | 315     |
| [Сэт \| defk1lla](/users/ckzh1ita312978121imr9hpqfc64)                 | 3       | 670     |
| [Ксения Матвеева \| Ксения Матвеева](/users/ckz4awwlh10627771imr4wvpb7cj) | 2       | 0       |
| [Михаил \| Balamut](/users/cl1npq92z10258261vmbq0w6vfh2)               | 2       | 0       |
| [Ольга Ершова \| angel](/users/cjoe87zhk00250d969arluevk)              | 1       | 0       |
| [Егор \| rogedkone](/users/cksrdp47d3308261ijuq7wfrxdl)                | 3       | 0       |
| [Roman \| Roman43](/users/ckur2qtt64721431xoboyjcte52)                 | 2       | 0       |
| [Бут Игорь \| santiment](/users/ckttd9x20893951vmltb8t7sha)            | 1       | 0       |

**Доношу простую мысль: успех — это не магия, это осознанная системная работа и кайф от роста.**
Мои менти выводят решения в продакшн, пробиваются в лидеры рейтингов — кому не хочется быть в такой команде?

---

## Почему я?

- **Прокачаю проект** — от TDD архитектуры до культурного CI/CD
- **Вдохновлю команду** — и научу мыслить по‑новому, где ИИ — напарник, а не угроза
- **Выращу мидлов и сеньоров** — доказано платформой и рейтингами моих учеников

**Сила — в сообществе, а техника — это просто смазка для ваших побед. Присоединяйтесь!**

---

## Контакты

- 📧 [n.lanets@freecode.academy](mailto:n.lanets@freecode.academy)
- Телеграм: [@freecode_academy](https://t.me/freecode_academy)

---

**P.S.**: Мой опыт — ваш драйвер роста. Хотите в команду? Ищете менторство? Пишите. Растём вместе!