MIGX в MODX: настройка полей и вывод данных

Настройка повторяемых полей и вложенных записей MIGX в MODX MODX Revo
MIGX позволяет хранить несколько записей с собственными полями внутри одного TV в MODX. Создайте конфигурацию формы и колонок, подключите ее к TV, назначьте шаблону и заполните ресурс. Данные выводятся через getImageList с чанками или через Fenom, для вложенного списка нужно отдельно обработать JSON внутреннего поля.
Содержание
  1. Что такое MIGX и как устроено хранение данных
  2. Установка и выбор версии
  3. Справочник конфигурации и getImageList
  4. Подключаем карточки услуг Creative через MIGX
  5. Создаем конфигурацию services
  6. Добавляем поля карточки
  7. Настраиваем колонки таблицы
  8. Создаем TV services и назначаем шаблону
  9. Заполняем четыре услуги
  10. Создаем чанк одной карточки
  11. Создаем чанк секции услуг
  12. Заменяем статические карточки вызовом секции
  13. Проверяем редактирование, количество и порядок
  14. Вложенный MIGX: заголовок секции и список услуг
  15. Создаем внешнюю конфигурацию services_section
  16. Создаем TV для всей секции
  17. Заполняем секцию и вложенные карточки
  18. Создаем чанк внешней секции
  19. Переключаем шаблон на новый вариант
  20. Проверяем заголовок и вложенный список
  21. Портфолио на MIGX: изображения и миниатюры в админке
  22. Создаем конфигурацию portfolio_migx
  23. Указываем, откуда брать источник изображений
  24. Добавляем колонки и рендерер миниатюры
  25. Создаем TV и назначаем источник файлов
  26. Заполняем работы портфолио
  27. Создаем чанк одной работы
  28. Создаем чанк обертки портфолио
  29. Заменяем статичное портфолио
  30. Проверяем изображения и рендерер
  31. Что изменится при переходе на Gallery
  32. Пример меток-ссылок под статьей
  33. Конфигурация tag и два поля
  34. TV tags и доступ для шаблонов
  35. Заполняем ссылки
  36. Вывод на стандартных тегах без пустой обертки
  37. Полный вариант на Fenom
  38. Изображения и источники файлов
  39. Копирование конфигураций, миниатюры и общий блок
  40. Быстро создаем похожую конфигурацию
  41. Миниатюры через pThumb
  42. Выводим один общий блок на разных страницах
  43. Вывод в обратном порядке
  44. Разное оформление каждого второго элемента
  45. getImageList: плейсхолдер _alt
  46. Fenom: независимый счетчик вывода
  47. Чередование только через CSS
  48. Если окно зависает на loading
  49. Сначала находим сообщение об ошибке
  50. Что проверять по результату
  51. Проверка результата
  52. Возможности MIGX и следующие уроки

Что такое MIGX и как устроено хранение данных

MIGX добавляет тип ввода для дополнительных полей: внутри одного TV можно хранить список записей, у каждой из которых несколько полей. Например, у отзыва есть текст, имя, должность и фотография. В админке записи отображаются в таблице, а добавляются и редактируются в отдельной форме.

Конфигурация задает поля этой формы и колонки таблицы. TV подключает конфигурацию к ресурсам. Заполненные записи сохраняются в значении TV как JSON-массив. Для полей внутри записи не нужно создавать отдельное TV на каждое имя или фотографию.

Сниппет getImageList выводит записи на сайт через чанк. Несмотря на название, он подходит не только для изображений: можно выводить текстовые блоки, ссылки, отзывы и другие наборы данных.

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

Установка и выбор версии

Если вы идете по учебному маршруту, MIGX уже установлен в уроке о дополнениях. Повторять установку не нужно. Проверьте установленную версию и переходите к созданию конфигурации.

Откройте менеджер пакетов, найдите MIGX у стандартного поставщика и посмотрите сведения о выбранном выпуске.

Просмотр деталей и установка MIGX

Общий порядок загрузки и установки показан в уроке о дополнениях.

Перед установкой проверьте ветку MODX, версию PHP и выпуск самого пакета. Номер MIGX не является номером CMS: название «MIGX 3» само по себе не означает, что пакет подходит только для MODX 3.

На момент проверки официальный каталог предлагает MIGX 3.0.2-beta1, в истории указаны исправления совместимости с MODX 3 и PHP 8. Это beta-выпуск, а не стабильный pl-релиз. Описание не подтверждает работу всех функций на любой версии PHP 8.

Актуальные сведения смотрите в официальном каталоге MIGX.

Поэтому для рабочего проекта сначала проверяйте обновление на копии. Этот урок объясняет последовательность настройки, но не заменяет тест конкретного сочетания CMS, PHP и дополнения.

Справочник конфигурации и getImageList

Поля, типы ввода и рендеры
Для обычного MIGX TV полезно различать поля формы и колонки таблицы:
Ключ Назначение
caption Подпись вкладки или поля.
field Имя поля записи, в интерфейсе конфигураций показывается как Fieldname.
fields Массив полей вкладки.
formtabs Структура вкладок формы.
inputTVtype Тип ввода поля: text, textarea, image и другие.
inputTV Имя вспомогательного TV, если нужно использовать его свойства вместо одного стандартного типа.
header Подпись колонки таблицы.
dataIndex Имя поля для колонки в JSON, в менеджере конфигураций соответствует Field.
renderer Способ отображения значения в колонке.

Названия полей вроде name, url или active не определяют тип ввода автоматически. Например, поле active станет списком только после соответствующего выбора типа и вариантов.

Типы из исходного справочника: autotag, text, textarea, textareamini, richtext, dropdown, listbox, listbox-multiple, list-multiple-legacy, option, checkbox, image, file, url, email, number, date, tag. Доступность некоторых типов зависит от ядра и дополнений. Legacy-тип не выбирайте для новой формы без причины.

Renderer Что показывает
this.renderImage Миниатюру изображения.
this.renderCrossTick Галочку или крестик для логического значения.
this.renderDate Представление даты.
this.renderChunk Вывод через заданный чанк при соответствующей настройке.
this.renderClickCrossTick Кликабельное логическое поле в сценарии MIGXdb.
this.renderSwitchStatusOptions Переключение статуса с настроенными Renderoptions.

Последние сложные рендеры не являются обязательными опциями простого TV. MIGXdb работает с отдельными таблицами и обработчиками, это другая задача, чем JSON-список в этом уроке.

Плейсхолдеры getImageList

Плейсхолдер Назначение
[[+title]] Пример поля записи, вместо title используется имя вашего поля.
[[+idx]] Номер выведенной записи, начиная с 1.
[[+_first]] Признак первой записи.
[[+_last]] Признак последней записи.
[[+_alt]] Чередование 0 и 1, начиная с 0 у первой записи.
[[+total]] Количество записей после фильтрации where, до применения offset и limit. Имя плейсхолдера меняется через totalVar.
[[+property.name]] Параметр name, переданный в вызове сниппета.

Плейсхолдеры этого списка используются в чанках getImageList. В прямом цикле Fenom значения находятся в переменной записи, а idx или _alt автоматически не добавляются

Основные параметры getImageList

