Віджети

Синтаксис: mm_ddMaxLength($fields, $roles, $templates, $length)

Опис параметрів:

Приклад: Підключення віджету для TV «Slogan», обмеживши кількість символів до 140

mm_ddMaxLength('Slogan', '', '', 140);

Синтаксис: mm_ddNumericFields($tvs, $roles, $templates, $allowFloat, $decimals)

Опис параметрів:

Приклад: Зробити можливим ввід тільки цифр з точністю у 2 знаки після коми в TV «price» для шаблонів з id, рівним 15 або 16 і всіх ролей

mm_ddNumericFields('price', '', '15,16', 1, 2);

Синтаксис: mm_hideTemplates($tplIds, $roles, $templates)

Опис параметрів:

Приклад: Приховати шаблони з id = 0 і 4 зі списку у всіх документах для користувачів з id ролі = 1

mm_hideTemplates('0,4', '1');

Синтаксис: mm_hideFields($fields, $roles, $templates)

Опис параметрів:

Приклад: Приховати поле «псевдонім» у документів з id шаблону = 3 для користувачів з id ролі = 1

mm_hideFields('alias', '1', '3');

Синтаксис: mm_ddReadonly($fields, $roles, $templates)

Опис параметрів: Значення відображаються при редагуванні, але їх неможливо змінити.

