Главная / Документация / Полное руководство / Модули /

Файловый архив

Категории
Файлы в модуле
Настройки
Шаблонные теги
CSS-форматирование
Файлы

Модуль относится к части CMS «Контент» и может быть установлен опционально.

Модуль состоит из 2х частей: категории файлов и файлы.

Модуль «Файловый архив» можно прикреплять к различным страницам сайта. Если модуль прикреплен к нескольким страницам, в административной части модуля появляется специальный фильтр «Раздел сайта» с возможностью фильтрации вывода (списка файлов, категорий и настроек) по принадлежности к странице.

Категории

Категории файлов могут иметь неограниченное число подкатегорий. При необходимости категории можно не использовать. Для этого нужно отключить параметр «Использовать категории» в конфигурации модуля.

Если перед названием категории имеется знак +, то этой категории принадлежат подкатегории. Добавить подкатегорию к категории можно, нажав на знак рядом с названием категории.

Порядок отображения категорий можно менять с помощью мыши, просто перетаскивая их.

Кнопка служит для удаления категории. Кнопка служит для быстрой публикации категории (или, наоборот, блокирования). При удалении категории удаляются все вложенные подкатегории и файлы.

Категории имеют следующие характеристики.

Основные:

Название;
Показывать на сайте;

Показывать в меню – добавляет ссылку в меню согласно структуре сайта. Подробнее смотрите в разделе модуль «Меню на сайте»;

Анонс – краткое описание категории, для публикации в списке;
Описание – описание категории.

Дополнительные:

Номер – номер категории;
Время последнего изменения – выводится в заголовке Last modify;
Заголовок окна в браузере, тэг Title – если не заполнен, тег title будет автоматически сформирован из Названия категории - Названия страницы сайта - Названия сайта;
Ключевые слова, тэг Keywords – ключевые слова для мета-тега «keywords», используется для поисковой оптимизации;
Описание, тэг Description – описание для мета-тега «description», используется для поисковой оптимизации;
Псевдоссылка – ссылка на страницу категории будет генерироваться следующим образом: http://www.site.ru/псевдоссылка/. Если псевдоссылка не указана адрес страницы будет: http://www.site.ru/псевдоссылка_страницы/catНомер_категории/. При добавлении псевдоссылки к ней автоматически прикрепляется псевдоссылка страницы. При редактировании можно это исправить;
Вложенность: принадлежит – категория верхнего уровня;
Раздел сайта – принадлежность к странице сайта;
Сортировка: установить перед – редактирование порядка отображения пункта. Поле доступно для редактирования только для элементов, отображаемых на сайте;
Не показывать на карте сайта – скрывает отображение ссылки на категорию в файле sitemap.xml и модуле «Карта сайта».

Если в конфигурации модуля включен параметр «Показывать комментарии к категориям», то при редактировании категории будет отображена активная ссылка на комментарии к категории или надпись «Комментариев нет» при их отсутствии.

Файлы

Порядок отображения файлов можно менять с помощью мыши, просто перетаскивая их. Если подключены категории файлов, то сортировать файлы можно только в пределах категории (в фильтре «Категория» нужно выбрать категорию файлов). Кнопка служит для удаления файлов. Кнопка служит для быстрой публикации файлов (или, наоборот, блокирования).

Файлы имеют следующие характеристики.

Основные:

Название;
Файл – загружаемый файл. Доступные типы файлов изменяются в настройках модуля (параметр «Доступные типы файлов»). Можно указать ссылку для закачки файла из удаленного источника или ссылку на файл для скачивания;
Показывать на сайте – публикация на сайте, активность;
Изображения – возможность загрузки нескольких изображений, если в конфигурации модуля включен параметр «Использовать изображения». Изображение загружаются в двух вариантах: маленьком (предпросмотр) и большом (увеличенная версия). Также для отражения в административной части сайта генерируются дополнительные изображения (50х50, качество 70). Качество и размер загружаемых изображений для пользовательской части сайта указываются в настройках модуля;
Категория – помимо основной можно указать дополнительные категории;
Анонс – краткое описание файла;
Описание – полное описание файла.

Дополнительные:

