Параметр в MODX — элемент, который содержит определенную информацию для текущей страницы. Их можно непосредственно вывести на страницу или передать сниппету в качестве параметра.
Все параметры можно разделить на основные, TV-параметры и системные.
[*pagetitle*]
Это основной параметр который вернет нам заголовок страницы. Чаще всего он используется для вывода title у страницы:
[*pagetitle*]
Список основных параметров заранее определен и содержит основную информацию о документе.
[*pagetitle*] — заголовок документа [*longtitle*] — расширенный заголовок документа [*description*] — описание документа [*introtext*] — аннотация документа [*content*] — содержимое документа [*id*] — идентификатор (номер) документа [*parent*] — номер (ID) родительского документа [*pub_date*] — дата публикации дкоумента [*unpub_date*] — дата завершения публикации [*createdby*] — Идентификатор пользователя создавшего документ [*createdon*] — Дата создания документа [~идентификатор~] — URL документа по указанному идентификатору
Стоит отдельно упомянуть о том, что параметры можно сочетать. В особенности это актиально для создания ссылок на разные документы с помощью параметра [~идентификатор~]. В качестве идентификатора можно также задать параметр.
MODx Revolution — гостевая книга или FAQ (2-я часть)
Вывести ссылку на текущий документ.
[~[*parent*]~]
Вывести ссылку на родителя текущего документа.
TV-параметры позволяют добавить к документу дополнительную информацию, которую затем можно использовать на равне с основными параметрами. Также TV-параметры имеют различные типы и в зависимости от этого меняется их управление и представление.
[*МойПараметр*]
Создание и редактирование TV-параметра
Все чанки находятся в следующем месте:
Ресурсы → Управление ресурсами → Параметры (TV) Список TV-параметров выглядит примерно так:
Список TV-параметров в MODX Evo
Для создания необходимо нажать на ссылку Новый параметр (TV), а для редактирования существующего TV-параметра достаточно нажать на ссылку с его названием. Появится следующая форма:
Создание TV-параметра в MODX Evo
Имя параметра — используется для вызова TV-параметра. Можно использовать как английский так и русский язык, а также дефис (-) и знак подчеркивания (_). Пробел использовать нельзя!
Описание — используется для более расширенной информации о TV-параметре в документе при редактировании, а также в общем списке TV-параметров.
Тип ввода — определяет вид получаемой информации. В зависимости от выбранного типа интерфейс меняется. Более подробно смотрите Типы ввода TV-параметров.
Значение по умолчанию — определеяет значение TV-параметра по умолчанию при редактировании документа.
Возможные значения — используются в некоторых типах ввода (например Radio Options, Check Box) для предоставления вариантов выбора. Более подробно смотрите Определение значений TV-параметра.
Визуальный компонент — определеяет вариант вывода TV-параметра на страницу сайта. Более подробно смотрите Вид TV-параметра.
Перенос верстки в MODx. Дополнительные поля TV MODx
Порядок в списке — определяет порядок TV-параметра в документе.
Ограничить доступ к редактированию параметра — если включить флажок, то никто кроме администраторов не сможет редактировать этот TV-параметр.
Text — поле ввода
Поле ввода MODX Evo
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Raw Text, Raw Textarea
Устарели и не рекомендуются к использованию. Вместо них рекомендуется использовать Textarea и Textarea (Mini).
Textarea и Textarea (Mini) — текстовое поле
Текстовое поле в MODX Evo
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
RichText — поле с визуальным редактором
Визуальный редактор (RichText) в MODX Evo
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
DropDown List Menu — раскрывающийся список
Выпадающий список в MODX Evo
Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
Listbox (Single-Select) и Listbox (Multi-Select) — список множественного выбора
Список с множественным выбором в MODX Evo
Single-Select и Multi-Select отличаются только тем, что в первом варианте можно выбрать одно значение, а во втором несколько (с использование Ctrl).
Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
Radio Options — переключатели
Переключатели (Radio) в MODX Evo
Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
Check Box — флажки
Переключатели (checkbox) в MODX Evo
Поле Возможные значения задает конечный список значений и определеляется специальным форматом. Более подробно смотрите Определение значений TV-параметра. Значение по умолчанию определяет выбранный пункт при первом редактировании.
Выбор изображения в MODX Evo
При нажатии кнопки Вставить открывается файловый менеджер, который позволяет выбрать необходимое изображение и загрузить его при необходимости.
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Выбор файла в MODX Evo
При нажатии кнопки Вставить открывается файловый менеджер, который позволяет выбрать необходимый файл и загрузить его при необходимости.
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Ссылка — TV-параметр в MODX Evo
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Email — электронная почта
Email — TV-параметр в MODX Evo
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Число — TV-параметр в MODX Evo
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Дата — TV-параметр в MODX Evo
Первая кнопка вызывает календарик, с помощью которого можно выбрать дату. Вторая кнопка стирает дату.
Возможные значения не используются. Значение по умолчанию автоматически записывается в поле при первом редактировании.
Определение значений TV-параметра
Настройка Возможные значения определяются возможные варианты для таких параметров как DropDown List Menu, Listbox,Check Box и Radio Options.
Формат определения значений следующий:
Разделитель «==» используется для разделения отображаемого и фактического значения, а разделитель «||» разделяет значения между собой.
Если фактические и отображаемые значения совпадают, то можно использовать упрощенный вариант записи:
Тип ввода: DropDown List Menu
Значения выпадающего список — TV-параметр в MODX Evo
Когда пользователь будет редактировать документ, то он увидит выпадающий список со значениями Красный, Зеленый, Синий. Но при выборе в базу сохранится одно из значений — #FF0000, #00FF00 или #0000FF
Вывод выпадающего списка — TV-параметр в MODX Evo
Если определить возможные значения как Красный||Зеленый||Синий, то выводимое значение будет совпадать с сохраняемым.
Источник: modx-gu.ru
Шаблоны для CMS MODx. Блог на MODX Revolution: интеграция дизайна и шаблон одиночных веб-страниц
Всем привет. Решил выйти из ридонли.
Не для кого не секрет что админка Evo устарела еще 10 лет назад. По сему нужно что-то делать для комфортной работы с админкой на планшетах и мобилках. За день на коленке был собран новый шаблон для админки который по своему принципу очень похож на админку WordPress (да и по дизайну почти слизан с нее). Просьба не кидаться тапками, мол фу, WordPress… Админка у них явно удобней и выглядит лучше чем у нашего любимого Evo.
Сам шаблон сделан на основе дефолтной темы от Dmi3yy и взял из нее только лучшее. Шаблон работает с версии 1.1RC. Если вы обладатель более старой версии, вы можете поменять файл /manager/index.php на кастомный в своем MODx и все будет работать.
Основные отличия от остальных тем:
- Убрано верхнее меню. Полностью.
- Вместо верхнего менюбыстрые ссылки на создание элементов (чанки, сниппеты и т.д.)
- Верхнее меню перенесено в левую часть. К дереву документов.
- Переписан коллапс бокового меню.
- Добавлены выпадающие списки для верхнего сайдбара и бокового меню.
- Стало удобно работать с админкой на планшете.
- Переписать стили для всех элементов в главном фрейме.
- Добавить поддержку кастомных экшнов, без внесения изменений в оригинальные.
- Переписать большинство экшнов и сделать к ним шаблоны. (разделить логику и представление)
- Добавить сетку для всех элементов админки.
- Переписать большинство скриптов и вынести их в отдельный файл. Надоело обилие скриптов во фреймах.
- Добавить js фреймворк для комфортной работы с полями и формами опционально. (Основные элементы формы останутся для поддержки модулей)
- Вынести все стили из фреймов в отдельные файлы для каждого фрейма.
Шаблон закинул в репозиторий можно установить через него когда пройдет модерацию или скачать архив, распаковать и перекинуть все из папки MODxPress-master в корень сайта.
UPD от 23/02.
- Дописан менеджерский индекс. Теперь он может подгружать экшены из папки темы.
- Распиханы js и css файлы из главных фреймов. В качестве глобального контейнера для переменных JS используется window.globalVars. Это поможет убрать весь завязанный на PHP JS код в файлы. Работать с таким глобальным массивом можно даже через плейсхолдеры.
- Обновлены все экшены (убраны все изображения, заменены на векторные иконки). Кое где всетаки еще попадаются картинки которые пропустил. Преимущественно в контекстных меню.
- Причесан скрипт генерации нод (дерево ресурсов). Скрипт работает теперь с шаблонами. Шаблоны находятся в папке templates и начинаются с префикса node
- Причесаны стили кнопок. Говорят что выглядит дешево хотя я отталкивался от цветов MODXa:(Буду рад услышать вашу цветовую гамму.
- Добавлена фича для мобильных кнопок. Основная кнопка сохранения теперь является выпадающей. Выпадает по ховеру. На мобильных устройствах на кнопку необходимо кликнуть по «+ действие» для выбора поддействия и на галочку для повторного применения действия.
- В экшен добавления/редактирования ресурса добавлен мобильный вид кнопок. Теперь на мобильниках эти кнопки состоят только из иконок.
- Переписать большинство экшенов под работу в шаблонами.
- Распихать весь js и css по соответствующим файлам. Большую часть переписать на jQuery.
- Добавить фреймворк для элементов формы. Старые элементы оставить для совместимости со старыми версиями модулей.
- Добавить сетку для всех экшенов.
- Улучшить мобильный и планшетный виды.
- Поправить баги какие вы найдете.
UPD от 24/02
Причесал все фреймы. Раскидал стили и скрипты по файлам и папкам. Перенес файл генерации меню в папку инклюдов, так логичней. header.inc.php и footer.inc.php добавлены в основной пак и подгружаются из папки includes темы. По фреймам осталось только перевести их в шаблонный вид и с ними закончено, больше я их трогать не буду. Если только не потребуется ввести пару новых эвентов.
Добавил выпадающую кнопку во все экшены элементов. Появилась небольшая бага с воркером (нотификатор о состоянии работы в шапке) но на полноценную работу это не влияет.
Архив перезалит.
UPD от 01/03
Принято решение интегрировать фичу похожую на плагин TreeTabs в тему. Ну или сам TreeTabs, пока еще не решил. В качестве исходного парсера выбран QB ввиду легкости интеграции. При переносе всех наработок в ядро будет использован Twig. На этом пока все.
Следующий апдейт будет под версией 1.1 и будет содержать первые 2 экшена переписаные под шаблоны (mutate_content и mutate_settings) и новый внешний вид всех элементов форм. Дополнительно планируется добавить функционал сортировки табличных данных.
В этой статье рассмотрим такой элемент CMF MODX Revolution как шаблон.
Что такое шаблон?
Шаблон — это элемент MODX, представляющий собой заготовку, на основании которой может осуществляться вывод любого количества ресурсов. Для того чтобы шаблон использовался для вывода некоторого ресурса, он (шаблон) должен быть связан с ним (ресурсом).
Подключение шаблона к ресурсу осуществляется через поле «Шаблон».
После этого подключенный (выбранный) шаблон будет использоваться для вывода этого ресурса.
Понять назначение шаблона и то, как он связан с ресурсами очень просто, если представить шаблон домом, а ресурс человеком, живущим в этом доме. Дом, так же как и шаблон (страница) состоит из множества деталей (крыша — шапка страницы, стены – каркас страницы, основная часть фасада – основное содержимое страницы, подвал – нижняя часть страницы и т.д.).
Человек (ресурс) может иметь несколько домов (шаблонов), но жить в определённый момент способен только в одном из них. Через некоторое время, человек может переселиться жить в другой дом, это будет аналогичному тому, что ресурсу назначить другой шаблон.
Внимание: Каждый ресурс (страница) в MODX Revolution может использовать в качестве своего вывода только один шаблон. Т.е. MODX не разрешает для вывода ресурса одновременно использовать несколько шаблонов. Но в любое время ресурсу можно назначить другой шаблон.
Для этого необходимо на странице редактирования ресурса выбрать нужное значение из раскрывающего списка «Шаблон» и нажать на кнопку «Сохранить». После этого вывод ресурса уже будет осуществляться на основании указанного (другого) шаблона.
Где находятся шаблоны в админке?
В админке (менеджере) шаблоны находятся на левой панели во вкладке «Элементы».
Шаблоны состоят из полей: имя, описание, иконка, код шаблона (html) и др.
Основные поля шаблона — это имя и код шаблона (HTML). Имя — это название шаблона. Код шаблона — это его содержимое, на основании которого и будет осуществляться вывод ресурса. Код шаблона в большинстве случаев представляет собой обычную HTML-страницу с наличием в ней специальных тегов MODX (полей ресурса, TV-переменных, чанков, плейсхолдеров, ссылок, системных переменных, вызовов сниппетов).
Эти специальные теги и выполняют всю магию. Они выводят данные (значения любых полей) текущего ресурса, формируют динамическое меню страницы, а также любой другой контент, который может быть связан или нет с этим (текущим) ресурсом.
Создание шаблона
Создание шаблона в админке осуществляется посредством выполнения следующих шагов:
- Нажать на значок «+» напротив заголовка «Шаблоны».
- В поле имя ввести название шаблона (например, Шаблон1).
- В поле код шаблона (HTML) ввести необходимое содержимое.
Например: [[*pagetitle]]
[[*longtitle]]
Источник: maintorrent.ru
Массовое изменение отображения свойств в детальной карточке 1С-Битрикс
Столкнулся с задачей, когда на клиентском сайте более 500 пользовательских свойств в инфоблоке и необходимо было в настройках (параметры свойства) у всех включить «Показывать на детальной странице элемента».
Само собою, вручную тыкать в 500-1000 свойств и проставлять это свойство — не наш метод. И вот на помощь пришел метод setFeatures класса BitrixIblockModelPropertyFeature (само собою, плохо документированный в официальной документации).
В результате получился такой простенький php-скрипт:
Источник: xn--80ajr5b.com