MODx/Подключаемые сниппеты/EasyGallery

94.77.132.64 20:32, 6 ноября 2010 (UTC)

Документация Easy 2 Gallery

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

   * Управление галереей осуществляется через модуль.
   * CSS стили, которые используются в галерее находятся в файле assets/modules/easy2/templates/style.css
   * Генерация эскизов осуществляется через сниппет.
   * Просмотр изображения осуществляется через файл show.easy2gallery.php, добавление водяных знаков осуществляется там же.
   * Просмотр и добавление комментариев осуществляется через файл comments.easy2gallery.php.
   * Комментарии сохраняется в кодировке UTF-8.

Описание параметров сниппета

gid - Идентификатор галереи, с которой начнет работать сниппет. По умолчанию 1 - корневая директория.

Параметры эскизов

Параметр	Значение
w	Ширина эскиза изображения, в пикселях
h	Высота эскиза изображения, в пикселях
thq	Качество JPEG-сжатия эскиза изображения от 0 до 100%. (100 - максимум)

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

Параметры отображения

Параметр	Значение
name_len	Максимальное количество символов в названии эскиза
cat_name_len	Максимальное количество символов в названии директории
colls	Количество эскизов, отображаемых в одной строке
limit	Количество эскизов, отображаемых на одной странице
gpn	Номер стартовой страницы
orderby	Поле, по которому будет осуществляться сортировка: date_added, last_modified, comments, filename, name, random
order	Сортировка по возрастанию или убыванию, ASC и DESC соответственно

Параметры комментариев

Параметр	Значение
ecm	Включение и отключение комментариев, 1 и 0 соответственно
ecl	Количество комментариев, отображаемых на одной странице.

Параметры шаблонов

Параметр	Значение
css	Таблица стилей галереи Название чанка или путь до файла, относительно корня сайта. По-умолчанию assets/modules/easy2/templates/style.css
tpl	Шаблон галереи. Название чанка или путь до файла, относительно корня сайта. По-умолчанию assets/modules/easy2/templates/gallery.htm
dir_tpl	Шаблон директории. Название чанка или путь до файла, относительно корня сайта. По-умолчанию assets/modules/easy2/templates/directory.htm
thumb_tpl	Шаблон эскиза изображения. Название чанка или путь до файла, относительно корня сайта. По-умолчанию assets/modules/easy2/templates/thumbnail.htm
rand_tpl	Шаблон эскиза изображения для единичного отображения. Название чанка или путь до файла, относительно корня сайта. По-умолчанию assets/modules/easy2/templates/random_thumbnail.htm
comments_tpl	Шаблон комментариев. Название чанка или путь до файла, относительно файла comments.easy2gallery.php. По-умолчанию assets/modules/easy2/templates/comments.htm
comments_row_tpl	Шаблон строки комментариев. Название чанка или путь до файла, относительно файла comments.easy2gallery.php. По-умолчанию assets/modules/easy2/templates/comments_row.htm

Подробнее об этом шаблоне см в дополнительных возможностях.

Все параметры можно комбинировать, например

Описание плейсхолдеров используемых в шаблонах

Галерея

• - название текущей директории
• - кнопка на родительскую директорию
• - содержимое галереи
• - ссылки на страницы

Директории

• - название диектории
• - идентификатор директории
• - идентификатор родительской директории
• - уровень вложенности + всё что доступно для эскизов

Эскизы

• - путь до эскиза изображения
• - ширина эскиза изображения
• - высота до эскиза изображения
• - идентификатор изображения
• - название изображения (если длиннее name_len символов, обрезается до name_len-2 символов)
• - заголовок (полное название) изображения
• - описание изображения
• - имя файла изображения
• - размер файла изображения (в байтах)
• - количество комментариев к изображению
• - дата добавления изображения
• - дата последнего изменения данных об изображении
• - идентификатор директории, в которой он находится

Комментарии (строка)

• - идентификатор комментария
• - идентификатор файла
• - имя автора
• - email автора
• - если указан email то "<a href="mailto:"></a>", иначе ""
• - комментарий
• - дата добавления
• - дата последнего изменения

Комментарии (страница)

• - название страницы (из langs/*.comments.php)
• - комментарии
• - ссылки на страницы + содержимое файла langs/*.comments.php

Дополнительные возможности

Вывод случайного эскиза из галереи

Для этого необходимо указать лимит 1(limit=1) и случайную сортировку (orderby=`random`). В этом случае используется шаблон rand_tpl. Адрес галереи необходимо указывать в шаблоне вручную!

Java script библиотеки используемые в галерее

Highslide JS http://vikjavev.no/highslide/ Документация - http://vikjavev.no/highslide/doc.php

Источник статьи: http://e2g.info/