Додатково

ManagerManager: Додатково

Доповнення плагіну 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`]]