ManagerManager 0.6.2 Настройка внешнего вида панели управления сайтом

Новая установка

Данный плагин уже входит в установочный комплект MODx Evolution, поэтому, прежде чем его устанавливать, проверьте его наличие и версию в Элементы >> Управление элементами >> Плагины.

1. Скачайте последнюю версию ManagerManager

2. Разархивируйте скачанный файл.

3. В панели управления сайтом создайте новый плагин «ManagerManager», вставьте содержимое из файла plugin.txt.

4. Во вкладке "Системные события" отметьте события:

• OnDocFormRender
• OnDocFormPrerender
• OnBeforeDocFormSave
• OnDocFormSave
• OnDocDuplicate
• OnPluginFormRender
• OnTVFormRender

5. Во вкладке "Конфигурация" вставьте нижеприведённый код в поле "Конфигурация плагина:", и щёлкните "Обновить параметры":

&remove_deprecated_tv_types_pref=Remove deprecated TV types;list;yes,no;yes &config_chunk=Configuration Chunk;text;

6. Скопируйте все файлы из архива (кроме plugin.txt) на сайт (необходимая структура папок и файлов соблюдена в архиве, файлы плагина должны оказаться в /assets/plugins/managermanager)

7. Если вы хотите редактировать правила в панели управления сайтом, создайте чанк «mm_rules» (или с любым другим именем) и укажите его в параметре плагина «Configuration Chunk» (на вкладке «Конфигурация»). Если вы хотите редактировать правила в фале, редактируйте файл /assets/plugins/managermanager/mm_rules.inc.php. Внимание, параметр плагина «Configuration Chunk» должен быть пустым.

Внимание, необходимо отключить плагин «ShowImageTVs» (если он у вас есть) и использовать вместо него виджет mm_widget_showimagetvs

Обновление

Удалите все файлы из папки /assets/plugins/managermanager/ и сам плагин ManagerManager, затем установите заново, следуя вышеописанным инструкциям.

Виджеты

Все виджеты уже содержатся в архиве, ничего дополнительно устанавливать не нужно

Название полей

Названия вкладок

Названия секций

Ограничение ввода данных

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

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

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

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

mm_ddReadonly('myVar', '2');

mm_requireFields('pagetitle,pub_date');

Установка необходимых значений

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

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

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

mm_synch_fields('pagetitle,menutitle,longtitle');

Изменение названий и подсказок

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

mm_changeFieldHelp('alias', 'Это последний фрагмент адреса страницы', '3');

Расширение функционала ввода данных

mm_ddMultipleFields('employees', '', '', 'text,text,text', 'Имя,Телефон,Должность', '250,100,100', '||', '::', 300, 100, 2, 5);

mm_ddSelectDocuments();

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

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

Работа с секциями

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

mm_ddMoveFieldsToSection('profilePhoto', 'images');

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

mm_renameSection('content', 'Текстик (отображается на страничке)', '2');

Работа с вкладками

mm_createTab('SEO', 'seoTab', '', '3,4', '  Здесь вы можете отредактировать всё, что касается поисковой оптимизации. ', '450');

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

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

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

Карты

mm_ddGMap('LatLng');

mm_ddYMap('LngLat');

Прочее

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

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

mm_ddAutoFolders();

mm_ddFillMenuindex();

mm_widget_accessdenied('1,15', 'Этот документ запрещено редактировать. Давай, до свидания!' '2');

mm_ddHTMLCleaner();

С помощью ManagerManager вы можете изменять внешний вид страницы редактирования ресурса. Вы можете менять заголовки параметров ресурса, добавлять новые вкладки, скрывать секции и многое другое. Также вы можете расширять возможности ManagerManager добавляя свои собственные виджеты. ManagerManager работает исполняя правила, которые применяются к определённым областям страницы редактирования ресурса. Каждое правило может быть применено к определенной роли, определенному шаблону или любой их комбинации.

Для переименования параметра "Заголовок ресурса" для всех шаблонов и всех пользователей, вы можете использовать:

mm_renameField('pagetitle', 'Новый текст заголовка');

просто поместите это правило в чанк mm_demo_rules (или другой чанк, указанный в конфигурации плагина).

Вы можете применять правило для пользователей с конкретной ролью, указав третий параметр, который является идентификатором одной или нескольких ролей пользователей. Идентификатор роли вы можете найти на вкладке "Роли".

Чтобы применить приведенное выше правило только к роли с идентификатором "1", вы должны написать:

mm_renameField('pagetitle', 'Новый текст заголовка', '1');

Вы можете добавить несколько ролей, через запятую:

mm_renameField('pagetitle', 'Новый текст заголовка', '1,3,5');

Если вы хотите сделать правило "для всех кроме",то вы должны поставить перед списком ролей восклицательный знак "!". Например, чтобы применить правило для всех, кроме администраторов(идентификатор роли администратора "1"), вы должны написать:

mm_renameField('pagetitle', 'Новый текст заголовка', '!1');

Примечание: исключение применяется ко всем ролям.

mm_renameField('pagetitle', 'Новый текст заголовка', '!2,3');

Добавит правило к пользователям не входящим в роли с идентификаторами 2 или 3.

Наконец, если вы оставите параметр с идентификаторами ролей пустым, или пропустить его, правило будет применяться ко всем ролям.

Можно уточнять правила, ограничивая их применение для шаблонов с определенным идентификатором. Например:

mm_renameField('pagetitle', 'Новый текст заголовка', '', '3');

Добавит правило только к ресурсам использующим шаблон с идентификатором "3".

mm_renameField('pagetitle', 'Новый текст заголовка', '!1', '3');

Добавит правило к пользователям которые не принадлежат к роли с идентификатором "1", когда они редактируют ресурс использующий шаблон с идентификатором "3".

Вы можете использовать переменные PHP. Например, для сохранения идентификаторов шаблона и роли.

    $news_role = '3';
    $news_tpl = '10';
    mm_createTab('SEO','seoTab', '', $news_tpl, '', '600');
    mm_renameField('longtitle','Заголовок статьи', $news_role, $news_tpl, 'Это заголовок статьи');

Вы можете применять правило к ресурсам с определённым идентификатором.

    // скроет поле ресурса, если идентификатор родителя этого ресурса "28".
    if($content['parent'] == 28){
    mm_hideFields('tvname','2');
    }

Модуль 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`
]]