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

Фотогалерея

Альбомы
Фотографии
Настройки
Шаблонные теги
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 код, позволяющий включить анимацию при увеличении изображений.

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

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

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

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

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

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

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

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

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

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

Атрибуты:

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

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

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

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

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

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

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

Оформление блока в функции show_block в файле modules/photo/photo.view.php.

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

Общие стили:

.photo_name{} – название фотографии

.photo_img{} – изображение

.photo_size{} – размер фотографии

.photo_anons{} – краткое описание фотографии

.photo_text{} – полное описание фотографии

Список фотографий:

.photo_list{} – список фотографий

.photo_list .photo{} – фотография в списке

.photo_list .photo_name{} – название фотографии в списке

.photo_list .photo_img{} – изображение фотографии в списке

.photo_list .photo_size{} – размер фотографии в списке

.photo_list .photo_anons{} – краткое описание фотографии в списке

.photo_list .photo_cat_anons{} – краткое описание альбома фотографий

.photo_list .photo_cat_text{} – полное описание альбома фотографий

.photo_list .photo_cat_link{} – ссылка на вложенные альбомы фотографий

.photo_list .show_all{} – ссылка на все фотографии в альбоме

.photo_list .previous_next_links{} – ссылки на предыдущий, следующий альбомы

.photo_list .previous_link{} – ссылка на предыдущий альбом

.photo_list .next_link{} – ссылка на следующий альбом

Страница фотографии:

.photo_id{} – страница фотографии

.photo_id .photo_img{} – фотография

.photo_id .photo_size{} – размер

.photo_id .photo_anons{} – краткое описание фотографии

.photo_id .photo_text{} – полное описание фотографии

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

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

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

Cписок фотографий, прикрепленных к тегу:

.tags_list .photo{} – фотография в списке

.tags_list .photo_name{} – название фотографии в списке

.tags_list .photo_img{} – изображение фотографии в списке

.tags_list .photo_size{} – размер фотографии в списке

.tags_list .photo_anons{} – краткое описание фотографии в списке

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

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

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

.photo_block .photo{} – фотография в блоке

.photo_block .photo_name{} – название фотографии в блоке

.photo_block .photo_img{} – изображение фотографии в блоке

.photo_block .photo_size{} – размер фотографии в блоке

.photo_block .photo_anons{} – краткое описание фотографии в блоке

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

Файлы

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

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

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