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

1. Как добавить альбом?
2. Как удалить альбом?
3. Как добавить, удалить или редактировать описания к альбомам?
4. Как добавить фотографию?
5. Как удалить фотографию?
6. Как добавить/изменить/удалить описание к фотографии?
7. Как добавить альбом в альбом или удалить вложенный альбом?
8. Как добавлять обложки к альбомам?

Для того, чтобы перейти к управлению галереей необходимо:

1. Авторизоваться в панели управления сайтом;
2. В меню Компоненты выполнить клик по подпункту Галерея;

На экране в основной области будет отображён интерфейс дерева альбомов представленный на рисунке 1.

Галерея содержит в себе объекты двух видов:

1. Альбомы - объекты, которые могут содержать в себе другие альбомы (подальбомы) и фотографии;
2. Фотографии - объекты, которые обеспечивают хранение файла изображения, а также хранение названия, описания и тэгов связанных с данным изображением;

Альбомы обладают следующими свойствами:

1. Имя - текстовое название альбома, отображается в административной части и может быть выведено в пользовательской части;
2. Год - год фотографий загруженных в альбом, может быть использовано при категоризации альбомов по времени создания фотографий;
3. Описание - текстовое описание содержимого альбома;
4. Обложка альбома - изображение, которое используется как обложка альбома, если не указано система будет отображать первое в альбоме изображение в качестве обложки;
5. Активность - флаг, позволяющий установить активность альбома в пользовательской части;
6. Видимость - флаг, позволяющий установить видимость альбома в списках альбомов в пользовательской части;

Фотографии обладают следующими свойствами:

1. Имя - текстовое название фотографии;
2. Описание - текстовое описание фотографии;
3. URL - адрес ссылки, по которой необходимо перейти при клике на фотографию¹⁾;
4. Файл - файл изображения отображаемого в фотографии, смотрите рекомендации по загружаемым файлам;
5. Метки - текстовые метки через запятую характеризующие фотографию²⁾;
6. Активен - флаг позволяющий включить и выключить отображение фотографии в пользовательской части.

Для того, чтобы разместить фотографии в галерее необходимо создать хотя бы 1 альбом. В данном разделе дано описание интерфейса дерева альбомов, дана информация по управлению альбомами, а также по редактированию информации об альбомах. Подробная информация по управлению фотографиями приводится в соответствующем разделе ниже.

Ранее на рисунке 1 была представлена страница управления альбомами. В ней содержатся следующие элементы управления (сверху вниз):

1. Название страницы;
2. Подсказка по использованию дерева альбомов;
3. Кнопки для создания альбома в корне галереи и кнопка обновления дерева: ;
4. Дерево альбомов;

При нажатии на кнопку Создать альбом отображается окно создания альбома представленное на рисунке 2:

В окне создания альбома присутствуют следующие поля:

1. Родитель - название выбранного родительского альбома, если значение «Нет» - новый альбом будет создан в корне галереи;
2. Имя - название нового альбома;
3. Описание - текстовое описание нового альбома;
4. Активность - флаг активности альбома;
5. Видимость - флаг видимости альбома.

При выполнении правого клика по альбому в списке будет отображено контекстное меню альбома представленное на рисунке 3:

В контекстном меню содержатся следующие пункты:

1. Редактировать альбом - пункт меню выполняет перенаправление браузера на страницу редактирования альбома;
2. Создать альбом - пункт меню выполняет вызов окна создания нового альбома являющимся вложенным в указанный;
3. Удалить альбом - пункт меню выполняет удаление альбома после подтверждения операции.

При переходе к редактированию альбома в основной области будет отображена панель редактирования альбома представленная на рисунке 4:

В панели редактирования альбома представлены все поля альбома, а также специальные элементы интерфейса для загрузки в альбом новых фотографий, а также список всех фотографий входящих в альбом. Более подробное описание указанных элементов интерфейса приводится в разделе управление фотографиями.

Чтобы добавить альбом необходимо выполнить следующие действия:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Нажать на кнопку ;
3. На экране будет отображено окно создания альбома:
   
4. Заполнить поля формы, поле Имя обязательно для заполнения;
5. Нажать на кнопку ;
6. В случае, если в каком либо из полей допущена ошибка, система подсветит указанное поле красным цветом:
   
7. В случае успешного сохранения, новый альбом будет отображён в списке альбомов:
   
   в нашем случае мы создали Альбом 3 без флага активности и видимости.