Параметр Назначение
tvname Имя MIGX TV.
tpl Чанк записи. Также поддерживаются @CODE:, @FILE: и выбор через @FIELD:. У MIGX это собственный механизм загрузки, не все правила pdoTools автоматически применимы к нему.
docid ID ресурса с данными, без явного значения используется текущий ресурс.
value JSON для вывода вместо чтения значения TV. Если дополнительно передаете tvname ради конфигурации обработки полей, проверяйте ее соответствие данным.
limit Ограничение числа записей, 0 означает отсутствие такого ограничения.
offset Сколько записей пропустить.
reverse Разворот списка перед последующими операциями.
randomize Случайный порядок.
preselectLimit Число первых записей для предварительного отбора при randomize. Задавайте явно: значения по умолчанию в старой документации и коде могут отличаться.
where JSON-условия фильтрации по полям записей.
sort JSON-правила сортировки.
totalVar Имя плейсхолдера количества записей, обычно total.
toPlaceholder Сохранить результат в плейсхолдер, не выводить сразу.
toSeparatePlaceholders Сохранить записи в отдельные плейсхолдеры. Их суффиксы зависят от ключей результата и placeholdersKeyField, не всегда от номера строки.
outputSeparator Разделитель между записями.
wrapperTpl Обертка непустого результата, получает плейсхолдер output.
processTVs Обработка типов полей, определенных конфигурацией TV, влияет и на подготовку URL изображений. Не превращает произвольный JSON без конфигурации в настроенные TV.
emptyTpl Шаблон для пустого результата обработки списка. Поведение при полностью пустом исходном значении TV проверяйте на установленной версии.
placeholdersKeyField Поле, используемое для ключей результата. По умолчанию MIGX_id; влияет на суффиксы отдельных плейсхолдеров.

Пустое значение TV и JSON-массив [] не всегда проходят одинаковый путь обработки. Если используете emptyTpl, проверьте оба случая на установленной версии MIGX.

Пример корректного JSON для where:

{"active:=":"1","rating:>":"5"}

Пример sort:

[{"sortby":"age","sortdir":"DESC","sortmode":"numeric"},{"sortby":"name","sortdir":"ASC"}]

Поля active, rating и age здесь условные. Эти правила не добавляют их в конфигурацию: они должны существовать в ваших данных. Копировать такой фильтр к списку услуг без этих полей не нужно.

Fenom-вывод сырого JSON не повторяет автоматически фильтрацию, сортировку и подготовку источников из getImageList. Если нужен конкретный параметр сниппета, используйте сниппет или явно реализуйте ту же операцию в своем обработчике.

Рекомендую скачать и распечатать PDF версию справочника.

Справочник конфигурации и getImageList в формате PDF

Подключаем карточки услуг Creative через MIGX

В предыдущем уроке мы подключили первый экран и About через поля ресурса, TV и чанки. Теперь сделаем редактируемыми повторяемые карточки секции At Your Service.

Секция At Your Service

Первый экран и About не переделываем. Чанки creative.hero и creative.about остаются на своих местах.

У каждой карточки услуг есть три значения: иконка, заголовок и описание. Вместо отдельных TV для каждой карточки создадим один список MIGX. Редактор сможет добавлять записи, менять их содержание и порядок.

Для этого примера используем следующие имена:

Объект Имя Назначение
Конфигурация MIGX services Поля формы и колонки таблицы услуг.
TV services Список услуг, заполненный у ресурса.
Чанк карточки creative.service.item Разметка одной записи.
Чанк секции creative.services Общая обертка и вызов списка.

Конфигурация и TV называются одинаково, но это разные объекты. Конфигурация описывает интерфейс, а TV хранит заполненные записи конкретного ресурса.

Создаем конфигурацию services

Откройте «Пакеты» → «MIGX». В другом выпуске MODX меню может называться «Приложения», но нужен именно менеджер конфигураций MIGX.

Перейдите к списку конфигураций и нажмите «Добавить элемент».

На вкладке Settings заполните:

  • Name: services.
  • Замена надписи «Добавить элемент»: Добавить услугу.

создание конфигурации MIGX - вкладка Settings

Перейдите на вкладку Formtabs. Здесь создадим одну вкладку формы, внутри которой будут три поля.

Добавляем поля карточки

На Formtabs нажмите «Добавить элемент». В открывшемся окне задайте подпись вкладки: «Услуга».

Внутри этого окна снова нажмите «Добавить элемент» — теперь создаем первое поле:

  • Fieldname: icon.
  • Caption: Класс иконки.
  • Input TV type: text (можно не указывать — он по умолчанию).

Нажмите «Сохранить и закрыть». Закроется окно поля, но останется окно вкладки «Услуга».

создание конфигурации MIGX - вкладка formtabs

Таким же способом добавьте заголовок и описание. Итоговый набор:

Fieldname Caption Input TV type
icon Класс иконки text
title Название услуги text
text Описание textareamini

В описании используем обычный текст, не HTML. Для поля иконки также нужен текстовый ввод: будем сохранять имя CSS-класса, например bi-gem, а не загружать изображение.

создание конфигурации MIGX - вкладка formtabs с указанием типа TV

Сохраните вкладку формы. На Formtabs она должна отображаться одной строкой. Три поля находятся внутри этой вкладки — создавать три отдельные вкладки не нужно.

3 созданных поля в Formtabs

Настраиваем колонки таблицы

Перейдите на Columns.

Переходим во вкладку Columns

Здесь задаем краткую таблицу записей, которая будет отображаться в дополнительных полях ресурса.

Нажмите «Добавить элемент» и создайте первую колонку:

  • Header: Услуга.
  • Field: title.

Сохраните колонку.

Создаем первую колонку

Затем добавьте еще две:

Header Field
Иконка icon
Описание text

Значение Field должно точно совпадать с Fieldname соответствующего поля формы. Например, колонка «Услуга» показывает поле title, а не поле с русским именем.

Специальный Renderer здесь не требуется. В колонке иконки будет отображаться строка bi-gem или другое введенное имя класса. Саму иконку покажем в разметке сайта.

3 созданные колонки

Сохраните колонки и всю конфигурацию. Снова откройте services и проверьте, что вкладка формы, поля и колонки сохранились.

Создаем TV services и назначаем шаблону

В дереве элементов создайте дополнительное поле TV:

  • Имя: services.
  • Заголовок: Услуги.
  • Категория: по вашему выбору.

Создаем TV services

На вкладке параметров ввода выберите тип migx. В поле конфигураций укажите services — имя только что созданной конфигурации.

Указываем Тип ввода MIGX и название конфигурации

На вкладке доступа для шаблонов отметьте начальный шаблон, который используется у главной страницы Creative. Сохраните TV.

отмечаем шаблон и сохраняем

Отдельные TV с именами icon, title и text создавать не нужно. Это поля записей внутри одного MIGX TV.

Источники изображений для этой конфигурации не настраиваем: в карточках используются CSS-иконки, а не файловое поле.

Заполняем четыре услуги

Заново откройте главную страницу в дереве ресурсов. Перейдите в дополнительные поля и найдите список «Услуги».

Нажмите «Добавить услугу». Заполните первую запись:

  • Класс иконки: bi-gem.
  • Название услуги: Разработка сайта.
  • Описание: Подключаем оформление и создаем понятную структуру страниц..

Добавляем услугу

Сохраните запись.

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

Класс иконки Название услуги Описание
bi-laptop Адаптивная верстка Проверяем отображение страниц на компьютерах и телефонах.
bi-globe Подготовка к запуску Проверяем ссылки, содержание и основные функции сайта.
bi-heart Поддержка проекта Помогаем обновлять содержание и дорабатывать сайт.

В поле иконки вводите только имя класса: bi-gem, без тега i и без кавычек. Все четыре примера взяты из исходного Creative, где уже подключены Bootstrap Icons.

После закрытия форм в таблице должны появиться четыре записи.

Добавляем все услуги и сохраняем ресурс

