5. Аватар страницы

Модуль поддерживает возможность прикрепление аватаров к страницам. Для использования возможности загрузки аватаров с помощью fileAPI вам необходимо вставить соответствующие теги в tpl фалах.

Формы добавления аватара к странице

файл page.add.tpl

Вставляем форму загрузки аватара страницы:

<!-- IF {PHP|cot_module_active('fileAPI')} -->
{PHP|fileAPI_form('prepare:1,area:page_avatar, preset:page_avatar')} 
<!-- ENDIF -->	

Указав параметр prepare:1 мы подготавливаем данные для загрузки файлов к еще не существующим объектам. В данном случае к несуществующей странице.

файл page.edit.tpl

Вставляем форму загрузки/редактирования аватара страницы.

<!-- IF {PHP|cot_module_active('fileAPI')} -->
{PHP|fileAPI_form('area:page_avatar, cat:$pag.page_cat, indf:$id, preset:page_avatar')} 
<!-- ENDIF -->	

Вывод аватара страницы

файл page.tpl

{PAGE_FILEAPI_AVATAR}

Можно выводить аватар страницы и в списке.

файл page.list.tpl

Добавляем вывод аватара каждой страницы. Необходимо вставить в секции LIST_ROW.

<!-- BEGIN: LIST_ROW -->
...
{LIST_ROW_FILEAPI_AVATAR}
...
<!-- END: LIST_ROW -->

Тег вывода аватара страницы работает во всех частях сайта, где используется встроенная функция генерации тегов для страницы. Это может быть плагин Pagelist или уже новая функция в Cotonti 0.9.19 cot_page_enum().

Данные хранятся в экстраполе, с именем fileapi_avatar. Соответственно понять какой тег вставить в том или ином случае будет понятно исходя из правил вызова экстраполей. В данной случае это добавление постфикса FILEAPI_AVATAR.

Исходя из тегов выше: {LIST_ROW_FILEAPI_AVATAR}

Дополнительные превью

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

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

Пример:

Вы добавили дополнительное превью для аватара с именем small. Тогда тег для вывода дополнительного превью аватара в файле page.tpl станет таким:

{PAGE_FILEAPI_AVATAR_SMALL}

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

{основной тег_ имя превью} - {PAGE_FILEAPI_AVATAR**_SMALL**}

Также по аналогии и с тегом для списков: {LIST_ROW_FILEAPI_AVATAR**_SMALL**}