Чтобы удалить альбом необходимо выполнить следующие действия:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок правой кнопкой мыши на альбоме который требуется удалить;
3. В появившемся контекстном меню выбрать пункт ;
4. В появившемся окне подтвердить удаление альбома нажав на кнопку Да:
   
5. В случае успешного удаления альбома, дерево альбомов обновится и указанный альбом будет удалён;

Для того, чтобы добавить/изменить/удалить описание альбома необходимо выполнить следующие действия:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок левой кнопкой мыши на требуемом альбоме;
3. В появившейся форме необходимо внести требуемые изменения в поля Описание или Название³⁾;
4. Нажать на кнопку в верхней правой части страницы;
5. Если сохранение пройдёт успешно в правой верхней части страницы будет отображено сообщение об успехе внесения изменений
   
6. В случае ошибки будет выведено сообщение об ошибке и подсвечены красным поля в которых допущены ошибки;

Управление вложенными альбомами ничем не отличается от управления альбомами в корне галереи. Для выполнения операций с вложенными альбомами достаточно развернуть их в дереве альбомов используя элемент управления стрелочка . При клике по данному элементу, в дереве альбомов разворачиваются все вложенные в данный альбом элементы: Дальнейшее управление осуществляется аналогично описанному выше.

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

Добавить обложку альбома можно двумя способами:

1. Выбрать одну из фотографий альбома и в контекстном меню фотографии⁴⁾ выбрать пункт Сделать обложкой альбома, указанный элемент станет обложкой альбома;
2. При редактировании альбома нажать на кнопку в появившемся окне
   
   выбрать файл обложки на нажать на кнопку ;

Чтобы удалить обложку альбома и вернуть систему к автоматическому определению обложки необходимо:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок левой кнопкой мыши на требуемом альбоме;
3. В появившемся окне нажать на кнопку .

В данном разделе приводится информация по управлению фотографиями. Фотографии можно загружать только в альбоме, поэтому, вам необходимо создать хотя бы 1 альбом, перед началом загрузки фотографий.

Всё управление фотографиями сосредоточено в интерфейсе редактирования альбома (смотрите рисунок 4). Подробно блок управления фотографиями представлен на рисунке 5.

Панель делится на две половины:

1. В левой части панели находятся:
   1. Панель кнопок загрузки новых фотографий;
   2. Список превью фотографий;
   3. Элементы управления постраничной навигацией в списке фотографий;
2. В правой части находится панель отображающая информацию о текущей выделенной фотографии;

В панели кнопок загрузки новых фотографий представлены следующие кнопки (слева-направо):

1. Загрузить элемент - нажатие на кнопку приводит к открытию окна загрузки одной фотографии;
2. Multi-Upload - нажатие на кнопку приводит к открытию окна массовой загрузки фотографий с жёсткого диска ПК;
3. Пакетная загрузка - нажатие на кнопку приводит к открытию окна массовой с жёсткого диска сервера;
4. Zip Upload - нажатие на кнопку приводит к открытию окна загрузки архива с изображениями;

В списке фотографий при щелчке правой кнопкой мыши по изображению отображается контекстное меню фотографии:

1. Редактировать элемент - выбор пункта меню выполняет открытие окна редактирования фотографии альбома;
2. Сделать обложкой - выбор пункта меню выполняет установку выделенной фотографии в качестве обложки альбома;
3. Удалить элемент - выбор пункта меню выполняет удаление выделенной фотографии из альбома.

В случае если в альбоме более 20 (по умолчанию) фотографий, для доступа ко всем фотографиям можно использовать постраничную навигацию. Для этого в нижней части левой панели расположены элементы управления постраничной навигацией.

Для того, чтобы добавить фотографию в альбом необходимо:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок левой кнопкой мыши на требуемом альбоме;
3. В панели управления фотографиями нажать на кнопку ;
4. В появившемся окне
   
   заполнить поля описания фотографии и в поле файл указать файл для загрузки⁵⁾;
5. После нажатия на кнопку изображение будет добавлено в альбом⁶⁾.

Для того, чтобы удалить фотографию из альбома (галереи) необходимо:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок левой кнопкой мыши на альбоме в котором находится фотография;
3. В списке фотографий найти требуемую фотографию и выполнить щелчок правой кнопкой мыши;
4. В контекстном меню выбрать пункт Удалить элемент;
5. В появившемся окне выбрать Да для подтверждения удаления фотографии
   
6. Список фотографий автоматически обновится и удалённая фотография не будет в нём присутствовать.

