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

• Файлы
• Категории
• Статистика
• Настройки
• Шаблонные теги

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

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

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

Файлы

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

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

Основные:

• Файлы – Загружаемые файлы. Доступные типы файлов %attachment_extensions изменяются в настройках модуля (параметр «Доступные типы файлов»). Можно указать ссылку для закачки файла из удаленного источника или ссылку на файл для скачивания.
• Название – Используется в ссылках на файл, заголовках. Параметр имеет разные значения для разных языковых версий сайта.
• Опубликовать на сайте – Если не отмечена, файл не будет отображаться на сайте. Параметр имеет разные значения для разных языковых версий сайта.
• Изображения – Изображения будут загружены автоматически после выбора. После загрузки изображения будут обработаны автоматически, согласно настройкам модуля. Параметр выводится, если в настройках модуля отмечена опция «Использовать изображения».
• Похожие файлы – Выбор и добавление к текущему файлу связей с другими файлами. Похожие файлы выводятся шаблонным тегом show_block_rel. По умолчанию связи между файлами являются односторонними, это можно изменить, отметив опцию «В блоке похожих файлов связь двусторонняя» в настройках модуля.
• Категория – Категория, к которой относится файл. Список категорий редактируется во вкладке выше. Возможно выбрать дополнительные категории, в которых файл также будет выводится. Чтобы выбрать несколько категорий, удерживайте CTRL. Параметр выводится, если в настройках модуля отмечена опция «Использовать категории».
• Теги – Добавление тегов к файлу. Можно добавить либо новый тег, либо открыть и выбрать из уже существующих тегов. Параметр выводится, если в настройках модуля включен параметр «Подключить теги».
• Раздел сайта – Перенос файла на другую страницу сайта, к которой прикреплен модуль. Параметр выводится, если в настройках модуля отключена опция «Использовать категории», если опция подключена, то раздел сайта задается такой же, как у основной категории.
• Счетчик просмотров – Количество просмотров на сайте текущей файла. Статистика ведется и параметр выводится, если в настройках модуля отмечена опция «Подключить счетчик просмотров».
• Комментарии – Комментарии, которые оставили пользователи к текущему файлу. Параметр выводится, если в настройках модуля включен параметр «Показывать комментарии к файлам».
• Рейтинг – Средний рейтинг, согласно голосованию пользователей сайта. Параметр выводится, если в настройках модуля включен параметр «Подключить рейтинг к файлам».
• Динамические блоки.
• Анонс – Краткое описание файла. Выводится в списке файлов и в блоках. Если отметить «Добавлять к описанию», на странице файла анонс выведется вместе с основным описанием. Иначе анонс выведется только в списке, а на отдельной странице будет только описание. Если отметить «Применить типограф», контент будет отформатирован согласно правилам экранной типографики с помощью веб-сервиса «Типограф». Опция «HTML-код» позволяет отключить визуальный редактор для текущего поля. Значение этой настройки будет учитываться и при последующем редактировании. Параметр имеет разные значения для разных языковых версий сайта.
• Описание – Полное описание для страницы файла. Если отметить «Применить типограф», контент будет отформатирован согласно правилам экранной типографики с помощью веб-сервиса «Типограф». Опция «HTML-код» позволяет отключить визуальный редактор для текущего поля. Значение этой настройки будет учитываться и при последующем редактировании. Параметр имеет разные значения для разных языковых версий сайта.
• Индексирование для поиска – Файл автоматически индексируется для модуля «Поиск по сайту» при внесении изменений.
• Индексирование для карты сайта – Файл автоматически индексируется для карты сайта sitemap.xml.

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