Теперь сохраните сам ресурс. Сохранение записи в окне MIGX и сохранение страницы — два отдельных действия.

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

Создаем чанк одной карточки

На вкладке «Элементы» создайте обычный чанк с именем creative.service.item. Вставьте разметку одной карточки:

<div class="col-lg-3 col-md-6 text-center">
    <div class="mt-5">
        <div class="mb-2">
            <i class="[[+icon:htmlent]] fs-1 text-primary" aria-hidden="true"></i>
        </div>
        <h3 class="h4 mb-2">[[+title:htmlent]]</h3>
        <p class="text-muted mb-0">[[+text:htmlent]]</p>
    </div>
</div>

Сохраните чанк.

Плейсхолдеры [[+icon]], [[+title]] и [[+text]] соответствуют именам полей конфигурации. Их заполнит getImageList для каждой записи.

Здесь используются плейсхолдеры с плюсом, а не вызовы полей ресурса со звездочкой. Например, [[+title]] получает название текущей услуги.

Значения выводим как текст и значение HTML-атрибута, поэтому добавляем htmlent. Поле описания не предназначено для произвольной HTML-разметки.

Создаем чанк секции услуг

Создайте второй обычный чанк с именем creative.services. Он будет содержать общий заголовок, контейнеры и вызов списка:

<section class="page-section" id="services">
    <div class="container px-4 px-lg-5">
        <h2 class="text-center mt-0">Наши услуги</h2>
        <hr class="divider" />

        <div class="row gx-4 gx-lg-5">
            [[getImageList?
                &tvname=`services`
                &tpl=`creative.service.item`
                &limit=`0`
            ]]
        </div>
    </div>
</section>

Сохраните чанк.

В вызове:

  • tvname — имя TV, в котором заполнены услуги.
  • tpl — чанк одной карточки.
  • limit=0 — вывод всех записей без ограничения количества.

Заголовок «Наши услуги» общий для секции и пока находится в ее чанке. В каждую запись MIGX его не добавляем.

Не помещайте в чанк карточки общий section, заголовок секции или контейнер row. Иначе они будут повторяться вместе с каждой услугой.

Заменяем статические карточки вызовом секции

Откройте начальный шаблон. После вызовов первого экрана и About найдите секцию с id="services". В исходнике Creative у нее заголовок At Your Service и четыре статические карточки.

Замените всю секцию, от ее открывающего <section> до соответствующего </section>, одним вызовом:

[[$creative.services]]

В результате после навигации должны последовательно находиться три вызова:

[[$creative.hero]]
[[$creative.about]]
[[$creative.services]]

Дальше остается исходный блок портфолио. Его и контактную секцию пока не меняем.

Сохраните шаблон и откройте главную страницу. Вместо демонстрационных карточек должны появиться четыре услуги из MIGX.

четыре услуги из MIGX

Сохраняем id="services" у общей секции: на него уже ссылаются меню и кнопка из About. У каждой карточки такой ID не нужен.

Проверяем редактирование, количество и порядок

Проверим не только внешний вид, но и связь с данными:

  1. Измените название и описание одной услуги, сохраните запись и сам ресурс.
  2. Обновите сайт и убедитесь, что изменилась нужная карточка.
  3. Добавьте пятую услугу и снова сохраните ресурс. Она должна появиться в следующем ряду.
  4. Поменяйте порядок строк в MIGX перетаскиванием, сохраните ресурс и проверьте порядок на сайте.
  5. Удалите тестовую пятую запись и сохраните ресурс. На сайте снова должны остаться четыре карточки.

Без дополнительных параметров сортировки в этом примере используем порядок записей списка. Ограничение limit=1 здесь не подходит: оно оставило бы только одну услугу.

Если карточки продублировались, проверьте, не остались ли в шаблоне старые статические записи рядом с вызовом чанка.

Если список пуст, проверьте имя TV services, назначенный шаблон и сохранение главной страницы. Если выводится разметка, но нет значений, сравните имена полей конфигурации с плейсхолдерами чанка.

Если не отображаются только иконки, проверьте сохраненные классы и загрузку Bootstrap Icons. MIGX выводит имя класса, но не подключает библиотеку иконок самостоятельно.

Необязательно: вывод той же секции на Fenom

Для основного упражнения достаточно getImageList. Вариант ниже нужен только тем, кто хочет попробовать вывод сохраненного JSON через Fenom.

Используйте его, если в проекте установлен pdoTools и настроена обработка Fenom. Для размещения кода непосредственно в шаблоне требуется pdotools_fenom_parser = Да.

Настройка pdotools_fenom_default относится к чанкам, обрабатываемым pdoTools. Она сама по себе не переводит обычные чанки getImageList на Fenom. Расширенный доступ через pdotools_fenom_php и pdotools_fenom_modx для этого примера включать не требуется.

В начальном шаблоне замените только вызов [[$creative.services]] следующим полным блоком:

{set $services = $_modx->resource.services | fromJSON}

<section class="page-section" id="services">
    <div class="container px-4 px-lg-5">
        <h2 class="text-center mt-0">Наши услуги</h2>
        <hr class="divider" />

        <div class="row gx-4 gx-lg-5">
            {if $services}
                {foreach $services as $service}
                    <div class="col-lg-3 col-md-6 text-center">
                        <div class="mt-5">
                            <div class="mb-2">
                                <i class="{$service.icon | escape} fs-1 text-primary" aria-hidden="true"></i>
                            </div>
                            <h3 class="h4 mb-2">{$service.title | escape}</h3>
                            <p class="text-muted mb-0">{$service.text | escape}</p>
                        </div>
                    </div>
                {/foreach}
            {/if}
        </div>
    </div>
</section>

Этот вариант читает значение TV services, преобразует JSON в массив и повторяет разметку для каждой услуги. Чанки creative.services и creative.service.item в таком выводе не вызываются.

Выбирайте один способ: вызов секции со стандартными тегами или полный Fenom-блок. Одновременно оставлять оба варианта нельзя — услуги появятся дважды.

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

Вложенный MIGX: заголовок секции и список услуг

В предыдущем примере карточки уже редактируются через MIGX, но общий заголовок «Наши услуги» остается в чанке. Теперь соберем заголовок и карточки в одну запись секции.

Это дополнительное упражнение на вложенный MIGX. Для одного заголовка можно было создать обычный текстовый TV, но здесь наша задача — научиться размещать повторяемый список внутри другой записи.

Структура получится такой:

Секция услуг
    Заголовок секции
    Карточки услуг
        Иконка, название, описание
        Иконка, название, описание
        Иконка, название, описание
        Иконка, название, описание

Конфигурация services уже описывает одну карточку. Используем ее во вложенном поле, а для всей секции создадим новую конфигурацию.

Объект Имя Назначение
Внешняя конфигурация services_section Заголовок секции и вложенный список карточек.
Вложенная конфигурация services Иконка, название и описание одной услуги. Уже создана.
Новый TV services_section Хранение всей секции у ресурса.
Новый чанк секции creative.services.section Вывод общего заголовка и вложенных карточек.
Чанк карточки creative.service.item Разметка одной услуги. Используем существующий.

Прежний TV services пока сохраняем без изменений. В нем остаются данные первого упражнения. Новую структуру заполним отдельно, чтобы можно было сравнить оба варианта.

Создаем внешнюю конфигурацию services_section

Откройте менеджер конфигураций MIGX и нажмите «Добавить элемент».

На вкладке Settings заполните:

  • Name: services_section.
  • Замена надписи «Добавить элемент»: Добавить секцию услуг.

