Russian Russian   English English
Последняя версия 1.3

Документация 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

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

 

Все параметры можно комбинировать, например [!easy2?gid=7&w=200&h=180&thq=90!]

 

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

Галерея

[+easy2:cat_name+] - название текущей директории
[+easy2:back+] - кнопка на родительскую директорию
[+easy2:content+] - содержимое галереи
[+easy2:pages+] - ссылки на страницы

Директории

[+easy2:cat_name+] - название диектории
[+easy2:cat_id+] - идентификатор директории
[+easy2:parent_id+] - идентификатор родительской директории
[+easy2:cat_level+] - уровень вложенности
+ всё что доступно для эскизов

Эскизы

[+easy2:src+] - путь до эскиза изображения
[+easy2:w+] - ширина эскиза изображения
[+easy2:h+] - высота до эскиза изображения
[+easy2:id+] - идентификатор изображения
[+easy2:name+] - название изображения (если длиннее name_len символов, обрезается до name_len-2 символов)
[+easy2:title+] - заголовок (полное название) изображения
[+easy2:description+] - описание изображения
[+easy2:filename+] - имя файла изображения
[+easy2:size+] - размер файла изображения (в байтах)
[+easy2:comments+] - количество комментариев к изображению
[+easy2:date_added+] - дата добавления изображения
[+easy2:last_modified+] - дата последнего изменения данных об изображении
[+easy2:dir_id+] - идентификатор директории, в которой он находится

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

[+easy2:id+] - идентификатор комментария
[+easy2:file_id+] - идентификатор файла
[+easy2:author+] - имя автора
[+easy2:email+] - email автора
[+easy2:name_w_mail+] - если указан email то "<a href="mailto:[+easy2:email+]">[+easy2:author+]</a>", иначе "[+easy2:author+]"
[+easy2:comment+] - комментарий
[+easy2:date_added+] - дата добавления
[+easy2:last_modified+] - дата последнего изменения

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

[+easy2:title+] - название страницы (из langs/*.comments.php)
[+easy2:body+] - комментарии
[+easy2:pages+] - ссылки на страницы
+ содержимое файла langs/*.comments.php

 

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

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

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

 

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

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


© 2007-2009