Інколи бувають випадки, коли ми зберігаємо якусь інформацію про документ в його TV (наприклад, кількість переглядів або завантажувань, рейтинг і т.д.). Така інформація обновляється автоматично (будь-який сніпет/плагін просто зберігає значення в TV відповідного документу). І ось Петро раптом вирішив відредагувати текст документу: відкрив, почав писати, його відволікли по роботі, потім зателефонували, потім терміново довелося поїхати, дві години їздив, повернувся, продовжив редагувати. Весь цей час документ у нього був відкритий, дані про кількість завантажень вже 100 разів встигли змінитися (було 3, а стало 33), але у Петра до цього часу відображається 3. Петро закінчив свою роботу, натискає «Зберегти» і… кількість завантажень перезаписується на 3! Неприємна ситуація. Що можна зробити? Варіант 1: можна зробити якусь суперсистемну групу і виставити її для тих TV, значення яких не повинно редагуватися користувачами. Непоганий варіант, але не надійний (може знайтись хтось, хто поставить собі цю групу й обов'язково щось зіпсує) і не підходить, якщо хочеться бачити ці дані при редагуванні документа. Саме для таких випадків і призначений цей віджет.

Робота віджета ділиться на 3 частини:

Перед збереженням документу (OnBeforeDocFormSave) виходять і запам'ятовуються актуальні значення необхідних полів (із бази).

Після збереження (OnDocFormSave) записуються назад.

JS робить поля візуально не редагованими.

Приклад: Зробити поле TV «myVar» доступним тільки для читання для користувачів з id ролі = 2

mm_ddReadonly('myVar', '2');

Синтаксис: mm_requireFields($fields, $roles, $templates)

Опис параметрів: Додає зірочку червоного кольору близько з іменем обов'язкового для заповнення поля, видає повідомлення при спробі зберігання не заповнюючи обов'язкові поля, запобігаючи збереження.

Приклад: Зробити обов'язковим для заповнення заголовків і дат публікації всіх документів

mm_requireFields('pagetitle,pub_date');

Синтаксис: mm_inherit($fields, $roles, $templates)

Опис параметрів:

Приклад: Виставити всім новим документам заголовок як у батьківського для користувачів з id роллю = 0 або 1

mm_inherit('pagetitle', '0,1');

Синтаксис: mm_default($fields, $value, $roles, $templates, $eval)

Опис параметрів: Зараз TV задаються як «tvN», де N – id TV.

Приклад: Автоматично виставити дату скасування публікації через 4 неділі від поточної для документів з id шаблону = 4

mm_default('unpub_date', 'return date("d-m-Y H:i:s", now()+(60*60*24*28));', '', '4', true);

Синтаксис: mm_ddSetFieldValue($fields, $value, $roles, $templates)

Опис параметрів: Схожий на mm_default, але виставляє завжди.

Приклад: У документів з шаблонами id = 1 і 3 виставити значення TV «someTv» в 'this is some' для редагування (роль з id = 2)

mm_ddSetFieldValue('someTv', 'this is some', '2', '1,3');

Синтаксис: mm_synch_fields($fields, $roles, $templates)

Опис параметрів: Наприклад: щоб заголовок і пункт меню документу були однаковими, – особливо зручно, коли одне із полів приховано. Працює тільки з текстовими полями (input, textarea).

Приклад: Зробити значення цих полів завжди однаковими (для всіх користувачів і документів)

mm_synch_fields('pagetitle,menutitle,longtitle');

Синтаксис: mm_renameField($fields, $newlabel, $roles, $templates, $newhelp)

Опис параметрів:

Приклад: Перейменувати поле «заголовок» у документів з id шаблона = 3 для всіх користувачів

mm_renameField('longtitle', 'ФИО', '', '3');

Синтаксис: mm_changeFieldHelp($field, $helptext, $roles, $templates)

Опис параметрів:

Приклад: Змінити підказку для поля «псевдонім» у всіх документів для користувачів з id ролі = 3

mm_changeFieldHelp('alias', 'Це останній фрагмент адреси сторінки', '3');

Синтаксис: mm_ddMultipleFields($tvs, $roles, $templates, $columns, $columnsTitle, $templates, $colWidth, $splY, $splX, $imgW, $imgH, $minRow, $maxRow, $columnsData)

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

Додавання до одного документу довільної кількості зображень, текстових полів, списків (з можливістю вибору значення).

Завдання декількох колонок різних типів (або однакових), наприклад: зображень і підписів до них (приклад «coloumns»).

Вивід заголовків колонок (приклад «coloumnsTitle»).

Кількість значень (рядків) може бути як фіксованим, динамічним, так і у визначених діапазонах (приклади «minRow» і «maxRow»).

Сортування (перетягування) рядків між собою.

Генерація унікального ідентифікатора кожної стрічки рядка (приклад «coloumns»).

Вивід зумовлених списків значень (приклади «coloumns» і «coloumnsData»). Увага, це зараз в беті!

Для виводу даних використовується сніпет ddGetMultipleField.

Приклад: Можливість додавання контактів співробітників, але не більше 5 і не менше 2, з різними розмірами колонок (для текстової tv «employees»)

mm_ddMultipleFields('employees', '', '', 'text,text,text', 'Ім'я, Телефон, Посада', '250,100,100', '||', '::', 300, 100, 2, 5);

Синтаксис: mm_ddSelectDocuments($tvs, $roles, $templates, $parentIds, $depth, $filter, $max, $labelMask)

Опис параметрів:

Приклад:

mm_ddSelectDocuments();

Синтаксис: mm_widget_tags($fields, $delimiter, $source, $display_count, $roles, $templates)

Опис параметрів: Для потрібного TV автоматично формується «список» вибору зі всіма тегами, при цьому, нові теги просто вписуються через розділювач також тут) на сторінці редагування документа. TV повинен бути текстового типу.

Приклад: Зробити для TV «docTags» віджет тегів з відображенням кількості документів, які використовують кожен тег близько з ним у документів з id шаблона = 2 для всіх ролей

mm_widget_tags('docTags', ',', '', '1', '', '2');

Синтаксис: mm_widget_colors($fields, $default, $roles, $templates)

Опис параметрів: Обраний колір зберігається в TV в hex форматі. TV повинен бути текстового типу.

Приклад: Додати палітру вибору кольорів для TV «bgcolor» у документах з id шаблона = 2 для користувачів з id ролі = 1 і виставити чорний колір за замовчуванням

mm_widget_colors('bgcolor', '#000000', '1', '2');

Синтаксис: mm_ddCreateSection($title, $id, $tabId, $roles, $templates)

Опис параметрів:

Приклад: Створити секцію з заголовком «Категорії» в основній вкладці у всіх документах для всіх користувачів

mm_ddCreateSection('Категорії', 'mycats');

Синтаксис: mm_ddMoveFieldsToSection($fields, $sectionId, $roles, $templates)

Опис параметрів: На жаль, неможливо перемістити наступні поля: keywords, metatags, which_editor, show_in_menu, menuindex.

Приклад: Перемістити TV «profilePhoto» в секцію «images» для всіх користувачів і шаблонів

mm_ddMoveFieldsToSection('profilePhoto', 'images');

Синтаксис: mm_hideSections($sections, $roles, $templates)

Опис параметрів: «Секції» – це такі області на сторінці редагування документа, наприклад: «Вміст ресурсу» або «Параметри (TV)».

Приклад: Приховати секції «Вміст ресурсу» і «Параметри (TV)» у документів з id шаблону = 3 для користувачів з id ролі = 1

mm_hideSections('content,tvs', '1', '3');

Синтаксис: mm_renameSection($section, $newlabel, $roles, $templates)

Опис параметрів: «Секції» – це такі області на сторінці редагування документа, наприклад: «Вміст ресурсу» або «Параметри (TV)».

Приклад: Перейменувати секцію контенту документа для користувачів з id ролі = 2

mm_renameSection('content', 'Текстик (відображається на сторінці)', '2');

Синтаксис: mm_createTab($name, $id, $roles, $templates, $intro, $width)

Опис параметрів:

Приклад: Створити нову вкладку шириною 450px з описом у документах з id шаблона = 3 або 4

mm_createTab('SEO', 'seoTab', '', '3,4', '  Тут ви можете відредагувати все, що стосується пошукової оптимізації. ', '450');

Синтаксис: mm_moveFieldsToTab($fields, $tabId, $roles, $templates)

Опис параметрів: На жаль, неможливо перемістити наступні поля: keywords, metatags, which_editor, show_in_menu, menuindex.

Приклад: Перемістити дату публікації документа в основну вкладку для користувачів з id ролі = 2

mm_moveFieldsToTab('pub_date', 'general', '2');

Синтаксис: mm_hideTabs($tabs, $roles, $templates)

Опис параметрів:

Приклад: Приховати вкладку «Права доступу» у документів з id шаблона = 3 для користувачів з id ролі = 1

mm_hideTabs('access', '1', '3');

Синтаксис: mm_renameTab($tab, $newlabel, $roles, $templates)

Опис параметрів:

Приклад: Перейменувати вкладку «Спільні» для користувачів з id ролі = 2

mm_renameTab('general', 'Основні', '2');

Синтаксис: mm_ddGMap($tvs, $roles, $templates, $w, $h, $hideField)

Опис параметрів: Початкова позиція карти задається дуже просто: достатньо вказати необхідні координати в якості «значення за замовчуванням» відповідно TV.

Приклад: Підключення віджету Google Maps для TV «LatLng»

mm_ddGMap('LatLng');

Синтаксис: mm_ddYMap($tvs, $roles, $templates, $w, $h, $hideField)

Опис параметрів: Для простого виводу карти на сторінку використовуйте сніпет ddYMap. Початкова позиція карти задається дуже просто: достатньо вказати необхідні координати в якості «значення за замовчуванням» відповідно TV.

Приклад: Підключення віджету Yandex Maps для TV «LngLat»

mm_ddYMap('LngLat');

Синтаксис: mm_widget_showimagetvs($fields, $maxWidth, $maxHeight, $thumbnailerUrl, $roles, $templates)

Опис параметрів: Аналогічний плагіну ShowImageTVs, який не сумісний з ManagerManager.

Приклад: Показати прев'ю для TV «mypic» у документів з id шаблона = 2 і відправити й на генерацію в phpThumb для отримання прев'юшок розміром 300×200 px

mm_widget_showimagetvs('mypic', '300', '200', '/assets/snippets/phpthumb/phpThumb.php', '', '2');

Синтаксис: mm_ddResizeImage($tvs, $roles, $templates, $width, $height, $cropping, $suffix, $replaceFieldVal, $background, $multipleField, $colNum, $splY, $splX, $num, $allowEnlargement)

Опис параметрів: Віджет спрацьовує тільки в момент збереження документів (подія «OnBeforeDocFormSave») і не створює зображень повторно, що забезпечує мінімальний розхід ресурсів сервера.

Приклад: Створити для зображень, виставлених в TV «imageTV», зменшені копії, перезаписуючи значення в TV

mm_ddResizeImage('imageTV', '', '', 200, 100, 'crop_resized', '_ddthumb', 1);

Синтаксис: mm_ddAutoFolders($roles, $templates, $yearsParents, $dateSource, $yearFields, $monthFields, $yearPublished, $monthPublished, $numericMonth)

Опис параметрів:

Приклад:

mm_ddAutoFolders();

Синтаксис: mm_ddFillMenuindex($parent)

Опис параметрів: За замовчуванням позиція меню в MODx для нових документів просто рівна кількості дочірніх документів на одному рівні, що не завжди зручно.

Приклад:

mm_ddFillMenuindex();

Синтаксис: mm_widget_accessdenied($ids, $default, $roles)

Опис параметрів: Наприклад, в батьківському документі викликається сніпет «Ditto», і ви не хочете, щоб користувачі редагували цей документ, але хочете, щоб користувачі могли створювати та редагувати дочірні документи.

Використовуйте цей віджет з обережністю, тому що він не забезпечує такого захисту, як встановлена система прав MODx. Користувач, який володіє технічними знаннями може обійти цей захист через інструменти для розробки в браузері.

Приклад: Заборонити доступ до документів з id = 1 і 15 користувачам з id ролі = 2 і відобразити вихідне повідомлення про заборону доступу

mm_widget_accessdenied('1,15', 'Цей документ заборонено редагувати. Давай, до побачення!' '2');

Синтаксис: mm_ddHTMLCleaner($fields, $roles, $templates, $validAttrsForAllTags, $validStyles, $validAttrs)

Опис параметрів:

Приклад:

mm_ddHTMLCleaner();