скриншот Settings конфигурации services_section с именем и подписью кнопки

Перейдите на Formtabs. Создайте одну вкладку формы с подписью «Секция услуг». Внутри нее добавьте два поля:

Fieldname Caption Input TV type Configs
title Заголовок секции text Не заполняем.
items Карточки услуг migx services

Для поля items выберите тип ввода migx. В его настройках найдите Configs и укажите services — имя существующей конфигурации карточки.

скриншот настройки поля items. Видны тип migx и Configs со значением services

Не указывайте здесь services_section: это внешняя конфигурация, а не форма карточки.

Сохраните оба поля и вкладку формы. На Columns достаточно создать одну колонку:

  • Header: Заголовок секции.
  • Field: title.

Вложенный JSON карточек отдельной колонкой не выводим. Редактировать его будем через список внутри формы секции.

Сохраните всю конфигурацию.

Создаем TV для всей секции

На вкладке «Элементы» создайте новый TV:

  • Имя: services_section.
  • Подпись: Секция услуг.
  • Тип ввода: migx.
  • Конфигурация: services_section.

На вкладке доступа для шаблонов отметьте начальный шаблон главной страницы и сохраните TV.

скриншот TV services_section с типом migx и внешней конфигурацией services_section

К TV подключается внешняя конфигурация services_section. Она открывает форму секции, а поле items внутри нее использует конфигурацию services.

Совпадение имени вложенной конфигурации с прежним TV services не означает, что его данные автоматически подставятся в новый список. Повторно используем описание полей, а не заполненные записи.

Заполняем секцию и вложенные карточки

Заново откройте главную страницу в дереве ресурсов. На вкладке дополнительных полей найдите новый список «Секция услуг».

Нажмите «Добавить секцию услуг». В поле заголовка введите «Наши услуги».

В этой же форме найдите вложенный список «Карточки услуг». Нажмите его кнопку добавления записи. Должна открыться знакомая форма с полями:

  • Класс иконки.
  • Название услуги.
  • Описание.

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

Карточки нужно заполнить в новом вложенном списке. Добавление записей в старый TV services не изменит содержимое поля items новой секции.

«Наши услуги» и вложенная таблица с четырьмя карточками

Сохраняйте изменения последовательно:

  1. Сохраните вложенную карточку.
  2. После заполнения всех карточек сохраните внешнюю запись секции.
  3. Сохраните сам ресурс.

Заново откройте секцию и проверьте, что сохранились и общий заголовок, и все вложенные строки.

Для этого примера создаем одну внешнюю запись секции и несколько карточек внутри нее. Не добавляйте отдельную внешнюю запись для каждой услуги.

Создаем чанк внешней секции

Чанк creative.service.item уже выводит одну карточку с полями icon, title и text. Его менять не нужно.

Создайте новый обычный чанк с именем creative.services.section и вставьте:

<section class="page-section" id="services">
    <div class="container px-4 px-lg-5">
        <h2 class="text-center mt-0">[[+title:htmlent]]</h2>
        <hr class="divider" />

        <div class="row gx-4 gx-lg-5">
            [[getImageList?
                &value=`[[+items]]`
                &tpl=`creative.service.item`
                &limit=`0`
            ]]
        </div>
    </div>
</section>

Сохраните чанк.

Здесь [[+title]] получает заголовок внешней записи. В [[+items]] находится JSON вложенных карточек, который передаем в параметр value.

Во вложенном вызове не указываем tvname=items: отдельного TV с таким именем у нас нет. Данные уже находятся внутри внешней записи.

Название поля title используется и у секции, и у карточки. Это не конфликт: в чанке секции оно относится к внешней записи, а в creative.service.item — к текущей карточке вложенного вызова.

Переключаем шаблон на новый вариант

Откройте начальный шаблон. Найдите вызов секции из первого упражнения:

[[$creative.services]]

Замените только этот вызов:

[[getImageList?
    &tvname=`services_section`
    &tpl=`creative.services.section`
    &limit=`1`
]]

Сохраните шаблон и обновите главную страницу.

Внешний вызов получает одну запись из TV services_section. Чанк этой записи показывает заголовок и запускает второй getImageList для карточек из items.

Ограничения относятся к разным уровням:

  • Внешний limit=1 оставляет одну секцию с одним id="services".
  • Вложенный limit=0 выводит все карточки этой секции.

Старый вызов [[$creative.services]] рядом не оставляем, иначе на странице появятся оба варианта услуг.

Прежние TV и чанки пока не удаляем. Для сравнения можно вернуть старый вызов, но одновременно используем только один вариант.

Проверяем заголовок и вложенный список

Если вы повторили прежние значения, внешний вид секции почти не изменится. Теперь проверим, что изменился источник данных.

  1. В новой внешней записи поменяйте «Наши услуги» на «Чем мы можем помочь».
  2. Внутри нее измените название одной карточки.
  3. Поменяйте порядок вложенных строк.
  4. Сохраните карточку, внешнюю запись и ресурс.
  5. Обновите сайт.

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

скриншот секции услуг после изменения общего заголовка и вложенных карточек через services_section

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

Если заголовок изменился, а карточки нет, проверьте, что редактировали вложенный список нового TV, а не прежний самостоятельный список services.

Если заголовок есть, но карточки не выводятся, проверьте имя items, сохранение внешней записи и передачу [[+items]] в параметр value.

Если не открывается форма карточки, проверьте Configs у поля items: там должно быть имя конфигурации services.

Необязательно: вывод вложенной секции на Fenom

Этот вариант используйте только при уже настроенной обработке Fenom непосредственно в шаблоне. Для стандартного вывода выше pdoTools и Fenom не требуются.

Замените внешний вызов getImageList в начальном шаблоне следующим блоком. Он читает JSON секции, затем отдельно преобразует JSON ее вложенного поля items:

{set $sections = $_modx->resource.services_section | fromJSON}

{if $sections}
    {foreach $sections as $sectionIndex => $section}
        {if $sectionIndex == 0}
            {set $items = $section.items | fromJSON}

            <section class="page-section" id="services">
                <div class="container px-4 px-lg-5">
                    <h2 class="text-center mt-0">{$section.title | escape}</h2>
                    <hr class="divider" />

                    <div class="row gx-4 gx-lg-5">
                        {if $items}
                            {foreach $items as $item}
                                <div class="col-lg-3 col-md-6 text-center">
                                    <div class="mt-5">
                                        <div class="mb-2">
                                            <i class="{$item.icon | escape} fs-1 text-primary" aria-hidden="true"></i>
                                        </div>
                                        <h3 class="h4 mb-2">{$item.title | escape}</h3>
                                        <p class="text-muted mb-0">{$item.text | escape}</p>
                                    </div>
                                </div>
                            {/foreach}
                        {/if}
                    </div>
                </div>
            </section>
        {/if}
    {/foreach}
{/if}

Внешний цикл обрабатывает секцию, вложенный — ее карточки. В этом примере выводим первую внешнюю запись и все ее вложенные элементы.

Такой вариант заменяет стандартный вывод секции целиком. Одновременно оставлять его вместе с внешним вызовом getImageList нельзя.

Для продолжения учебной практики достаточно стандартных тегов. Переходить на Fenom ради вложенного MIGX не требуется.

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

Портфолио на MIGX: изображения и миниатюры в админке

Теперь подключим портфолио Creative через MIGX. На этом примере разберем выбор изображений, источник файлов и рендерер миниатюр в таблице админки.

Портфолио креативе