Для того, чтобы внести изменения в название и описание фотографии необходимо:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок левой кнопкой мыши на альбоме в котором находится фотография;
3. В списке фотографий найти требуемую фотографию и выполнить щелчок правой кнопкой мыши;
4. В контекстном меню выбрать пункт Редактировать элемент;
5. В появившемся окне внести требуемые изменения заполнив предложенные поля
   
6. Нажать на кнопку для сохранения изменений на сервере;

Массовая загрузка фотографий в альбом возможна 3-мя различными способами:

1. Мульти-загрузка;
2. Пакетная загрузка;
3. Загрузка архивом;

Каждый из этих способов имеет свои достоинства и недостатки и предназначен решать различные задачи.

Мульти-загрузка может пригодится, когда необходимо загрузить в альбом несколько⁷⁾ не очень больших фотографий, размер которых не превышает установленное на сервере ограничение на размер загружаемого файла. Для выполнения мульти-загрузки необходимо:

1. Перейти к управлению галереей: меню Компоненты → Галерея;
2. Выполнить щелчок левой кнопкой мыши на требуемом альбоме;
3. В панели управления фотографиями нажать на кнопку ;
4. На экране будет отображено окно мульти-загрузки файлов
   
5. В связи с тем, что одновременно загружается несколько файлов отредактировать можно только общие для всех файлов метки и флаг активности;
6. Для загрузки файла или файлов достаточно нажать на кнопку и выбрать один или несколько файлов, которые необходимо загрузить;
7. Загрузка начнётся сразу же после выбора файлов, новые фотографии будут получать имя соответствующее имени файлов;
8. После загрузки всех требуемых файлов можно закрыть окно крестиком или кнопкой Выполнено;

Пакетная загрузка может пригодится, когда необходимо загрузить много ⁸⁾ фотографий, размер которых превышает установленное на сервере ограничение на размер загружаемого файла. Для выполнения пакетной загрузки необходимо:

1. Используя FTP клиент или иной способ подключения к серверу загрузить на сервер в какой либо каталог требуемые к загрузке в галерею файлы, выбранный каталог должен быть доступен для чтения со стороны веб-сервера и желательно должен располагаться ниже корня сайта;
2. Перейти к управлению галереей: меню Компоненты → Галерея;
3. Выполнить щелчок левой кнопкой мыши на требуемом альбоме;
4. В панели управления фотографиями нажать на кнопку ;
5. На экране будет отображено окно пакетной загрузки файлов
   
6. В указанном окне необходимо указать путь к каталогу в который были загружены файлы и заполнить поля Метки и Активность по необходимости;
7. После заполнения полей и адреса необходимо нажать на кнопку и система автоматически добавит все изображения из указанного каталога в альбом;

Загрузка архивом может пригодится, когда удобно загрузить 1 файл, содержащий в себе множество подготовленных изображений. Поддерживаются только архивы в формате zip. Рекомендуется не использовать кириллические названия файлов в архиве во избежании проблем с обработкой кодировки имён файлов из архива. Загрузка файлов из архива аналогична предыдущим двум вариантам и разобраться с ней не должно представлять проблем.

Мы рекомендуем вам выполнять подготовку всех ваших графических материалов перед загрузкой на сайт. Выполнить данные работы несложно самостоятельно с использованием самых простых графических редакторов (например GIMP или аналогичных). Используя указанные редакторы необходимо внести изменения в ваши файлы согласно следующим рекомендациям:

1. Уменьшить размер файла или усечь не нужные элементы изображения таким образом, чтобы оно удачно смотрелось на странице. Вы можете получить рекомендации по подготовке изображений для вашей фотогалереи у наших специалистов при сдаче сайта.
2. Выполнить сжатие изображения в формат JPEG или PNG, первый формат лучше всего использовать для фотографий, а второй - для графических изображений (картинок);
3. Убедиться, что размер полученного файла не очень большой (например меньше 1 Мб), мы рекомендуем следующие значения:
   1. Полноразмерная фотография разрешением 2000 точек по горизонтали или вертикали - 500 Кб-1 Мб;
   2. Небольшое графическое изображение (логотип, картинка) до 1000 точек по большей стороне - 200-300 Кб;
   3. Скан-копия документа - в зависимости от формата, достаточно обеспечить читаемость, обычно достаточно 2000 точек по большей стороне - 200-300 Кб;
4. Уменьшать размер файла рекомендуется для снижения времени загрузки вашего сайта в браузерах ваших пользователей;
5. Мы не рекомендуем использовать формат файлов BMP, т.к. файлы данного формата имеют очень большой размер и часто плохо сжимаются и плохо отображаются на устройствах клиентов.