ManagerManager: Дополнительно

Модуль ddMMEditor

Модуль для удобного редактирования файла конфигурации плагина ManagerManager.

Возможности:

• визуальное создание правил для MM;
• применение правил к необходимым шаблонам и ролям в два клика;
• autocomplete со всеми именами полей и TV;
• объединение правил в группы по смыслу (группы можно называть произвольными именами);
• сворачивание-разворачивание групп для удобного просмотра в общем виде;
• drag'n'drop правил и групп между собой;
• возможность «ручной» вставки произвольного кода в начало и конец конфигурационного файла.

Установка

Содержимое файла module.php должно быть скопировано в поле «Код модуля» в меню создания нового модуля. Остальные файлы должны находиться в assets/modules/ddmmeditor/... (в архиве уже создана нужная структура папок). Модуль изменяет файл assets/plugins/managermanager/mm_rules.inc.php плагина ManagerManager.

Внимание! Чтобы ManagerManager использовал правила, созданные модулем, параметр «Configuration Chunk» в конфигурации плагина (вкладка «Конфигурация») должен быть пустым.

Сниппет ddGetMultipleField

Сниппет для вывода данных, разделённых через определённые разделители. Удобно использовать для вывода значений полей документов, сформированных виджетом mm_ddMultipleFields. Возможности:

• Получение необходимого поля документа (и TV) по id. Параметры «docField» и «docId».
• Вывод необходимого количества значений по номерам строк и и значениям. Параметры «startRow», «totalRows» и «filter».
• Вывод необходимых значений по номерам колонок. Параметр «columns».
• Сортировка строк по значениям колонок перед выводом ('ASC', 'DESC', 'RAND', 'REVERSE'), в том числе множественная сортировка. Параметры «sortDir» и «sortBy».
• Вывод значений через разделители строк и колонок. Параметры «rowGlue» и «colGlue».
• Удаление пустых значений колонок и строк перед выводом. Параметры «removeEmptyRows» и «removeEmptyCols».
• Типографирование значений перед выводом (используется сниппет ddTypograph). Параметр «typography».
• URL-кодирование результата перед выводом. Параметр «urlencode».
• Вывод результата в JSON. Параметр «outputFormat».
• Вывод значений по шаблонам (чанкам) строк и колонок (в шаблоне строк также доступен плэйсхолдер [+rowNumber+] с номером строки). Параметры «rowTpl» и «colTpl».
• Вывод результата выполнения в чанк «outerTpl» с передачей дополнительных данных через параметр «placeholders»

Внимание! Из пары параметров «string»/«docField» необходимо передавать лишь один.

Примеры

Вывод изображений с описаниями

Исходная строка (пусть находится в TV документа «images»):

/assets/images/some_img1.jpg::Изображение 1||/assets/images/some_img2.jpg::Изображение 2

Вызов сниппета в шаблоне документа:

[[ddGetMultipleField?
&string=`[*images*]`
&rowTpl=`imgRow`
]]

Код чанка «imgRow»:

[+col1+]:
<img src="[+col0+]" alt="[+col1+]" />

Получение и вывод данных из поля (TV) «prices» документа с id = 25 в виде таблицы, если что-то есть и ничего, если нету

Исходное значение поля:

Яблоки вкусные::100::кг||Гвозди обыкновенные::5 000::центнер||Коты::865::шт

Вызов сниппета (где угодно):

[[ddGetMultipleField?
&docField=`prices`
&docId=`25`
&rowTpl=`pricesRow`
&outerTpl=`pricesWrap`
]]

Код чанка «pricesRow»:

<tr>
	<td>[+rowNumber+]</td>
	<td>[+col0+]</td>
	<td>[+col1+] руб./[+val2+]</td>
</tr>

Код чанка «pricesWrap»:

<h1>Табличка цен</h1>
<table>
	[+result+]
</table>

Вывод тегов документа через запятую с использованием регулярного выражения в «rowDelimiter»

Пусть теги документа у нас хранятся в TV «tags» и к этой TV у нас применён виджет mm_widget_tags. Пользователь заполняет теги через запятую, при этом, может заполняться как с пробелами по краям, так и без них.

Значение TV «tags»:

Коты, Кошки,Собаки , Медведи ,Слоны

Вызов сниппета в шаблоне документа:

[[ddGetMultipleField?
&string=`[*tags*]`
&rowDelimiter=`/\s*,\s*/`
&rowGlue=`, `
&rowTpl=`tagsRow`
]]

Код чанка «tagsRow»:

<a href="[~[*parent*]~]?tags=[+col0+]">[+col0+]</a>

Результат:

<a href="[~[*parent*]~]?tags=Коты">Коты</a>,
<a href="[~[*parent*]~]?tags=Кошки">Кошки</a>,
<a href="[~[*parent*]~]?tags=Собаки">Собаки</a>,
<a href="[~[*parent*]~]?tags=Медведи">Медведи</a>,
<a href="[~[*parent*]~]?tags=Слоны">Слоны</a>

Сниппет ddTypograph

Сниппет типографирует текст. Не использует сторонних сервисов, не отправляет никаких запросов, всё делается прямо у вас на сервере.

Примеры

Типографирование аннотации перед выводом

[[ddTypograph? &text=`[*introtext*]`]]

Типографирование аннотации с автоматической расстановкой абзацев, ссылок и адресов email

[[ddTypograph? &text=`[*introtext*]` &text_paragraphs=`1` &text_autoLinks=`1`]]

Типографирование аннотации с автоматическим оптическим выравниванием (висячие кавычки и пр.)

[[ddTypograph? &text=`[*introtext*]` &optAlign=`1`]]

Сниппет ddYMap

Сниппет для вывода на страницу Яндекс.Карт в простом виде.

Удобно использовать совместно с виджетом mm_ddYMap.

Внимание! На странице уже должен быть подключен jQuery.

Из пары параметров «geoPos» / «docField» необходимо передавать лишь один.

Сниппет можно вызывать в любом месте страницы, место его вызова не имеет значения.

Примеры

[[ddYMap? &geoPos=`55.177446326764496,61.29041790962219`]]