Показывать в меню – добавляет ссылку в меню согласно структуре сайта. Подробнее смотрите в разделе модуль «Меню на сайте»;
Номер – номер файла;
Время последнего изменения – выводится в заголовке Last modify;
Заголовок окна в браузере, тэг Title – если не заполнен, тег title будет автоматически сформирован из Названия файла - Названия страницы сайта - Названия сайта;
Ключевые слова, тэг Keywords – ключевые слова для мета-тега «keywords», используется для поисковой оптимизации;
Описание, тэг Description – описание для мета-тега «description», используется для поисковой оптимизации;
Псевдоссылка – ссылка на страницу статьи будет генерироваться следующим образом: http://www.site.ru/псевдоссылка/. Если псевдоссылка не указана адрес страницы будет: http://www.site.ru/псевдоссылка_страницы/catНомер_категории/showНомер_файла/. При добавлении псевдоссылки к ней автоматически прикрепляется псевдоссылка страницы и категории файла. При редактировании можно это исправить;
Раздел сайта – принадлежность к странице сайта;

Сортировка: установить перед – редактирование порядка отображения пункта. Поле доступно для редактирования только для элементов, отображаемых на сайте;
Не показывать на карте сайта – скрывает отображение ссылки на файл в файле sitemap.xml.

Если в конфигурации модуля включен параметр «Показывать комментарии к файлам», то при редактировании файла будет отображена активная ссылка на комментарии к файлам или надпись «Комментариев нет» при их отсутствии.

Если в конфигурации модуля включен параметр «Показывать рейтинг файлов», то при редактировании файлов будет отображена активная ссылка на рейтинг файла с указанием среднего балла и количества голосов или надпись «Рейтинг: нет голосов», если голосов за файл нет.

Если в конфигурации модуля включен параметр «Подключить теги», то при редактировании файла появится возможность редактирования тегов, прикрепленных к файлу.

Настройки

Использовать категории – параметр позволяет включить/отключить категории файлов.

Количество файлов на странице – количество одновременно выводимых файлов в списке файлов.

Количество файлов в списке категорий – количество файлов, выводимых в списке категорий на главной странице модуля.

Показывать файлы подкатегорий – позволяет показывать в категории верхнего уровня не только файлы, принадлежащие текущей категории, но и файлы подкатегорий, принадлежащих данной категории.

Использовать изображения – параметр позволяет включить/отключить загрузку изображений к файлам.

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

Размер маленького изображения – размер изображения предпросмотра.

Отображение изображений в списке файлов – параметр принимает значения:

нет (отключает отображение изображений в списке);
показывать одно изображение;
показывать все изображения.

Использовать изображения для категории – параметр позволяет включить/отключить загрузку изображений для категорий.

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

Размер маленького изображения для категории – размер изображения предпросмотра.

Отображение изображений категорий в списке категорий – параметр принимает значения:

нет (отключает отображение изображений в списке);
показывать одно изображение;
показывать все изображения.

Использовать анимацию при увеличении изображений – параметр добавляет JavaScript код, позволяющий включить анимацию при увеличении изображений.

Максимальный размер загружаемых файлов – параметр показывает максимально допустимый размер загружаемых файлов, установленный в настройках хостинга.

Накладывать водяной знак – параметр позволяет включить/отключить наложение водяного знака на изображение.

Расположение водяного знак – расположение водяного знака в пикселях от левого края или от центра и от нижнего края или от центра.

Использовать водяной знак только для большого изображения – отключает наложение водяного знака на изображение предпросмотра.

Применить настройки ко всем ранее загруженным изображениям – позволяет переконвертировать размер уже загруженных изображений. Размер вновь созданных изображений не может быть больше размера большой копии уже загруженного изображения.

Показывать комментарии к файлам – подключение модуля «Комментарии» к файлам. Параметр не будет включен, если модуль «Комментарии» не установлен. Подробности см. в разделе «Модуль Комментарии».

Показывать комментарии к категориям файлов – подключение модуля «Комментарии» к категориям файлов. Параметр не будет включен, если модуль «Комментарии» не установлен. Подробности см. в разделе «Модуль Комментарии».