Это учебный вариант. Позже подключим ту же секцию через Gallery. Оба варианта одновременно выводить не будем: при переходе заменим вызов портфолио, сохранив его оформление.

В исходном Creative для каждой работы используются два файла:

  • Большое изображение из assets/img/portfolio/fullsize/ — открывается по нажатию.
  • Маленькое изображение из assets/img/portfolio/thumbnails/ — отображается в сетке.

В архиве уже есть готовые пары изображений. Поэтому сейчас не устанавливаем pThumb и не настраиваем создание миниатюр: используем существующие файлы.

Важно различать три механизма:

  • Тип поля image позволяет выбирать файл в форме записи.
  • Рендерер this.renderImage показывает миниатюру в таблице MIGX.
  • Чанк определяет, какое изображение и где выводится на сайте.

Настройка рендерера сама по себе не создает публичную галерею и не заполняет поле миниатюры.

Создаем конфигурацию portfolio_migx

Откройте менеджер конфигураций MIGX и создайте новую конфигурацию:

  • Name: portfolio_migx.
  • Замена надписи «Добавить элемент»: Добавить работу.

Перейдите на Formtabs. Создайте вкладку с подписью «Работа» и добавьте в нее пять полей:

Fieldname Caption Input TV type
title Название работы text
category Категория text
image Большое изображение image
thumb Изображение для сетки image
alt Альтернативный текст изображения text

У полей image и thumb обязательно выберите тип ввода image. Если оставить текстовый тип, название поля не добавит кнопку выбора файла.

Категория в этом примере — обычная текстовая подпись. Она не создает отдельные страницы категорий и не включает фильтрацию портфолио.

Указываем, откуда брать источник изображений

В настройках поля image найдите Source From и выберите migx. Это означает, что источник нужно брать из настроек самого MIGX TV.

Повторите настройку для поля thumb.

скриншот настройки файлового поля image с типом image и Source From = migx

Если работаете с JSON конфигурации, соответствующий фрагмент поля выглядит так:

{
    "field": "image",
    "caption": "Большое изображение",
    "inputTVtype": "image",
    "sourceFrom": "migx"
}

Это фрагмент одного поля, а не полный экспорт конфигурации. В интерфейсе достаточно выбрать указанные параметры.

вкладки формы «Работа» с пятью полями title, category, image, thumb и alt

Сохраните поля и вкладку формы. Сам источник назначим после создания TV.

Добавляем колонки и рендерер миниатюры

Перейдите на Columns и создайте следующие колонки:

Header Field Renderer
Работа title Не задаем.
Категория category Не задаем.
Миниатюра thumb this.renderImage
Большое изображение image Не задаем.

Для колонки миниатюры сначала заполните Header «Миниатюра» и Field thumb. Затем в окне этой колонки откройте вкладку Renderer и выберите this.renderImage.

скриншот настройки Renderer колонки thumb со значением this.renderImage

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

У большого изображения рендерер намеренно не задаем: в таблице останется текстовый путь. Так можно сравнить отображение одного и того же типа данных с рендерером и без него.

Поле alt в колонки не добавляем. Оно останется в форме редактирования, но не будет занимать место в краткой таблице.

Сохраните колонки и всю конфигурацию.

Создаем TV и назначаем источник файлов

На вкладке «Элементы» создайте дополнительное поле:

  • Имя: portfolio_migx.
  • Подпись: Портфолио на MIGX.
  • Тип ввода: migx.
  • Конфигурация: portfolio_migx.

На вкладке доступа для шаблонов отметьте начальный шаблон главной страницы.

Затем откройте вкладку источников файлов TV и назначьте источник для контекста сайта, обычно web.

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

Через выбранный источник должны быть доступны каталоги:

assets/img/portfolio/fullsize/
assets/img/portfolio/thumbnails/

скриншот вкладки источников TV portfolio_migx с выбранным источником для контекста web

Не меняйте настройки общего источника вслепую, если его уже используют другие поля проекта. При необходимости создайте отдельный источник по инструкции по источникам файлов.

Сохраните TV.

Заполняем работы портфолио

Заново откройте главную страницу и найдите в дополнительных полях «Портфолио на MIGX».

Нажмите «Добавить работу» и заполните первую запись:

  • Название работы: Учебный проект 1.
  • Категория: Сайты.
  • Большое изображение: выберите assets/img/portfolio/fullsize/1.jpg.
  • Изображение для сетки: выберите assets/img/portfolio/thumbnails/1.jpg.
  • Альтернативный текст: Изображение учебного проекта 1.

Файлы выбирайте через кнопку файлового браузера у соответствующего поля. Путь выше показывает, какой файл нужен в нашем комплекте, а не универсальное значение для любого источника.

скриншот формы работы портфолио с заполненными текстовыми полями и двумя выбранными изображениями

Сохраните запись. Затем добавьте еще пять работ, используя пары файлов 2.jpg — 6.jpg из тех же двух каталогов.

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

Демонстрационные файлы и названия нужны для проверки настройки. Перед использованием сайта замените их собственными материалами и подходящими описаниями.

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

скриншот таблицы portfolio_migx с заполненными работами

Сохраните сам ресурс, затем заново откройте его и проверьте сохранение записей.

Создаем чанк одной работы

Создайте обычный чанк с именем creative.portfolio.item. Вставьте разметку одной карточки:

<div class="col-lg-4 col-sm-6">
    <a class="portfolio-box" href="[[+image:htmlent]]" title="[[+title:htmlent]]">
        <img class="img-fluid" src="[[+thumb:htmlent]]" alt="[[+alt:htmlent]]" />
        <div class="portfolio-box-caption">
            <div class="project-category text-white-50">[[+category:htmlent]]</div>
            <div class="project-name">[[+title:htmlent]]</div>
        </div>
    </a>
</div>

Сохраните чанк.

Здесь:

  • image используется в ссылке на большое изображение.
  • thumb используется в src изображения сетки.
  • title выводится в подписи и атрибуте ссылки.
  • category выводится над названием работы.
  • alt заполняет альтернативный текст изображения.

Пути берем из соответствующих полей. Не приписываем перед ними еще раз assets/img/portfolio/: при выборе файлов от корня проекта эта часть уже содержится в сохраненных значениях.

Класс portfolio-box сохраняем. Он используется просмотрщиком изображений исходного Creative.

Создаем чанк обертки портфолио

Создайте обычный чанк с именем creative.portfolio.migx:

<div id="portfolio">
    <div class="container-fluid p-0">
        <div class="row g-0">
            [[getImageList?
                &tvname=`portfolio_migx`
                &tpl=`creative.portfolio.item`
                &limit=`0`
            ]]
        </div>
    </div>
</div>

Сохраните чанк.

Общие контейнеры находятся в обертке, а одна колонка сетки — в чанке записи. Поэтому количество карточек определяется заполненным списком, а не числом скопированных блоков HTML.

Внешний id="portfolio" остается один на всю секцию. Не переносите его в повторяемый чанк карточки.

Заменяем статичное портфолио

Откройте начальный шаблон. После секции услуг найдите исходный блок:

<div id="portfolio">

Замените этот блок целиком, вместе с его контейнерами и шестью статическими карточками, вызовом:

[[$creative.portfolio.migx]]

Следите за вложенностью закрывающих тегов: удаляем весь внешний блок портфолио, но не затрагиваем следующую контактную секцию.

Сохраните шаблон и обновите главную страницу.

 скриншот портфолио Creative, выведенного через MIGX, с заполненными названиями и категориями

Изображения должны появиться в прежней сетке. По нажатию должно открываться соответствующее большое изображение.