• Номер – Номер элемента в БД (веб-мастеру и программисту).
• Заголовок окна в браузере, тег Title – Если не заполнен, тег Title будет автоматически сформирован как «Название файла – Название страницы – Название сайта», либо согласно шаблонам автоформирования из настроек модуля (SEO-специалисту). Параметр имеет разные значения для разных языковых версий сайта.
• Ключевые слова, тег Keywords – Если не заполнен, тег Keywords будет автоматически сформирован согласно шаблонам автоформирования из настроек модуля (SEO-специалисту). Параметр имеет разные значения для разных языковых версий сайта.
• Описание, тег Description – Если не заполнен, тег Description будет автоматически сформирован согласно шаблонам автоформирования из настроек модуля (SEO-специалисту). Параметр имеет разные значения для разных языковых версий сайта.
• Канонический тег – Параметр имеет разные значения для разных языковых версий сайта.
• Псевдоссылка – ЧПУ (человеко-понятные урл url), адрес страницы вида: https://site.ru/psewdossylka/. Смотрите параметры сайта.
• Редирект на текущую страницу со страницы – Позволяет делать редирект с указанной страницы на текущую.
• Changefreq – Вероятная частота изменения этой страницы. Это значение используется для генерирования файла sitemap.xml. Подробнее читайте в описании XML-формата файла Sitemap (SEO-специалисту).
• Priority – Приоритетность URL относительно других URL на Вашем сайте. Это значение используется для генерирования файла sitemap.xml. Подробнее читайте в описании XML-формата файла Sitemap (SEO-специалисту).
• Доступ – Если отметить опцию «Доступ только», файл увидят только авторизованные на сайте пользователи, отмеченных типов. Не авторизованные, в том числе поисковые роботы, увидят «404 Страница не найдена» (администратору сайта).
• Период показа – Если заполнить, текущий файл будет опубликована на сайте в указанный период. В иное время пользователи сайта файл не будут видеть, получая ошибку 404 «Страница не найдена» (администратору сайта).
• Сортировка: установить перед – Изменить положение текущего файла среди других файлов. Поле доступно для редактирования только для файлов, отображаемых на сайте (администратору сайта).
• Не показывать на карте сайта – Скрывает отображение ссылки на файл в файле sitemap.xml и модуле «Карта сайта».
• Шаблон страницы – Возможность подключить для страницы файла шаблон сайта отличный от основного (themes/site.php). Все шаблоны для сайта должны храниться в папке themes с расширением .php (например, themes/dizain_so_slajdom.php). (веб-мастеру и программисту, не меняйте этот параметр, если не уверены в результате!).
• Шаблон модуля – Шаблон вывода контента модуля на странице отдельного файла (веб-мастеру и программисту, не меняйте этот параметр, если не уверены в результате!).
• Редактор – Изменяется после первого сохранения. Показывает, кто из администраторов сайта первый правил текущую страницу.
• Время последнего изменения – Изменяется после сохранения элемента. Отдается в заголовке Last Modify.

Категории

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

При удалении категории удаляются все вложенные подкатегории и файлы.

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

Основные:

• Название – Используется в ссылках на категорию, заголовках. Параметр имеет разные значения для разных языковых версий сайта.
• Опубликовать на сайте – Если не отмечена, категорию не увидят посетители сайта. Параметр имеет разные значения для разных языковых версий сайта.
• Создать пункт в меню – Если отметить, в модуле «Меню на сайте» будет создан пункт со ссылкой на текущую категорию.
• Изображения – Возможность загрузки нескольких изображений. Варианты размера загружаемых изображений определяются в настройках. Параметр выводится, если в настройках модуля отмечена опция «Использовать изображения для категорий».
• Комментарии – Комментарии, которые оставили пользователи к текущей категории. Параметр выводится, если в настройках модуля включен параметр «Показывать комментарии к категориям».
• Рейтинг – Средний рейтинг, согласно голосованию пользователей сайта. Параметр выводится, если в настройках модуля включен параметр «Подключить рейтинг к категориям».
• Динамические блоки.
• Анонс – Краткое описание категории. Если отметить «Добавлять к описанию», на странице элемента анонс выведется вместе с основным описанием. Иначе анонс выведется только в списке, а на отдельной странице будет только описание. Если отметить «Применить типограф», контент будет отформатирован согласно правилам экранной типографики с помощью веб-сервиса «Типограф». Опция «HTML-код» позволяет отключить визуальный редактор для текущего поля. Значение этой настройки будет учитываться и при последующем редактировании. Параметр имеет разные значения для разных языковых версий сайта.
• Описание – Если отметить «Применить типограф», контент будет отформатирован согласно правилам экранной типографики с помощью веб-сервиса «Типограф». Опция «HTML-код» позволяет отключить визуальный редактор для текущего поля. Значение этой настройки будет учитываться и при последующем редактировании. Параметр имеет разные значения для разных языковых версий сайта.
• Индексирование для поиска – Категория автоматически индексируется для модуля «Поиск по сайту» при внесении изменений.
• Индексирование для карты сайта – Категория автоматически индексируется для карты сайта sitemap.xml.

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

