Два почти одинаковых модуля — «Файл в базе» и «Файл на диске» — описаны вместе. Их отличие в основном в месте хранения файла — на диске веб-сервера или в базе данных. По возможности старайтесь использовать «Файл на диске» — страницы сайта будут быстрее грузиться.
Это один из многогранных модулей, который может служить для различных целей и иметь различный внешний вид. Суть модуля модуля заключается в том, что на сервер присылаются файлы, которые хранятся на нём вместе с дополнительными полями (название, описание и пр.) и могут отображаться посетителю различным образом.
Типы файлов могут быть такими:
- Картинка
- Flash
- Flash-видео
- Документ
Кроме того, для нескольких типов файлов, кроме основного файла, создаётся или загружается вручную маленькая картинка-превьюшка.
С помощью функции «Файл» вы можете отображать предварительно загруженные на сервер файлы (графические, текстовые и пр.). Существует несколько вариантов отображения загруженных файлов, которые настраиваются выбором обработчика. Возможны следующие варианты отображения загруженных файлов:
Фотоальбом (с голосованием и без) — Таким образом могут отображаться графические файлы, загруженные на сервер. Несколько изображений представляются в виде фотоальбома — картинок предпросмотра, нажав на которые пользователь может просматривать изображения настоящего размера. К данной функции возможно подключение голосования, в котором пользователь выбирает понравившееся ему картинки и голосует за них. Кроме картинок, в фотоальбоме (модуль «Файл на диске») могут выводится видеофильмы. В качестве превьюшки показывается присланная картинка, а в подробном просмотре можно посмотреть присланный в формате FLV фильм через встроенный в страницу плеер.
Баннер — Отображаемый графический файл представляется в виде рекламного баннера, нажав на который пользователь переходит к указанной редактором сайта странице. Надо заметить, что статистика по количеству показов баннеров и нажатий на них не ведется. Для получения расширенной статистики по баннерам воспользуйтесь функцией «Баннеры с ротацией».
Список документов — Список документов, присланных на сервер в виде ссылок на скачивание с описаниями.
Кроме того, присланные на сервер файлы в модуле «Файл на диске» можно использовать в тексте для подстановок. Все выражения для подстановок в текст выглядят так:
^[прописная латинская буква][№ объекта типа «Файл на диске»]. Выражение пишется слитно. Например: ^V38651. То есть, в выражении для подстановки из таблицы, слова «№ объекта» заменяются конкретным числом — номером требующегося объекта функции «Файл на диске».
| Выражение в тексте | Что отображается вместо него на сайте | Примечания |
|---|---|---|
| ^P№ | Картинка-превьюшка. Ссылка с неё ведёт на просмотр в новом окне полноразмерной картинки. | Для файла картинки. |
| ^I№ | Полноразмерная картинка. | Для файла картинки. |
| ^F№ | Flash-ролик. | Для файла Flash. |
| ^V№ | Видео-плеер для просмотра видео-файла. | Для файла видео типа FLV. |
| ^M№ | Аудио-плеер для прослушивания аудио-файла. | Для файла типа MP3. |
Таблица объектов типа «Файл»
Интерфейс управления объектами функции «Файл» показан на иллюстрации №27. Отличия от базовой таблицы объектов:
Над таблицей появилась новая иконка:
, предназначенная для загрузки на сервер сразу группы файлов.Над таблицей появилась новая ссылка «Загрузить из папки», предназначенная для групповой загрузки или замены файлов на диске файлами, предварительно присланными на сервер по FTP в папку “Temp”.
В самой таблице, столбец «Параметры». Новая иконка и число перед ней: 2
— интерфейс для загрузки дочернего фотоальбома, который виден при подробном просмотре выбранного объекта. Число перед иконкой — количество дочерних картинок.В самой таблице, столбец «Параметры». Новая иконка и два числа перед ней: 0 / 2
— интерфейс для управления отзывами по объекту. Первое число — количество запрещённых к показу сообщений, второе — число разрешённых к показу сообщений.Колонка с большой буквой P в заголовке — содержит превьюшки для объектов. Сама буква P в заголовке является ссылкой на включение / выключение показа данной колонки.
Колонка «Размер» — размер файла в килобайтах. Верхняя строка — сам файл, нижняя — превью.
Колонка «Имя исходное / Имя новое / Тип файла»
- Имя исходное — имя, с которым файл был прислан на сервер.
- Имя новое — имя, которое дала система файлу при записи на диск сервера.
Загрузка файлов на сервер
Для отображения файлов системой управления контентом сначала их необходимо загрузить на сервер. Для этого используется форма загрузки файла на сервер, к которой вы можете перейти следующими способами:
Перейдя к списку файлов, прикреплённых к функции, расположенной на нужной вам странице и нажав на иконку
или — для вставки сразу нескольких файлов.Перейдя в раздел «Типы объектов» (нажав на соответствующую ссылку в верхней части менеджерского интерфейса), выбрав просмотр всех объектов типа «Файл» нажатием на иконку
напротив соответствующего названия объекта и нажав после этого на иконку в правом окне менеджерского интерфейса.После открытия формы добавления файла выберите тип загружаемого вами файла. В зависимости от этого откроются различные формы. Форма для загрузки одной картинки показана на иллюстрации №28, а для загрузки сразу 10 картинок — на иллюстрации №29.
Типы файлов могут быть такими:
- Картинка
- Flash
- Flash-видео
- Документ
Выбор присылаемого типа файлов осуществляется через ссылки-закладки в верхней части формы.
В форме загрузки файла на сервер вам необходимо заполнить следующие поля (список полей, в зависимости от типа файла, может отличаться):
Название картинки — Название документа, под которым будет храниться загружаемый файл (здесь вы можете написать любое ассоциирующееся с содержимым файла название). Если загружаемый вами файл отображается как картинка, то введённое вами название будет использовано в качестве alt’а. Заполнение данного поля является желательным.
Описание — В этом поле вы можете указать дополнительное описание загружаемого файла. Оно может выводиться или не выводиться во фронт-офисе в зависимости от вёрстки сайта.
Публиковать — В том случае, если эта опция включена, этот файл разрешён к показу (и показывается) во фронт-офисе.
Пометить как «горячий» — Если эта опция включена, объект будет отображаться всеми функциями файла на сайте, для которых настроено отображение горячих объектов вне зависимости от того, прикреплён ли к ним данный файл, или нет.
Имя файла и preview (только «Файл на диске») — Задаёт, сохранять ли исходное имя файла при записи на сервер, или создать уникальное по номеру объекта. Внимание! Очень желательно создание уникального имени файла по номеру объекта. Использование уникального имени допустимо в редких случаях.
Ссылка — Если в этом поле вы указываете адрес ссылки (URL), то при нажатии на отображаемый файл (объект) во фронт-офисе будет совершён переход на указанную страницу (во фронт-офисе данный объект будет являться ссылкой). Замечание: для создания ссылки на страницу «внутри» сайта в данном поле необходимо указать только номер (rid) страницы.
Открывать ссылку в новом окне — Если эта опция включена, то страница, на которую сделана ссылка, заданная в поле «Ссылка», открывается в новом окне.
Ширина preview — Размер по горизонтали в пикселях для автоматически создаваемого preview.
Высота preview — Размер по вертикали в пикселях для автоматически создаваемого preview.
Качество preview — Качество создаваемого автоматически preview-файла (только для формата JPEG) в градации от 0 до 100. 0 — наихудшее качество и минимальный размер preview-файла, 100 — наилучшее качество и максимальный размер preview-файла.
Сохранение пропорций preview — Если «галочка» установлена, то при создании preview-файла та из сторон, которая больше, будет приведена к размеру, указанному выше, а вторая изменена так, чтобы изображение не искажалось. В противном случае и ширина, и высота будут изменены согласно размерам, указанным выше.
Создать preview — В этом поле вы можете задать тип и при необходимости загрузить файл, содержащий картинку предварительного просмотра (“preview”, уменьшенную копию оригинала картинки). В том случае, если загружаемый вами графический файл имеет формат JPEG, то возможно автоматическое создание preview.
Файл предназначен — Назначение присылаемой картинки. Оставлено для совместимости.
Загружаемый файл — Это поле является обязательным к заполнению. В нём необходимо указать адрес (место расположения) загружаемого файла на вашем компьютере.
Артикул — Используется при использовании данного модуля в качестве простого каталога товаров (как артикул товара), и если на вашем сайте используется связывание объектов по артикулу.
Прикрепление к рубрикатору — Этот селектор позволяет выбрать метод прикрепления файла (создаваемого объекта) к функциям.
Для добавления файла и его загрузки нажмите на кнопку «Добавить». Для закрытия формы добавления файла без сохранения нажмите на кнопку «Отмена».
Редактирование и удаление объектов функции «Файл» доступно при нажатии на иконку 
рядом с записью соответствующего объекта функции «Файл». В открывшейся форме вы можете изменить любой из описанных выше параметров, указать, что необходимо загрузить новый preview-файл и/или новый оригинал файла.
Настройки функции «Файл»
Для настройки функции «Файл» необходимо нажать на иконку опций 
, расположенную рядом с названием функции (также вы можете найти эту иконку и на странице просмотра объектов функции). После нажатия, в открывшемся окне, вы можете изменить установленные параметры (напоминаем, что для всех функций параметры разные).
Для функции типа «Файл» возможна настройка следующих опций (остальные опции предназначены для программиста, и их изменение нежелательно):
| previewQuality | Устанавливает качество preview от 0 (низкое) до 100 (высокое). |
|---|---|
| previewWidth | Ширина создаваемого preview в пикселях (px). |
| previewHeight | Высота создаваемого preview в пикселях (px). |
| previewRatio | Устанавливает сохранение пропорций исходной картинки при создании preview. При установке данной опции в Да из заданных размеров preview остается тот, который соответствует наибольшему размеру исходной картинки. Оставшийся размер preview изменяется в соответствии с пропорцией исходной картинки. |
| newWin | Открывать ли подробный просмотр объекта в новом окне. Возможные варианты: Да — подробный просмотр в новом окне. Нет — подробный просмотр в том же окне. |
| XTable | Для фотоальбома — число картинок в строке (по горизонтали). Оставлено для совместимости. Сейчас в фотоальбоме используется строчно-блоковая вёрстка, так что этот параметр никак не влияет на отображение preview в фотоальбоме. |
| YTable | Для фотоальбома — число строк картинок (картинок по вертикали). Оставлено для совместимости. Сейчас в фотоальбоме используется строчно-блоковая вёрстка, так что этот параметр никак не влияет на отображение preview в фотоальбоме. |
| redirRid | Номер рубрики, в которую будет сделано перенаправление (redirect) для подробного просмотра выбранного объекта. |
| newWinParam | Параметры открытия нового окна для подробного просмотра. Применяется, если опция newWin содержит значение Да. |
| whatShow | Опция действует только для обработчиков «Рекламный баннер» и «Фотоальбом». N = XTable * YTable — количество объектов на странице.
Только для фотоальбома:
|
| navigatorType | Тип постраничного навигатора. Значение по умолчанию: 3.
|
| addGuestbook |
|
| showPreNext | Да — в подробном просмотре выводятся ссылки на предыдущую и следующую картинки. Нет — в подробном просмотре не выводятся ссылки на предыдущую и следующую картинки. |
| linkToAllObjects | Значение строки, которая будет являться ссылкой на «Все фото». Ссылка появится только тогда, когда значение опции redirRid — номер рубрики, доступ к которой разрешён из Front-Office. Для того, чтобы не выводить ссылку, нужно ввести значение nothing. |
| style | CSS-стиль картинки. |
| order | Порядок сортировки фотографий в фотоальбоме с голосованием. Возможные значения: sort — порядок сортировки задаётся в бэк-офисе. desc — последняя добавленная картинка отображается первой. ask — последняя добавленная картинка отображается последней. |
| bannerSmall | Действует на обработчик «Баннеры». Да — в качестве баннера используется превьюшка. Нет — в качестве баннера используется сама картинка. |
| viewDescr | Показывать ли описание картинок в самом фотоальбоме, или только в подробном просмотре. |
| ssWidth | Для слайд-шоу. Опция определяет в пикселях ширину блока, содержащего объекты слайд-шоу. При значении 0 ширина блока равна ширине самого широкого объекта. |
| ssHeight | Для слайд-шоу. Опция определяет в пикселях высоту блока, содержащего объекты слайд-шоу. При значении 0 высота блока равна высоте самого высокого объекта. |
| ssScale | Для слайд-шоу. Опция определяет, масштабируются ли объекты слайд-шоу в случае, если их размеры больше размеров содержащего их блока (этот случай возможен при ненулевых значениях опций ssWidth или ssHeight). Если ширина и/или высота какого-либо объекта слайд-шоу окажется больше, соответственно, ширины и/или высоты содержащего блока, то при значении Да этот объект уменьшится до ширины или высоты блока, сохраняя свои пропорции. При значении Нет этот объект сохранит свои размеры, а его часть, не помещающаяся в блок, не будет видна. |
| ssHalt | Для слайд-шоу. Опция определяет в секундах длительность отображения каждого объекта слайд-шоу. |
| ssReplacement | Для слайд-шоу. Опция определяет в секундах длительность плавной замены одного объекта слайд-шоу другим. |
| ssRate | Для слайд-шоу. Опция определяет в кадрах за секунду частоту смены кадров при плавной замене одного объекта слайд-шоу другим. При большем значении частоты переход от объекта к объекту будет более плавным, но ценой загруженности процессора компьютера. |
