Foren / National / Russian / Модули и плагины / Плагин "Files Uploader"

Плагин для загрузки изображений на сайт с их привязкой к странице

Uch
#37809 20. August 2013, 11:10

Скачать: http://www.cotonti.com/datas/users/filesup_220.rar

Плагин 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

<tr>
<td>{PAGEADD_FORM_FILESUP_TITLE}:</td>
<td>{PAGEADD_FORM_FILESUP}</td>
</tr>

5.Для запуска плагина при просмотре страницы отдельно или в списке можно использовать следующий код

для page.tpl:

<!-- IF {PAGE_FILESUP_ID_VALUE} -->
    <li><a href="#" onclick="window.open('filesup?fuid={PAGE_FILESUP_ID_VALUE}&pageid={PAGE_ID}','fu_window','{PHP.cfg.plugin.filesup.fu_winparams|str_replace('-','=',$this)}');return false;">FilesUp</a></li>
<!-- ELSE -->
    <li><a href="#" onclick="window.open('filesup?fuid={PHP|cot_unique(10)}&pageid={PAGE_ID}','fu_window','{PHP.cfg.plugin.filesup.fu_winparams|str_replace('-','=',$this)}');return false;">FilesUp</a></li>
<!-- ENDIF -->

для page.list.tpl:

<!-- IF {LIST_ROW_FILESUP_ID_VALUE} -->
    <a href="#" onclick="window.open('filesup?fuid={LIST_ROW_FILESUP_ID_VALUE}&pageid={LIST_ROW_ID}','fu_window','{PHP.cfg.plugin.filesup.fu_winparams|str_replace('-','=',$this)}');return false;">FilesUp</a>
<!-- ELSE -->
    <a href="#" onclick="window.open('filesup?fuid={PHP|cot_unique(10)}&pageid={LIST_ROW_ID}','fu_window','{PHP.cfg.plugin.filesup.fu_winparams|str_replace('-','=',$this)}');return false;">FilesUp</a>
<!-- ENDIF -->

где {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).

Скриншоты:
1. Начальная форма

01_220.jpg

2.Предзагрузка

02_220.jpg

3.Загруженные файлы

03_220.jpg