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/