SimpleLightbox и его подключение в Creative оставляем без изменений. MIGX выводит записи, но не подключает просмотрщик вместо исходных скриптов.

Проверяем изображения и рендерер

Проверьте отдельно админку и публичную страницу.

В админке:

  1. Откройте запись и убедитесь, что для большого изображения и миниатюры доступны кнопки выбора файла.
  2. Проверьте, что колонка миниатюр показывает изображения.
  3. Убедитесь, что у колонки миниатюр Field указан как thumb, а Renderer — this.renderImage.
  4. Измените название одной работы и порядок записей, затем сохраните ресурс.

На сайте:

  1. Проверьте изменение названия и порядка карточек.
  2. Нажмите на несколько изображений и сравните открывшиеся файлы с выбранными большими изображениями.
  3. Проверьте подписи категорий и названия работ.
  4. Проверьте сетку на узком экране.

Если миниатюра видна в таблице MIGX, но отсутствует на сайте, не меняйте рендерер наугад. Найдите фактический src изображения в HTML страницы и откройте этот адрес отдельно.

Если изображение на сайте работает, но в таблице отображается только путь, проверьте Renderer именно у нужной колонки.

Если не работает ни выбор файла, ни предпросмотр, проверьте тип поля image, настройку Source From и источник, назначенный TV для контекста сайта.

Если получился адрес с повторяющимся каталогом, например assets/img/portfolio/assets/img/portfolio/..., папка добавлена дважды. Сначала проверьте сохраненное значение и настройки источника, а не исправляйте каждый файл вручную.

Если изображения показываются в сетке, но не открываются в просмотрщике, проверьте класс portfolio-box, адрес большого изображения и загрузку JavaScript SimpleLightbox.

Сейчас каждая работа хранится как запись в TV portfolio_migx. Мы использовали этот вариант, чтобы разобраться с файловыми полями, источниками и рендерером таблицы.

В дальнейшей практике подключим ту же секцию через Gallery. Текущее портфолио и его данные пока не удаляем: они пригодятся для сравнения.

Когда подготовим новый вывод, заменим вызов [[$creative.portfolio.migx]] вариантом Gallery. Две обертки с одинаковым id="portfolio" одновременно на странице оставлять нельзя.

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

Пример меток-ссылок под статьей

В прежнем уроке я делал метки под материалы в рамках SEO-курса Антона Маркина. Сохраняю сам практический пример: у каждой метки есть подпись и вручную заданный адрес.

Это не автоматическая система тегов. Здесь не создаются страницы тегов, не собираются связанные ресурсы и не появляется фильтрация по GET-параметрам. Делаем редактируемый список ссылок.

Конфигурация tag и два поля

В менеджере MIGX добавьте конфигурацию tag. Надпись кнопки замените на «Добавить тег».

Добавляем конфигурацию MIGX для тегов

На Formtabs создайте вкладку. Внутри добавьте первое поле: Fieldname name, Caption «Название тега», обычный текстовый ввод. Сохраните поле.

Добавляем поля для элементов

Добавьте второе поле: Fieldname link, Caption «Ссылка», также обычный текстовый ввод. Сохраните поле и вкладку формы.

Добавляем второй элемент

На Columns создайте колонку Header «Название тега», Field name.

Создаем разметку колонок

Затем создайте Header «Ссылка», Field link. Сохраните колонки и всю конфигурацию.

Создаем разметку колонок для тегов

TV tags и доступ для шаблонов

Создайте TV с именем tags и подписью «Метки-ссылки».

Создание дополнительного поля (TV) для тегов с MIGX конфигурацией

В параметрах ввода выберите migx, в конфигурациях укажите tag.

Настраиваем параметры ввода tv

Отметьте шаблоны статей, где нужно это поле, и сохраните TV.

Выбираем шаблоны где будет доступно TV для ввода тегов

Заполняем ссылки

Откройте статью, перейдите в дополнительные поля и нажмите «Добавить тег». Введите понятную подпись и адрес. Сохраните запись, затем сам ресурс.

Добавляем теги к статье

Можно указывать полный адрес другого сайта, полный адрес страницы своего сайта или адрес страницы с якорем. Примеры ниже условные — подставляйте реальные адреса своего проекта:

https://site.ru/
https://site.ru/blog/statya
https://site.ru/blog/statya#imya-yakorya

Относительный адрес вроде /blog/statya тоже возможен, но на установке в подпапке он начинается от корня домена. Если не уверены, используйте полный URL.

Голый #imya-yakorya может вести не туда, куда ожидаете, если в шаблоне есть base href. Подробности — в уроке якорных ссылок.

В старом примере использовались и динамические записи:

[[~9]]
[[~9]]#imya-yakorya
{$_modx->makeUrl(9)}
{$_modx->makeUrl(9)}#imya-yakorya

Число 9 здесь — пример ID, а не ID вашей статьи. Обычный MODX-парсер может обработать теги ссылок на следующем проходе. Но прямой цикл Fenom не выполняет выражение, записанное текстом внутри JSON: makeUrl нужно вызывать в самом шаблоне, а не хранить исполняемый код в поле. Для единого примера ниже заполняйте link готовыми адресами.

Вывод на стандартных тегах без пустой обертки

Создайте чанк tplTag:

#<a class="me-2 link-dark" href="[[+link:htmlent]]">[[+name:htmlent]]</a>

Создайте чанк обертки tplTagsWrapper. Иконку сохраняем из прежнего примера, а место списка задаем плейсхолдером output:

<p class="mb-2">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-tags" viewBox="0 0 16 16" aria-hidden="true">
  <path d="M3 2v4.586l7 7L14.586 9l-7-7H3zM2 2a1 1 0 0 1 1-1h4.586a1 1 0 0 1 .707.293l7 7a1 1 0 0 1 0 1.414l-4.586 4.586a1 1 0 0 1-1.414 0l-7-7A1 1 0 0 1 2 6.586V2z"/>
  <path d="M5.5 5a.5.5 0 1 1 0-1 .5.5 0 0 1 0 1zm0 1a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3zM1 7.086a1 1 0 0 0 .293.707L8.75 15.25l-.043.043a1 1 0 0 1-1.414 0l-7-7A1 1 0 0 1 0 7.586V3a1 1 0 0 1 1-1v5.086z"/>
</svg>
  [[+output]]
</p>

После текста статьи в шаблоне или в соответствующем чанке поставьте только вызов:

[[getImageList?
  &tvname=`tags`
  &tpl=`tplTag`
  &wrapperTpl=`tplTagsWrapper`
]]

Обертка в getImageList применяется к непустому результату. Поэтому отдельный абзац и иконка не выводятся, если список записей пустой. Не оборачивайте этот вызов еще одним безусловным <p> с иконкой.

Полный вариант на Fenom

Вместо предыдущего вызова можно вывести список непосредственно в Fenom-шаблоне:

{set $tags = $_modx->resource.tags | fromJSON}
{if $tags}
  <p class="mb-2">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-tags" viewBox="0 0 16 16" aria-hidden="true">
  <path d="M3 2v4.586l7 7L14.586 9l-7-7H3zM2 2a1 1 0 0 1 1-1h4.586a1 1 0 0 1 .707.293l7 7a1 1 0 0 1 0 1.414l-4.586 4.586a1 1 0 0 1-1.414 0l-7-7A1 1 0 0 1 2 6.586V2z"/>
  <path d="M5.5 5a.5.5 0 1 1 0-1 .5.5 0 0 1 0 1zm0 1a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3zM1 7.086a1 1 0 0 0 .293.707L8.75 15.25l-.043.043a1 1 0 0 1-1.414 0l-7-7A1 1 0 0 1 0 7.586V3a1 1 0 0 1 1-1v5.086z"/>
