Плагин FilesUp предназначен для загрузки изображений на сайт с привязкой к определенной странице и дальнейшего их использования в тексте этой страницы и в качестве ее аватаров.
Для своей работы плагин использует:
1.модуль Page: загружаемые изображения привязаны к определенной странице,
2.модуль PFS для учета загруженных изображений и опционно формирования их миникартинок,
3.плагин CKEditor для вставки изображений в текст редактируемой страницы.
Для выбора и загрузки изображений используется HTML5 форма с мультивыборкой файлов.
Плагин позволяет:
1. Загрузить и привязать к странице на стадии ее создания/редактирования/просмотра (отдельно и в списке) произвольное количество изображений, снабдив их описанием и другими опциями (о которых будет рассказано ниже), а также при необходимости уменьшив их размеры в процессе закачки на сайт.
2. На стадии создания и редактирования страницы плагин предоставляет пользователю возможность включить загруженные изображения или их миникартинки в текст страницы.
3. С помощью глобальной функции из состава плагина можно использовать более одного загруженного для страницы изображения в качестве аватара, что, например, позволит создать слайдер или фото-галерею.
4. При загрузке изображений на сайт, создать в структуре Файлового архива полноценную папку (возможно публичную галерею).
При загрузке изображений на сайт и при дальнейшем управлении ими, кроме функций удаления изображения и изменения его описания, пользователю так же доступны следующие опции:
1. Указание миникартинки, как активной, что позволит, например, использовать ее, как ссылку на полномасштабное изображение.
2. Указание иображения, как аватар, что позволит выводить ее или ее миникартинку, как аватар страницы.
2.1. В качестве аватара страницы может быть использовано несколько изображений. Показом аватаров можно управлять с помощью файлов скина: редактируя существующий или создавая новые. Вывод аватаров осуществляется с помощью глобальной функции get_avatars(page_id, tpl_file), где page_id - индекс страницы, а tpl_file - имя файла скина, через который осуществляется показ аватаров.
При формировании миникартинки могут быть использованны соответствующие настройки Файлового архива или собственные настройки плагина.
Установка:
1.Скопировать папку filesup в дирректорию plugins своего сайта.
2.В разделе Расширения Административной панели сайта установить плагин Files Uploader.
3.При необходимости изменить настройки плагина.
4.Внести следующие строки в файлы modules/page/tpl/page.add.tpl и modules/page/tpl/page.edit.tpl
XML/XHTML
1
2
3
4
<tr>
<td>{PAGEADD_FORM_FILESUP_TITLE}:</td>
<td>{PAGEADD_FORM_FILESUP}</td>
</tr>
5.Для запуска плагина при просмотре страницы отдельно или в списке можно использовать следующий код
где {PAGE_FILESUP_ID_VALUE} и {LIST_ROW_FILESUP_ID_VALUE} - тэг, соответствующий экстраполю filesup_id таблицы страниц, а {PAGE_ID} и {LIST_ROW_ID} - тэг содержащий уникальный ID страницы.
6. Для вывода аватара или нескольких аватаров страницы необходимо использовать вызов глобальной функции из соответствующих tpl-файлов с помощью кода:
{PAGE_ID|get_avatars($this)} или {LIST_ROW_ID|get_avatars($this)} - для вывода аватаров в списке страниц.
7. Для изменения внешнего вида плагина отредактируйте файлы filesup.tpl и filesup.css, расположенные в папке tpl плагина, по своему усмотрению.
8. Для управления выводом аватаров отредактируйте filesup.avatars.tpl или создайте любой другой tpl-файл для передачи в функцию get_avatars(page_id, tpl_file).
