[FileAttach] Загрузка файлов на сайт во frontend

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

Для демонстрации возможностей вы можете ознакомиться из примера, скачав по ссылке. Распакуйте архив на сайте, задайте права группе пользователя и авторизуйтесь на сайте.

Обращение к функциях дополнения производится через соединитель (connector), которому в аргументах задается параметр, указывающий на нужную функцию (processor). Результат работы возвращается в формате JSON, потому для удобства обработки результатов вам потребуется реализовать обвязку на Javascript.

Предполагается, что во frontend пользователь будет в основном выполнять выгрузку файлов на сервер, при этом для управления используя три функции:

• выгрузка файлов на сервер
• скачивание файлов с сервера
• получение списка присоединенных файлов к заданному ресурсу
• удаление присоединенных файлов у заданного ресурса

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

Пример вызова получения списка присоединенных файлов:
Через метод GET обращаемся по адресу: mysite.ru/assets/components/fileattach/connector.php?action=web/getlist&ctx=web&docid=100

Здесь параметры означают:

• action = вызов процессора web/getlist
• ctx = выполнение в контексте web
• docid = у ресурса с идентификатором 100

Выгрузка файлов
Выполняется запросом методом POST к процессору mgr/upload с типом кодирования формы multipart/form-data. Параметрами надо указать ctx, docid, file.
Процессор ответит в формате JSON, сообщив о результате и списке принятых файлов:
{«success»:true,«total»:«1»,«results»:[{«id»:37,«fid»:«pPSVL79cTgCSkU5yoArcPBkNPfbsCLq1»,«name»:«price.xls»}]}

Необходимый набор разрешений:
Во-первых нужно предоставить доступ для медиа-источника с разрешением на «create». Затем надо включить разрешение на «file_upload» из шаблона AdminTemplate. Соответствующие политики назначьте группе пользователя для контекста web или того, который используется на лицевой части сайта.

Скачивание файлов
Выполняется запросом к процессору web/download. Параметрами надо указать ctx, fid (строковой идентификатор записи файла).

Необходимый набор разрешений:
Для скачивания надо разрешить «fileattach.download».
Есть две политики, которыми можно разрешить скачивание, первая это «File Attach Download» предназначенная только для скачивания, и «File Attach Frontend» для разрешения работы во frontend.
Назначьте одну из них для группы пользователя в контексте web.

Список файлов
Выполняется запросом к процессору web/getlist. Параметрами надо указать ctx, docid.
Процессор ответит в формате JSON, сообщив о результате и списке файлов:
{«success»:true,«total»:«1»,«results»:[{«id»:38,«name»:«servicing.xlsx»,«fid»:«pPSVL79cTgCSkU5yoArcPBkNPfbsCLq1»,«hash»:«a24c27a4edd12c9809a7f948c0322d8aa14f68c8»}]}

Удаление файлов
Выполняется запросом к процессору web/remove. Параметрами надо указать ctx, docid, список идентификаторов файлов ids в формате JSON.

Необходимый набор разрешений:
Для доступа к удалению надо разрешить «fileattach.remove».
При этом допускается удаление своих файлов, соответствующих указанному ресурсу. Чтобы позволить удалять не только свои файлы надо включить так же и «fileattach.totallist».

$item->rename($item->get('name'));

$item->remove();

$success = $this->source->uploadObjectsToContainer(
$this->getProperty('path'),
	array(array( // emulate a $_FILES object
		"name" => &$this->filename, ....

$fileitem->set('name', $file['name']);
$fileitem->set('internal_name', $this->filename);

$itemArr['url'] = $public_url . $itemArr['path'] . $itemArr['internal_name'];

// Определяем дополнительную опцию
$showDate = $modx->getOption('showDate', $scriptProperties, false);
// Перед сбросом данных в чанк определяем дату файла
if ($showDate) $itemArr['filedate'] = filectime($item->getFullPath());

{"success":false,"message":"\u0414\u043e\u0441\u0442\u0443\u043f \u0437\u0430\u043f\u0440\u0435\u0449\u0451\u043d.","total":0,"data":[],"object":{"code":401}}

{if <файлы есть>}
<ul>
        [[FileAttach?
         &tpl=`custom.FileAttachTpl`
         &showSize=`true`
         &privateUrl=`1`]]
</ul>
{else}
<p>У ресурса нет прикрепленных файлов</p>
{/if}

/html/core/xpdo/om/xpdoobject.class.php : 811) FileItem: Attempt to set NOT NULL field hash to NULL

{'!FileAttach' | snippet:[
'resource'=>$id,
'groups'=>'Users',
'privateUrl'=>true,
'showHASH'=>true,
'showSize'=>true
]}