MODx/Подключаемые сниппеты/EasyGallery: различия между версиями
Нет описания правки |
Нет описания правки |
||
Строка 1: | Строка 1: | ||
{{Внимание|Статье требуется глобальная переработка. Предлагается оформление в виде таблиц.}} |
|||
[[Служебная:Contributions/94.77.132.64|94.77.132.64]] 20:32, 6 ноября 2010 (UTC) |
|||
Документация Easy 2 Gallery |
Документация Easy 2 Gallery |
||
Версия от 20:32, 6 ноября 2010
Внимание! Статье требуется глобальная переработка. Предлагается оформление в виде таблиц. |
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 - Высота эскиза изображения, в пикселях.
Помните, чтобы изменения размеров были применены к ранее загруженным изображениям нужно очистить кэш. Директория _thumbnails в корневой директории галереи.
thq - Качество JPEG-сжатия эскиза изображения от 0 до 100%. (100 - максимум)
Параметры отображения
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/