Показывать теги файлов – подключение модуля «Теги» к файлам. Параметр не будет включен, если модуль «Теги» не установлен. Подробности см. в разделе «Модуль Теги».

Показывать рейтинг файлов – подключение модуля «Рейтинг» к файлам. Параметр не будет включен, если модуль «Рейтинг» не установлен. Подробности см. в разделе «Модуль Рейтинг»

Доступные типы файлов (через запятую)

Пример: doc, gif, jpg, mpg, pdf, png, txt, zip

Шаблонные теги

Для работы с модулем "Файловый архив" служат следующие шаблонные теги:

show_block – выводит несколько файлов из файлового архива.

Атрибуты:

— count – количество выводимых файлов (по умолчанию 3);

— site_id – страница, к которой прикреплен модуль, по умолчанию выбирается одна страница;

— cat_id – категория файлов (id категории, по умолчанию выводятся все файлы без учета категории), если в конфигурации модуля отмечено «Использовать категории»;

— images – количество фотографий, прикрепленных к файлам;

— sort – сортировка файлов (rand – в случайном порядке, date – по дате). По умолчанию файлы сортируются по дате;

— template – шаблон тега (функция в файле modules/files/files.view.php должна называться show_block_template; по умолчанию шаблон show_block).

Пример: <insert name="show_block" module="files">

выведет 3 последние файла из файлового архива

Шаблон: функция show_block в файле modules/files/files.view.php.

CSS-форматирование

Общие стили:

.files_name{} – название файлов

.files_anons{} – краткое описание файла

.files_text{} – полное описание файла

.files_img{} – изображение, прикрепленное к файлу

.files_all_img{} – все изображения, прикрепленные к файлу

Список файлов:

.files_list{} – список файлов

.files_list .files{} – файл в списке

.files_list .files_name{} – название файла в списке

.files_list .files_img{} – изображения файла в списке

.files_list .files_anons{} – краткое описание файла в списке

.files_list .files_cat_anons{} – краткое описание категории файлов

.files_list .files_cat_text{} – полное описание категории файлов

.files_list .files_cat_img{} – изображение, прикрепленное к категории файлов

.files_list .files_cat_all_img{} – все изображения, прикрепленные к категории файлов

.files_list .files_cat_link{} – ссылка на вложенную категорию файлов

.files_list .show_all{} – ссылка на все файлы в категории

.files_list .previous_next_links{} – ссылки на предыдущую, следующую категории

.files_list .previous_link{} – ссылка на предыдущую категорию

.files_list .next_link{} – ссылка на следующую категорию

Страница файла:

.files_id{} – страница файла

.files_id .files_size{} – размер прикрепленного файла

.files_id .files_download{} – ссылка на скачивание прикрепленного файла

.files_id .files_text{} – краткое описание файла

.files_id .files_text{} – полное описание файла

.files_id .files_all_img{} – все изображения

.files_id .previous_next_links{} – ссылки на предыдущий, следующий файлы

.files_id .previous_link{} – ссылка на предыдущий файл

.files_id .next_link{} – ссылка на следующий файл

Шаблонная функция show_block:

.files_block{} – шаблонная функция show_block

.files_block h2{} – заголовок

.files_block .files{} – файл в блоке

.files_block .files_img{} – изображение файла

.files_block .files_name{} – название файла

.files_block .files_anons{} – краткое описание файла

.files_block .show_all{} – ссылка на все файлы

Файлы

Модуль находится в папке /modules/files/ и устроен классически.

modules/files/files.php – контроллер модуля;
modules/files/files.model.php – вывод файлов и разделов каталога в пользовательской части сайта;
modules/files/files.view.php – шаблон вывода в пользовательской части сайта;
modules/files/files.sitemap.php – карта сайта модуля для файла sitemap.xml;
modules/files/files.install.php – установка модуля;
modules/files/admin/files.admin.php – редактирование фалов;
modules/files/admin/files.admin.menu.php – формирование списка файлов и категорий файлов в административной части модуля «Меню».
modules/files/admin/files.admin.category.php – редактирование категорий файлов;
modules/files/admin/files.admin.config.php – конфигурация модуля.

Не понятно? Уточните