• Номер – Номер элемента в БД (веб-мастеру и программисту).
• Заголовок окна в браузере, тег Title – Если не заполнен, тег Title будет автоматически сформирован как «Название категории – Название страницы – Название сайта», либо согласно шаблонам автоформирования из настроек модуля (SEO-специалисту). Параметр имеет разные значения для разных языковых версий сайта.
• Ключевые слова, тег Keywords – Если не заполнен, тег Keywords будет автоматически сформирован согласно шаблонам автоформирования из настроек модуля (SEO-специалисту). Параметр имеет разные значения для разных языковых версий сайта.
• Описание, тег Description – Если не заполнен, тег Description будет автоматически сформирован согласно шаблонам автоформирования из настроек модуля (SEO-специалисту). Параметр имеет разные значения для разных языковых версий сайта.
• Канонический тег – Параметр имеет разные значения для разных языковых версий сайта.
• Псевдоссылка – ЧПУ, т.е. адрес страницы вида: https://site.ru/psewdossylka/. Смотрите параметры сайта (SEO-специалисту).
• Редирект на текущую страницу со страницы – Позволяет делать редирект с указанной страницы на текущую.
• Changefreq – Вероятная частота изменения этой страницы. Это значение используется для генерирования файла sitemap.xml. Подробнее читайте в описании XML-формата файла Sitemap (SEO-специалисту).
• Priority – Приоритетность URL относительно других URL на Вашем сайте. Это значение используется для генерирования файла sitemap.xml. Подробнее читайте в описании XML-формата файла Sitemap (SEO-специалисту).
• Раздел сайта – Перенос категории на другую страницу сайта, к которой прикреплен модуль (администратору сайта).
• Вложенность: принадлежит – Перемещение текущей категории и всех её подкатегорий в принадлежность другой категории (администратору сайта).
• Сортировка: установить перед – Редактирование порядка следования категории в списке. Поле доступно для редактирования только для категорий, отображаемых на сайте.
• Не показывать на карте сайта – Скрывает отображение ссылки на категорию в файле sitemap.xml и модуле «Карта сайта».
• Доступ – Если отметить опцию «Доступ только», категорию увидят только авторизованные на сайте пользователи, отмеченных типов. Не авторизованные, в том числе поисковые роботы, увидят «404 Страница не найдена» (администратору сайта).
• Шаблон страницы – Возможность подключить для страницы категории шаблон сайта отличный от основного (themes/site.php). Все шаблоны для сайта должны храниться в папке themes с расширением .php (например, themes/dizain_so_slajdom.php). (веб-мастеру и программисту, не меняйте этот параметр, если не уверены в результате!).
• Шаблон модуля – Шаблон вывода контента модуля на странице списка файлов в категории (веб-мастеру и программисту, не меняйте этот параметр, если не уверены в результате!).
• Шаблон модуля для вложенных файлов – Шаблон вывода контента модуля на странице отдельного файла, вложенного в текущую категорию (веб-мастеру и программисту, не меняйте этот параметр, если не уверены в результате!).
• Редактор – Изменяется после первого сохранения. Показывает, кто из администраторов сайта первый правил текущую страницу.
• Время последнего изменения – Изменяется после сохранения элемента. Отдается в заголовке Last Modify.

Статистика

Настройки

• Количество файлов на странице – Количество одновременно выводимых файлов в списке.
• Количество категорий на странице – Количество одновременно выводимых категорий в списке на первой страницы модуля. Параметр появляется, если отмечена опция «Использовать категории».
• Доступные типы файлов (через запятую).

  Пример:

  doc, gif, jpg, mpg, pdf, png, txt, zip