</svg>
    {foreach $tags as $tag}
      #<a class="me-2 link-dark" href="{$tag.link | escape}">{$tag.name | escape}</a>
    {/foreach}
  </p>
{/if}

Разметка классов рассчитана на Bootstrap 5. Для другой основы замените классы оформления своими. При заполненных записях получается список меток:

Внешний вид тегирования

В прежней версии без проверки данных иконка оставалась даже у пустого списка:

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

Для Fenom проверяем массив после fromJSON, а не наличие текста в TV: строка [] не пустая, хотя записей в ней нет. На стандартных тегах задачу решает wrapperTpl.

Если храните вывод в отдельном файловом чанке, условие должно находиться внутри него. После подключения файловых элементов его можно включить так:

{include 'file:chunks/blog/tags.tpl'}

Путь chunks/blog/tags.tpl здесь условный относительно настроенного каталога элементов. Файловый чанк не создается этой командой: сначала сохраните туда полный Fenom-вариант. Не нужно переносить остальные элементы в файлы ради этого примера.

Изображения и источники файлов

MIGX умеет работать с источниками файлов. В getImageList есть обработка типов ввода и формирование URL через источник. Но при прямом чтении JSON в Fenom вы получаете сохраненные значения, а не автоматически подготовленные адреса.

Поэтому если изображение не отображается, сначала выясните, что реально хранится в поле: имя файла, путь относительно папки источника, путь относительно корня проекта или полный URL.

  1. Откройте настройки TV и проверьте назначенный источник для нужного контекста.
  2. В конфигурации проверьте поле изображения: тип image и настройку sourceFrom. Если источник должен браться из MIGX TV, используется значение migx.
  3. Заново откройте запись, выберите изображение и сохраните запись и ресурс.
  4. В исходном коде публичной страницы найдите img src и откройте полученный URL в отдельной вкладке.

В менеджере конфигурации откройте поле изображения и найдите настройки источника. Если есть выбор Source From, укажите migx, затем назначьте источник на вкладке источников самого TV. Если интерфейс выпуска отличается, сначала сверяйтесь с его настройками, а не выбирайте случайный ID источника.
скриншот настройки файлового поля image с типом image и Source From = migx

В JSON описание поля может выглядеть так. Это только фрагмент одного поля, не полный экспорт конфигурации:

{
  "field": "image",
  "caption": "Изображение",
  "inputTVtype": "image",
  "sourceFrom": "migx"
}

При прямом чтении JSON в Fenom источник не подготавливает адреса автоматически. Например, если в поле thumb сохранен путь вида assets/img/portfolio/thumbnails/1.jpg относительно корня проекта, к нему можно добавить базовый URL установки:

{set $portfolio = $_modx->resource.portfolio_migx | fromJSON}
{if $portfolio}
    {foreach $portfolio as $item}
        {if $item.thumb}
            <img src="{$_modx->config.base_url | escape}{$item.thumb | escape}" alt="{$item.alt | escape}">
        {/if}
    {/foreach}
{/if}

Это самостоятельный пример вывода миниатюр, а не полная разметка портфолио. Для проверки его можно временно поставить непосредственно в Fenom-шаблоне вместо вызова портфолио, а затем вернуть основной вывод.

Пример рассчитан только на сохраненные пути относительно корня проекта, без начального слеша. Если значение уже содержит полный URL или подготовленный адрес, повторно добавлять base_url нельзя.

Если позже добавите изображения во вложенные записи, отдельно проверьте их сохраненные пути. Передача JSON через value сама по себе не создает настройки источника. Подробнее об организации каталогов — в уроке источников файлов.

Копирование конфигураций, миниатюры и общий блок

Если новая конфигурация почти совпадает с существующей, ее можно подготовить через экспорт и импорт. Для упражнения скопируем конфигурацию services в новую services_copy, не меняя исходную.

Быстро создаем похожую конфигурацию

Сначала создайте пустую конфигурацию с новым уникальным именем, например services_copy.

Создание пустой конфигурации MIGX
У готовой конфигурации откройте контекстное меню — «Экспорт/Импорт». Скопируйте JSON и сохраните его отдельно: это также копия исходной конфигурации перед изменениями.

Экспорт и импорт кода

Откройте «Экспорт/Импорт» у новой конфигурации. Если экспорт содержит имя исходной конфигурации, замените его на новое, не переносите служебные идентификаторы вслепую. Импорт не должен перезаписать services.

Вставьте подготовленный JSON, сохраните и закройте окно.

Импортируем поля

Снова откройте целевую конфигурацию. Проверьте уникальное имя, вкладки, поля и колонки. Добавьте нужное поле, а затем убедитесь, что исходная services осталась без изменений.

Конфигурация перенесена
Теперь создайте TV для новой конфигурации и назначьте его нужному шаблону по уже показанному порядку. Изменение структуры не преобразует автоматически все ранее сохраненные данные: переименованные поля нужно учитывать и в выводе.

Миниатюры через pThumb

В основной практике мы использовали готовые миниатюры Creative. Если установлен pThumb, их можно формировать из большого изображения при выводе. Это необязательный вариант, а не дополнительное требование к упражнению.

В чанке creative.portfolio.item можно заменить только тег изображения, оставив ссылку на большой файл без изменений:

<img class="img-fluid" src="[[+image:pthumb=`w=600&h=400&zc=1&q=85`:htmlent]]" alt="[[+alt:htmlent]]" />

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

В Fenom-примере из раздела «Изображения и источники файлов» внутри цикла foreach $portfolio as $item замените блок проверки $item.thumb и вывода изображения следующим фрагментом. Он создает миниатюру из большого изображения:

{if $item.image}
    {set $preview = $_modx->runSnippet('pthumb', [
        'input' => $item.image,
        'options' => 'w=600&h=400&zc=1&q=85'
    ])}
    {if $preview}
        <img class="img-fluid" src="{$preview | escape}" alt="{$item.alt | escape}" />
    {/if}
{/if}

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

Выводим один общий блок на разных страницах

Чтобы не заполнять одинаковый блок на каждой странице, сохраните данные в одном ресурсе и укажите его ID в docid. В примере ID 1 условный: замените его своим источником.

[[getImageList?
    &docid=`1`
    &tvname=`services_section`
    &tpl=`creative.services.section`
    &limit=`1`
]]

В полном Fenom-примере вложенной секции замените строку получения данных на следующие две:

{set $sourceId = 1}
{set $sections = $sourceId | resource : 'services_section' | fromJSON}

Остальной код секции остается прежним. Вместо 1 укажите ID ресурса, в котором заполнен services_section. На странице-получателе отдельно проверяйте актуальность кешированного результата.

Вывод в обратном порядке

Параметр reverse=1 разворачивает порядок записей. Не нужно искать отдельный sortdir без описания поля сортировки:

[[getImageList?
  &tvname=`tags`
  &tpl=`tplTag`
  &reverse=`1`
]]

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

Разное оформление каждого второго элемента

Чередование оформления не требует новой конфигурации. Можно добавить класс на этапе вывода либо использовать CSS. Для примера берем уже созданные метки с полями name и link.

getImageList: плейсхолдер _alt

Создайте чанк tplTagAlternate:

<li class="tag-item [[+_alt:is=`1`:then=`tag-item-alt`:else=``]]">
  <a href="[[+link:htmlent]]">[[+name:htmlent]]</a>
