Сниппет userPages

Выводит форму добавления / редактирования ресурса, подключает все необходимые скрипты и стили.

Примеры

Минимальный вызов:

[[!userPages]]

Fenom

{'!userPages' | snippet : []}

Работа с товаром miniShop3 в категории с id=15, модерацией ('published' => 0), cвоими чанками форм и адресами менеджеров:

{'!userPages' | snippet : [
    'class' => 'msProduct',
    'parent' => 15,
    'published' => 0,
    'tplCreateForm' => 'my_create_form',
    'tplEditForm' => 'my_edit_form',
    'emailManager' => 'manager1@gmail.com,manager2@gmail.com',
]}

Помимо этого можно указать любое предустанавливаемое значение для ресурса с учетом префикса.

Префиксы полей

Указание полей в вызове перекрывает данные из формы, то есть если указано &parent=`15`, а в форме есть поле с name="parent", то что-бы пользователь в нем не проставил, родителем будет ресурс с ID=15.

Если используете предуставноленные поля типа MIGX, то значения указывайте в JSON-формате:

[[
    ...
    &migx_chars=`[ [ { "title":"Высота","value":"1500"},{"title":"Ширина","value":"500"} ] ]`
    ...
]]

Сниппет upCheck

Сниппет используется в форме редактирования для вывода значений полей ресурса (выбранные селекты, отмеченные чекбоксы).

В комплекте идут чанки с примерами форм (поддерживается Fenom и стандартный синтаксис). В форме редактирования доступен плейсхолдер rid, который выводит ID редактируемого ресурса и его можно использовать для вывода значений полей через модификатор resource:

{$rid | resource : 'fieldname'}

Префиксы полей

Поле ресурса:

<input name="pagetitle" value="{$rid | resource : 'pagetitle'}" placeholder="{'up_pagetitle' | lexicon}">

Поле товара miniShop3:

<label>
    <input type="checkbox" name="ms_popular" value="1"> {'up_popular' | lexicon}
</label>

Селект производителей товаров miniShop3 (чанк up_vendor_option идёт в комплекте):

<select name="ms_vendor_id">
    {'pdoResources' | snippet : [
        'class' => 'MiniShop3\Model\msVendor',
        'sortby' => '{ "name":"ASC" }'
        'tpl' => 'up_vendor_option',
        'rid' => $rid
    ]}
</select>

Категории товара miniShop3 (чанк up_category_tpl идёт в комплекте):

<select name="ms_vendor_id">
    {'pdoResources' | snippet : [
        'parents' => 0,
        'where' => '{ "class_key:LIKE":"%Category%" }',
        'limit' => 0,
        'sortby' => '{ "pagetitle":"ASC" }'
        'tpl' => 'up_category_tpl'
        'rid' => $rid
    ]}
</select>

TV-параметр с именем instock:

<input name="tv_instock" value="{$rid | resource : 'instock'}">

У TV с типом image или file скрипт проверит источник файлов, создаст там директорию с ID нового ресурса и загрузит файлы в неё.

MIGX-параметры

Табличный виджет при загрузке проверяет что прописано у данного TV в названии и параметрах ввода (конфигурация MIGX или вкладки формы) и формирует соответствующую таблицу, в которой можно добавлять и удалять строки, перемещать их местами и т.д.

Пример вывода виджета для поля с именем chars (обратите внимание на id="migx_chars_widget" у контейнера и атрибуты name и id, а также плейсхолдер {$migx_chars} скрытого textarea):

<div id="migx_chars_widget" class="tablewidget"></div>
<textarea name="migx_chars" id="migx_chars" class="up-hidden">{$migx_chars}</textarea>

Поле с текстовым редактором

У контейнера должен быть data-field со значением, соответствующим name скрытого textarea:

<div class="up-richeditor" data-field="content"></div>
<textarea name="content" class="up-hidden">{$rid | resource : 'content'}</textarea>

Поля Dropzone

Виджет поддерживает мультизагрузку и изменение порядка файлов.

Для настройки виджета используются data-атрибуты у контейнера:

Например, есть TV-параметр file для файлов типа PDF,XLSX,DOCX и нужно ограничить количество файлов тремя, чтобы каждый весил не более 10МБ:

<div class="up-dropzone dropzone" data-field="tv_files" data-files="3" data-types=".pdf,.xlsx,.docx" data-size="10"></div>
<textarea name="tv_files" class="up-hidden">{$rid | resource : 'files'}</textarea>

Если для TV-поля указан источник файлов, отличный от Filesystem, то в форме редактирования для вывода существующего значения используйте сниппет upCheck без параметра value (он выведет чистые данные из базы):

<textarea name="tv_files" class="up-hidden">
    {'!upCheck' | snippet : ['rid' => $rid, 'field' => 'tv_files']}
</textarea>

Галерея товара miniShop3 с Dropzone и настройками по умолчанию (чанк up_gallery_tpl идёт в комплекте):

<div class="up-dropzone dropzone" data-field="ms_gallery"></div>
<textarea name="ms_gallery" class="up-hidden">{'!msGallery' | snippet : ['product' => $rid, 'tpl' => 'up_gallery_tpl']}</textarea>

Системные события для плагинов:

<?php
switch($modx->event->name){
    case 'upOnBeforeChangeResource':
        if(mb_strlen($data['tv_seotitle']) > 70){
            $data['error_message'] = 'Слишком длинный заголовок';
        }else{
            if(mb_stripos($data['tv_seotitle'], ', купить недорого') === false){
                $data['tv_seotitle'] = $data['tv_seotitle'].', купить недорого';
            }
        }
        $modx->event->returnedValues['data'] = $data;
    break;
}

<?php
switch($modx->event->name){
    case 'upOnAfterChangeResource':
        if($object){
            $content = preg_replace('/(?:https?|ftp):\/\/[^\s]+|www\.[^\s]+/', '[ссылка]', $object->get('content'));
            $object->set('content', $content);
            $object->save();
        }
    break;
}