MODx/Подключаемые сниппеты/EasyGallery: различия между версиями

Материал из Викиучебника — открытых книг для открытого мира
Содержимое удалено Содержимое добавлено
Нет описания правки
Нет описания правки
Строка 22: Строка 22:


Параметры эскизов
Параметры эскизов
{| class="wikitable"

|-
w - Ширина эскиза изображения, в пикселях.
! Параметр !! Значение

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


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


thq - Качество JPEG-сжатия эскиза изображения от 0 до 100%. (100 - максимум)



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


name_len - Максимальное количество символов в названии эскиза

cat_name_len - Максимальное количество символов в названии директории

colls - Количество эскизов, отображаемых в одной строке.

limit - Количество эскизов, отображаемых на одной странице.

gpn - Номер стартовой страницы.

orderby - Поле, по которому будет осуществляться сортировка: date_added, last_modified, comments, filename, name, random.

order - Сортировка по возрастанию или убыванию, ASC и DESC соответственно.



Параметры комментариев
Параметры комментариев
{| class="wikitable"
|-
! Параметр !! Значение
|-
| ecm || Включение и отключение комментариев, 1 и 0 соответственно
|-
| ecl || Количество комментариев, отображаемых на одной странице.
|}


ecm - Включение и отключение комментариев, 1 и 0 соответственно.

ecl - Количество комментариев, отображаемых на одной странице.



Параметры шаблонов
Параметры шаблонов
{| class="wikitable"

|-
css - Таблица стилей галереи
! Параметр !! Значение
|-
| css || Таблица стилей галереи
Название чанка или путь до файла, относительно корня сайта.
Название чанка или путь до файла, относительно корня сайта.
По-умолчанию assets/modules/easy2/templates/style.css
По-умолчанию assets/modules/easy2/templates/style.css
|-

tpl - Шаблон галереи.
| tpl || Шаблон галереи.
Название чанка или путь до файла, относительно корня сайта.
Название чанка или путь до файла, относительно корня сайта.
По-умолчанию assets/modules/easy2/templates/gallery.htm
По-умолчанию assets/modules/easy2/templates/gallery.htm
|-

dir_tpl - Шаблон директории.
| dir_tpl || Шаблон директории.
Название чанка или путь до файла, относительно корня сайта.
Название чанка или путь до файла, относительно корня сайта.
По-умолчанию assets/modules/easy2/templates/directory.htm
По-умолчанию assets/modules/easy2/templates/directory.htm
|-

thumb_tpl - Шаблон эскиза изображения.
| thumb_tpl || Шаблон эскиза изображения.
Название чанка или путь до файла, относительно корня сайта.
Название чанка или путь до файла, относительно корня сайта.
По-умолчанию assets/modules/easy2/templates/thumbnail.htm
По-умолчанию assets/modules/easy2/templates/thumbnail.htm
|-

rand_tpl - Шаблон эскиза изображения для единичного отображения.
| rand_tpl || Шаблон эскиза изображения для единичного отображения.
Название чанка или путь до файла, относительно корня сайта.
Название чанка или путь до файла, относительно корня сайта.
По-умолчанию assets/modules/easy2/templates/random_thumbnail.htm
По-умолчанию assets/modules/easy2/templates/random_thumbnail.htm
|-

comments_tpl - Шаблон комментариев.
| comments_tpl || Шаблон комментариев.
Название чанка или путь до файла, относительно файла comments.easy2gallery.php.
Название чанка или путь до файла, относительно файла comments.easy2gallery.php.
По-умолчанию assets/modules/easy2/templates/comments.htm
По-умолчанию assets/modules/easy2/templates/comments.htm
|-

comments_row_tpl - Шаблон строки комментариев.
| comments_row_tpl || Шаблон строки комментариев.
Название чанка или путь до файла, относительно файла comments.easy2gallery.php.
Название чанка или путь до файла, относительно файла comments.easy2gallery.php.
По-умолчанию assets/modules/easy2/templates/comments_row.htm
По-умолчанию assets/modules/easy2/templates/comments_row.htm
|}


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





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


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



Версия от 11:33, 4 мая 2011

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/