Чанки — это повторно используемые фрагменты кода или содержимого, которые могут быть вставлены на веб-страницу или шаблон. Они похожи на шаблоны, но меньше по размеру и больше ориентированы на конкретные фрагменты контента и функциональность.
Вот несколько примеров распространенных чанков в MODX:
- Чанк шапки сайта: Содержит код шапки сайта, такой как HTML doctype, мета-теги, файлы CSS и JavaScript, а также навигацию по сайту. Пример: [[!Header]]
- Чанк футера сайта: Содержит код футера, такую как информация об авторских правах, ссылки на социальные сети и любые файлы JavaScript, которые необходимо загрузить в конце страницы. Пример: [[!Footer]]
- Чанк навигации: Используется для создания навигационных меню, которые могут быть вставлены в шаблоны или другие фрагменты. Пример: [[!Navigation]]
- Чанк содержимого страницы: Используется для отображения основного содержимого страницы. Его можно использовать для вставки текста, изображений, видео или любого другого контента, который необходимо отобразить на странице. Пример: [[!Content]]
- Чанк боковой панели: Используется для отображения дополнительного контента, такого как виджеты, объявления или связанные ссылки. Его можно вставить в шаблоны или другие фрагменты, чтобы создать область боковой панели. Пример: [[!Sidebar]]
- Чанк формы поиска: Используется для создания формы поиска, которая позволяет пользователям выполнять поиск по сайту. Пример: [[!SearchForm]]
Это всего лишь несколько примеров из множества блоков, которые могут быть использованы в MODX. Чанки могут быть созданы и настроены в соответствии с потребностями любого сайта, что делает MODX гибкой и мощной CMS.
MODX чанки
Создание пользовательских чанков
Чтобы создать пользовательский чанк в MODX, выполните следующие действия:
- Войдите в MODX manager и перейдите в меню «Элементы».
- Нажмите кнопку «Создать чанк».
- Введите имя и описание для чанка.
- Добавьте HTML, текст или код для фрагмента в поле «Код чанка».
- Настройте любые дополнительные параметры для блока.
- Сохраните этот чанк.
Вот пример простого пользовательского чанка , который отображает шапку сайта:
Чтобы включить этот фрагмент в шаблон или ресурс, используйте следующий вызов фрагмента:
[[$customChunk]]
Замените «customChunk» именем вашего блока.
Передача параметров в чанк
Чанки также могут принимать параметры, позволяя настраивать содержимое чанка во время выполнения. Чтобы передать параметр в чанк, включите его в вызов блока, используя следующий синтаксис:
[[$customChunk?param1=value1getOption(‘param1’, $scriptProperties, ‘default_value’); $param2 = $modx->getOption(‘param2’, $scriptProperties, ‘default_value’);
Вот пример передачи параметра чанку в MODX:
Допустим, у нас есть раздел под названием «Рекомендуемые продукты», который отображает список рекомендуемых продуктов на сайте. Мы хотим иметь возможность контролировать, сколько продуктов отображается в списке, передавая параметр в чанк.
MODX шаблоны и чанки
-
[[!pdoResources? tpl=`FeaturedProductsListItem` limit=`3`]]
- Изображение на фоне
- Видео на фоне
- Сплошной цвет на фоне
В этом коде мы вызываем чанк FeaturedProducts и передаем значение 3 для параметра limit. При этом отобразится список из 3 рекомендуемых продуктов на нашем сайте.
Обратите внимание, что имени параметра предшествует амперсанд (https://codelab.pro/rukovodstvo-po-chankam-v-modx/» target=»_blank»]codelab.pro[/mask_link]
[[*longtitle:empty=`[[*pagetitle]]`]]
Вышеприведённый код состоит из HTML разметки и 2 вызовов сниппета getImageList . Первый выводит индикаторы карусели, а второй – слайды, содержащие изображения. Данные сниппеты имеют 2 параметра. Параметр tvname предназначен для указания имени TV-переменной с MIGX данными, которые необходимо вывести на страницу. А параметр tpl определён для того чтобы задать шаблон (чанк), посредством которого будет формироваться каждая строка данных из MIGX TV-поля photo.
Содержимое чанка tplCarouselIndicator:
Содержимое чанка tplCarouselItem:
[[+title]]
Результат отображения карусели на странице:
В данной заметке вы узнаете, что такое Multiple Formtabs и как создать конфигурацию с разным набором данных. Ну и конечно же создадим с вами слайдер у которого будут разные типы слайдов, а в конце вас ждёт очень интересная история которую я долго не решался кому либо рассказать (если конечно вам интересно, но история интересная — поверьте). И так, примеры слайдов:
Вот как это будет
Еще одно объявление! Я часто буду ссылаться на первый урок, дабы не повторяться, так что настоятельно рекомендую ознакомиться с
Зачем?
Давайте фантазировать: Попадает вам проект, где к примеру, на главной странице есть слайдер у которого несколько типов слайдов, у одного на фоне видео, у другого картинка, а у третьего например сплошной цвет. Не будете же вы создавать один набор полей (одну конфигурацию) и запихать (пардон за лексикон) в него все эти поля и рассказывать менеджеру как нужно с этим жить и быть. Это не серьезный подход! ? (Надеюсь кто нибудь поймёт)
За дело
Что такое чанки в modx
Чанки — это кусочки статического текста, которые вы можете повторно использовать на своем сайте. Хотя чанки не могут содержать никакой логики напрямую, тем не менее, они могут содержать вызовы сниппетов, которые представляют собой исполняемый PHP код, который в свою очередь производит динамический вывод.
Оглавление
Чанки — это кусочки статического текста, которые вы можете повторно использовать на своем сайте. Хотя чанки не могут содержать никакой логики напрямую, тем не менее, они могут содержать вызовы сниппетов, которые представляют собой исполняемый PHP код, который в свою очередь производит динамический вывод данных.
Создание чанка
Прежде чем использовать чанк, вы должны сначала создать его и дать ему имя. Перейдите во вкладку дерева «Элементы», выберите «Чанки», затем «Новый чанк» или «Быстро создать чанк».
Использование чанка
Для использования чанка, вам необходимо обратиться к нему по его имени:
Этот плейсхолдер заменится содержимым чанка.
Вы также можете передать свойства в чанк. Скажем, у вас был фрагмент с именем intro и содержимым:
Вы можете заполнить эти значения следующим образом:
В итоге вы увидите следующий вывод:
Обработка чанка через API MODx
Сниппет ниже, извлекает содержимое чанка и обрабатывает его с массивом свойств для всех опубликованных ресурсов и возвращает отформатированные результаты в виде таблицы, устанавливая класс «alt» для четных строк:
Модификация чанка через API MODx
Чанками также можно управлять с помощью API MODx:
Благодарность автору
Если по какой-либо причине вы хотите поблагодарить автора данного ресурса, вы можете это сделать одним из удобных для вас способов ниже.
Один из самых популярных способов поблагодарить автора, воспользоваться сервисом Яндекс.Деньги.
В этой статье рассмотрим понятие, назначение и применение чанков в MODX Revolution. Кроме этого познакомимся с тем, как выполняется обработка и управление чанками в сниппетах через API.
Что такое чанк
Например, чанк (его содержимое), который используется для вывода меню сайта:
Кроме этого чанки в MODX Revolution также используются в качестве шаблонов для вывода результатов работы сниппета.
Например, чанк (tpl.Tickets.list.row), который используется в качестве шаблона сниппета getTickets :
Внутри чанках, как и во многих других элементах MODX Revolution (шаблонах, TV-параметрах, полях ресурса), нельзя непосредственно размещать php-код. Размещение в этих элементах динамического содержимого осуществляется посредством вызовов сниппетов, которые исполняют хранящийся внутри них PHP-код.
Где хранятся чанки
Работа с чанками в админке MODX
Чанки в админке MODX Revolution расположены на левой панели во вкладке «Элементы».
Создание чанка
Кроме этого система MODX позволяет хранить содержимое чанка во внешнем файле. Для этого необходимо установить галочку в поле статичный, выбрать источник файлов и указать его расположение.
Редактирование чанка
Для редактирования некоторого чанка в админке необходимо нажать на него левой кнопкой мыши. После этого откроется форма полями чанки, в которую необходимо внести изменения и нажать на кнопку «Сохранить».
Как использовать чанки в MODX
Вставка чанка в шаблон или содержимое ресурса осуществляется с помощью следующего тега MODX:
Во время обработки страницы, парсер MODX заменит тег чанка его содержимым.
Чанк и его параметры
Чанки в MODX могут иметь параметры. Например, рассмотрим чанк «intro», имеющий следующее содержимое:
Он имеет 2 плейсхолдера: [[+name]] и [[+messageCount]]. Передать значения этим плейсхолдерам можно с помощью указания соответствующих параметров вызову чанка:
В результате, получим следующее содержимое:
или в содержимом чанка:
Условия в чанках
Условия и другие фильтры MODX можно использовать в любых специальных тегах этой системы.
Например, внутри чанка в зависимости от идентификатора родителя текущего ресурса вывести один или другой чанк.
Но с фильтрами в MODX надо быть очень осторожными, т.к. они могут сильно увеличить время генерации страницы. Это происходит потому, что условия в тегах MODX работают не так как обычные условия в php. Например, в вышеприведённом примере оба чанка вызовутся, не зависимого от того какой идентификатор имеет родитель текущего ресурса.
А уже только потом будет определяться какой из этих чанков будет выведен на страницу. Поэтому в MODX они и называются фильтрами. А теперь давайте представим, что в этих чанках есть вызовы некэшируемых сниппетов. В результате в не зависимости от идентификатора родителя текущего ресурса эти вызовы будут выполняться как в первом, так и во втором чанке.
Это может привести к значительному увеличению времени генерации страницы и нагрузке на сервер. В таких случаях лучше фильтры не использовать, а выполнять эти действия с помощью сниппета.
Обработка чанка с помощью API
Чанки часто выступают в качестве шаблонов для вывода результатов работы сниппета. Обрабатывается чанк в сниппете через функцию getChunk().
Например, рассмотрим, как использовать чанк «rowTpl» в сниппете.
Чанк «rowTpl», имеет следующее содержимое:
Содержимое (php-код) сниппета, который получает все опубликованные ресурсы на сайте и выводит их в таблицу. Для вывода данных отдельного ресурса (одной строки таблицы, состоящей из 2 ячеек) используется шаблон rowTpl.
MODx: ресурсы, чанки и какие-то телевизоры
После того как один мой знакомый спросил у меня про то, что за телевизоры используются в шаблонах, я решил отложить все дела на вечер и написать эту статью.
Речь пойдёт о том из чего состоит MODx, как его лучше «готовить», «подавать» и «употреблять».
Рассчитана она в первую очередь на новичков т.к. содержит базовый минимум того, что нужно знать любому modxоводу, ну и конечно на тех кому просто интересно.
Статья ориентирована в основном на Revolution и отражает основные отличия в синтаксисе её от предшественницы, но для обратной совместимости буду вставлять иногда аналогии с Evolution.
Ресурсы (Resources)
Зачастую ресурс представляет собой страницу сайта. Кроме того существуют другие типы ресурсов, такие как, ссылки, сами файлы, и т.д. По умолчанию тип нового ресурса — документ, точнее представление одной страницы вашего сайта.
Шаблоны (Templates)
Параметры
Используются для вывода значений полей ресурса.
Вызов осуществляется так:
| Evolution | Revolution |
| [*field*] | [[*field]] |
Полный список полей можно посмотреть в документации здесь.
TV параметры
ТелевизорДополнительное поле или переменная шаблона (TV) — это настраиваемое поле, или, точнее это настраиваемое поле для ресурсов MODx. TV-параметры используются для расширения стандартных полей ресурса. Каждый ресурс в MODx имеет определенное количество полей по умолчанию см. выше в разделе про ресурсы.
Если встаёт задача добавить некоторые дополнительные поля на страницу, например, выпадающий список названий месяцев или дополнительное изображение, или любой другой тип пользовательских данных, это можно сделать добавив TV-параметр соответствующего типа. MODx позволяет иметь практически неограниченное количество TV-параметров.
TV-тег заменяется соответствующим значением заполненным пользователем при обработке ресурса. Так же каждый такой параметр привязан к какому либо шаблону и может использоваться лишь в совокупности с ним.
Вызов осуществляется так:
| Evolution | Revolution |
| [*tv*] | [[*tv]] |
TV параметры можно использовать как чанки добавляя им параметры. Например если есть TV-параметр ‘intromsg’ со значением:
Полный список фильтров можно посмотреть тут. Кроме того фильтры можно применять к чанкам и сниппетам.
Создадим сниппет «CountChar», который будет в качестве параметров получать строку и цвет, а на выходе выдавать количество букв в строке и выделять это число указанным цветом.
В коде сниппета получаем параметры. При этом, можно задать значение, которое будет присваиваться переменной, если параметр не указывался (», ‘black’). Далее производим вычисления и возвращаем результат.