</li>

Выведите записи:

<ul class="tag-list">
  [[getImageList?
    &tvname=`tags`
    &tpl=`tplTagAlternate`
  ]]
</ul>

_alt равен 0 у первой строки, 1 у второй, затем повторяется. При выборе класса tag-item-alt вторая, четвертая и следующие четные записи получат другое оформление:

.tag-list > .tag-item {
  padding: 8px 12px;
}
.tag-list > .tag-item-alt {
  background-color: #f4f4f4;
}

CSS добавьте в файл стилей своей верстки. Проверьте список как минимум из четырех записей. Пример вывода выше намеренно показывает сам прием; если нужна непустая обертка только при наличии записей, вынесите ul в wrapperTpl, как в примере меток.

Конструкция из старой статьи с then=чанк1 и else=чанк2 выбирала только строки с именами. Она сама по себе не вызывает содержимое двух чанков. Для простого чередования достаточно класса, как выше.

Fenom: независимый счетчик вывода

Если массив может иметь необычные ключи, не считайте четность по ним. Задайте отдельный счетчик и увеличивайте его у каждой выведенной записи:

{set $tags = $_modx->resource.tags | fromJSON}
{if $tags}
  {set $position = 0}
  <ul class="tag-list">
    {foreach $tags as $tag}
      {set $position = $position + 1}
      <li class="tag-item {if $position % 2 == 0}tag-item-alt{/if}">
        <a href="{$tag.link | escape}">{$tag.name | escape}</a>
      </li>
    {/foreach}
  </ul>
{/if}

Если внутри цикла скрываете часть записей, увеличивайте счетчик после проверки допуска к выводу. Тогда чередование будет соответствовать видимым элементам.

Чередование только через CSS

Если все элементы — соседние li внутри одного ul, можно не менять ни конфигурацию, ни чанк:

.tag-list > .tag-item:nth-child(even) {
  background-color: #f4f4f4;
}

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

Если окно зависает на loading

Бесконечный loading — симптом, а не название одной конкретной ошибки. В моем старом случае зависали вложенные поля, а запрос к assets/components/migx/connector.php возвращал HTTP 500.

MIGX loading

Сначала находим сообщение об ошибке

  1. Откройте инструменты разработчика браузера и вкладку Network («Сеть»). Повторите открытие проблемного поля.
  2. Найдите запрос к коннектору MIGX. Посмотрите статус и вкладку Response («Ответ»). Не публикуйте содержимое запроса с идентификаторами сессии или персональными данными.
  3. Откройте журнал ошибок CMS и журнал PHP сайта в панели хостинга. Сопоставьте запись по времени с запросом.
  4. Если существует файл assets/components/migx/error_log, прочитайте его через файловый менеджер или скачайте. Такой файл не обязан существовать на каждом хостинге.

Отсутствие записи в журнале CMS не означает отсутствие ошибки PHP: сбой может произойти раньше, чем приложение записало ее в свой лог.

Для рабочего сайта используйте запись ошибок в журнал, а не вывод посетителям. Если настройки PHP меняются через панель, проверьте log_errors и error_log у конкретного сайта. Фрагмент php.ini для принципа настройки:

display_errors = Off
log_errors = On

Это две директивы, не полный php.ini. Путь error_log зависит от хостинга. Не создавайте общедоступную страницу с журналом и не публикуйте файл ошибок в статье.

Что проверять по результату

  • При ошибке доступа проверьте владельца и права конкретного файла или каталога. Значения 0755 для каталогов и 0644 для файлов — распространенный вариант, но не универсальное решение для всех схем запуска PHP.
  • При сообщениях о несовместимом коде сверьте версии CMS, MIGX и PHP. Обновление выполняйте на копии или после резервного копирования, а не случайной переустановкой рабочего сайта.
  • Если журнал защиты хостинга показывает блокировку именно этого запроса, передайте данные поддержке. Не отключайте mod_security целиком без подтвержденной причины.
  • Если ошибка появилась после изменения конфигурации, проверьте имя Configs вложенного поля, типы ввода и последние изменения.

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

Мой старый случай Cannot declare class в MODX 2
Раньше я временно включил display_errors и увидел сообщение:
Fatal error: Cannot declare class modTemplateVarInputRenderText,
because the name is already in use in
core/model/modx/processors/element/tv/renders/mgr/input/text.class.php

Та же ошибка была записана в assets/components/migx/error_log. При наличии журнала включать публичный вывод ошибок не требовалось.

Тогда использовалась защита от повторного объявления класса в файле ядра. Сохраняю фрагмент прежней правки, а не выдаю его за полный актуальный файл:

if (!class_exists('modTemplateVarInputRenderText')) {
    class modTemplateVarInputRenderText extends modTemplateVarInputRender {
        public function getTemplate() {
            return 'element/tv/renders/input/textbox.tpl';
        }
    }
}
return 'modTemplateVarInputRenderText';

Версии ядра и MIGX исходного случая не зафиксированы. Поэтому не заменяйте этим фрагментом файл свежей установки и не применяйте путь к MODX 3: там другая структура классов. Сначала ищите исправление для выбранного выпуска, проверяйте причину повторного подключения и тестируйте на копии.

Если временная правка ядра действительно необходима для старого проекта, сохраните исходный файл и зафиксируйте изменение: обновление ядра может его перезаписать. Любой временный вывод ошибок после диагностики отключите.

Проверка результата

После основной практики проверьте:

  • Записи сохраняются после закрытия формы MIGX и повторного открытия ресурса.
  • На странице выводится один выбранный вариант секции услуг, без дублирования старой разметки.
  • Названия, описания и порядок карточек соответствуют заполненным данным.
  • Если выполняли вложенный пример, общий заголовок и карточки меняются через services_section.
  • В портфолио отображаются выбранные миниатюры, а по нажатию открываются соответствующие большие изображения.
  • Рендерер this.renderImage показывает миниатюры в таблице админки.
  • В публичном HTML нет повторяющихся ID секций и оставшихся тегов шаблонизатора.

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

Если результат не обновляется, проверьте сохранение ресурса, источник данных и место вывода. После этого проверяйте соответствующий кеш. Некешируемый вызов не является универсальным исправлением всех проблем.

Возможности MIGX и следующие уроки

MIGX — гибкий и глубокий компонент, возможности которого не уместить в один урок. Здесь мы разобрали JSON-списки в TV: обычные записи, вложенные поля, изображения и несколько приемов вывода.

Другие задачи решаются через MIGXdb: работу с записями отдельных таблиц, связанными данными и собственными страницами управления в админке. Это уже отдельное направление, а не еще одна настройка нашего списка услуг.

Если хотите продолжить знакомство с возможностями компонента, следующий дополнительный материал — редактор блоков страницы на MIGX. В нем разберем организацию разных типов секций и выбор подходящей формы при добавлении блока.

Этот этап необязателен для обычного списка карточек. После него вернемся к учебному Creative и подключим портфолио через Gallery, чтобы сравнить два способа работы с изображениями.

Перенос HTML-шаблона в MODX и подключение оформления сайта
← Предыдущая статьяКак перенести HTML-шаблон в MODX
Следующая статья →MIGX в MIGX: создаем редактор блоков страницы
Редактор блоков страницы на MIGX с вложенными записями
Поделиться с друзьями
Алексей

Веб-дизайнер и SEO оптимизатор. Занимаюсь созданием сайтов с 2010 года и их продвижение с 2012 года!

Оцените автора
( 8 оценок, среднее 4.88 из 5 )
Web-Revenue.ru