• Использовать категории – Позволяет включить/отключить категории файлов.
• Количество файлов в списке категорий – Количество файлов, выводимых в списке категорий на главной странице модуля. Параметр появляется, если отмечена опция «Использовать категории».
• Количество файлов в списке вложенной категории – Для первой страницы модуля и для страницы категории. Параметр появляется, если отмечена опция «Использовать категории».
• Показывать файлы подкатегорий – Если отмечена, в списке файлов категории будут отображатся файлы из всех вложенных категорий. Параметр появляется, если отмечена опция «Использовать категории».
• Использовать изображения – Позволяет включить/отключить загрузку изображений к файлам.
• Генерировать размеры изображений – Размеры изображений, заданные в модуле «Изображения» и тег латинскими буквами для подключения изображения на сайте. Обязательно должны быть заданы два размера: превью изображения в списке файлов (тег medium) и полное изображение (тег large).
• Отображение изображений в списке – Параметр принимает значения:
  • нет (отключает отображение изображений в списке);
  • показывать одно изображение;
  • показывать все изображения. Параметр выводится, если отмечена опция «Использовать изображения».
• Использовать изображения для категорий – Позволяет включить/отключить загрузку изображений к категориям.
• Генерировать размеры изображений для категорий – Размеры изображений, заданные в модуле «Изображения» и тег латинскими буквами для подключения изображения на сайте. Обязательно должны быть заданы два размера: превью изображения в списке категорий (тег medium) и полное изображение (тег large). Параметр выводится, если отмечена опция «Использовать изображения для категорий».
• Отображение изображений в списке категорий – Параметр принимает значения:
  • нет (отключает отображение изображений в списке);
  • показывать одно изображение;
  • показывать все изображения. Параметр выводится, если отмечена опция «Использовать изображения для категорий».
• Использовать анимацию при увеличении изображений – Параметр добавляет JavaScript код, позволяющий включить анимацию при увеличении изображений. Параметр выводится, если отмечена опция «Использовать изображения».
• Максимальный размер загружаемых файлов – Параметр показывает максимально допустимый размер загружаемых файлов, установленный в настройках хостинга. Параметр выводится, если отмечена опция «Использовать изображения».
• Применить настройки ко всем ранее загруженным изображениям – Позволяет переконвертировать размер уже загруженных изображений. Кнопка необходима, если изменены настройки размеров изображений. Параметр выводится, если отмечена опция «Использовать изображения».
• Счетчик просмотров – Позволяет считать количество просмотров отдельного файла.
• Выводить счетчик на сайте – Позволяет вывести на сайте количество просмотров отдельного файла. Параметр выводится, если отмечена опция «Счетчик просмотров». Параметр появляется, если отмечена опция «Счетчик просмотров».
• Показывать комментарии к файлам – Подключение модуля «Комментарии». Параметр не будет включен, если модуль «Комментарии» не установлен.
• Показывать комментарии к категориям – Подключение модуля «Комментарии» к категориям файлов. Параметр не будет включен, если модуль «Комментарии» не установлен.
• Показывать теги файлов – Подключение модуля «Теги». Параметр не будет включен, если модуль «Теги» не установлен.
• Показывать рейтинг файлов – Подключение модуля «Рейтинг». Параметр не будет включен, если модуль «Рейтинг» не установлен.
• Подключить рейтинг к категориям – Подключение модуля «Рейтинг» к категориям. Параметр не будет включен, если модуль «Рейтинг» не установлен.
• Подключить перелинковку – Отображение перелинковки в модуле.
• В блоке похожих файлов связь двусторонняя – Позволяет установленную в файле связь с другим файлом использовать в двух направлениях.
• Шаблон для автоматического генерирования Title – Если шаблон задан и для файла не прописан заголовок Title, то заголовок автоматически генерируется по шаблону. В шаблон можно добавить:
  • %name – название,
  • %category – название категории,
  • %parent_category – название категории верхнего уровня (SEO-специалисту).
  Параметр имеет разные значения для разных языковых версий сайта.
• Шаблон для автоматического генерирования Title для категории – Если шаблон задан и для категории не прописан заголовок Title, то заголовок автоматически генерируется по шаблону. В шаблон можно добавить:
  • %name – название категории,

  • %parent – название категории верхнего уровня,

  • %page – страница (текст можно поменять в интерфейсе «Языки сайта» – «Перевод интерфейса») (SEO-специалисту).

  Параметр имеет разные значения для разных языковых версий сайта. Параметр появляется, если отмечена опция «Использовать категории».
• Шаблон для автоматического генерирования Keywords – Если шаблон задан и для файла не заполнено поле Keywords, то поле Keywords автоматически генерируется по шаблону. В шаблон можно добавить:
  • %name – название,
  • %category – название категории,
  • %parent_category – название категории верхнего уровня (SEO-специалисту).
  Параметр имеет разные значения для разных языковых версий сайта.
• Шаблон для автоматического генерирования Keywords для категории – Если шаблон задан и для категории не заполнено поле Keywords, то поле Keywords автоматически генерируется по шаблону. В шаблон можно добавить:
  • %name – название категории,
  • %parent – название категории верхнего уровня (SEO-специалисту).
  Параметр имеет разные значения для разных языковых версий сайта. Параметр появляется, если отмечена опция «Использовать категории».
• Шаблон для автоматического генерирования Description – Если шаблон задан и для файла не заполнено поле Description, то поле Description автоматически генерируется по шаблону. В шаблон можно добавить:
  • %name – название,
  • %category – название категории,
  • %parent_category – название категории верхнего уровня (SEO-специалисту).
  Параметр имеет разные значения для разных языковых версий сайта.
• Шаблон для автоматического генерирования Description для категории – Если шаблон задан и для категории не заполнено поле Description, то поле Description автоматически генерируется по шаблону. В шаблон можно добавить:
  • %name – название категории,
  • %parent – название категории верхнего уровня (SEO-специалисту).
  Параметр имеет разные значения для разных языковых версий сайта. Параметр появляется, если отмечена опция «Использовать категории».
• Шаблон для списка элементов – По умолчанию modules/files/views/files.view.list.php. Параметр для разработчиков! Не устанавливайте, если не уверены в результате.
• Шаблон для первой страницы модуля (если подключены категории) – По умолчанию modules/files/views/files.view.fitst_page.php. Параметр для разработчиков! Не устанавливайте, если не уверены в результате.
• Шаблон для страницы элемента – По умолчанию, modules/files/views/files.view.id.php. Параметр для разработчиков! Не устанавливайте, если не уверены в результате.
• Отдельный пункт в меню администрирования для каждого раздела сайта – Если модуль подключен к нескольким страницам сайта, отметка данного параметра выведет несколько пунктов в меню административной части для удобства быстрого доступа (администратору сайта).
• Индексирование для карты сайта – При изменении настроек, влияющих на отображение страницы, модуль автоматически переиндексируется для карты сайта sitemap.xml.

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

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

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

Атрибуты:

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

— site_id – страницы, к которым прикреплен модуль. Идентификаторы страниц перечисляются через запятую. Можно указать отрицательное значение, тогда будут исключены файлы из указанного раздела. Можно указать значение current, тогда будут показаны файлы из по текущей (открытой) категории или из всех категорий, если ни одна категория не открыта. По умолчанию выбираются все страницы;

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

— sort – сортировка файлов: по умолчанию как на странице модуля, rand – в случайном порядке, date – по дате;

— images – количество изображений, прикрепленных к файлу;

— images_variation – тег размера изображений, задается в настроках модуля;

— only_module – выводить блок только на странице, к которой прикреплен модуль «Файловый архив»: true – выводить блок только на странице модуля, по умолчанию блок будет выводиться на всех страницах;

— tag – тег, прикрепленный к файлам;

— template – шаблон тега (файл modules/files/views/files.view.show_block_template.php; по умолчанию шаблон modules/files/views/files.view.show_block.php).

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].

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

Атрибуты:

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

— images – количество изображений, прикрепленных к файлу;

— images_variation – тег размера изображений, задается в настроках модуля;

— template – шаблон тега (файл modules/files/views/files.view.show_block_rel_template.php; по умолчанию шаблон modules/files/views/files.view.show_block_rel.php).

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].