Модуль Evogallery

Опубликовано: 11 Июл 2014

(Статья, является переводом документации, соответственно, в тексте могут быть ошибки)

Evogallery – гибкая галерея для сайта

Установка

Чтобы установить EvoGallery, надо распаковать пакет и выполните следующие действия:

Создайте папку с именем 'galleries' в каталоге "assets" вашего сайта MODx и дайте ему полные права на запись (777).

Скопируйте все файлы из папки "assets" и "install" себе на сайт. 

Запустите инсталлятор (http://yoursite/install/index.php) и следуйте простым инструкциям на экране, чтобы завершить установку. После того как вы закончили установку, убедитесь, что директория "install" удалена с вашего сайта.

Как изменить размер картинки EvoGallery

Заходим в админку - Модули - Управление модулями - EvoGallery 

{'w': 175, 'h': 175, 'q': 75}меняем на нужные размеры, можно еще добавить , 'zc': 1 чтобы картинки ресайзились

Параметр

Описание

По умолчанию

Пример

&display

Вывод результатов работы сниппета, как галереи, так и отдельного излбражения. Возможные значения: galleries, images, single

images

&display=` single `

&type

Тип вывовда, если указано, фрагмент автоматически загрузит необходимый javascript. Возможные значения simple-list, single, jquery-cycle,

simple-list

 

simple-list

&type=` single `

& includeAssets

Регистрация внешних скриптов и CSS файлов, необходимых для указанного типа галереи. Если установлено в 0, они должны быть включены вручную в <head>

 

1

& includeAssets=`0`

&picId

Идентификатор конкретного рисунка, показывается при отображении одного изображения

$ _REQUEST ['picId']

 

&docId

ID документа, для которого отображаются картинки (по умолчанию: документ, из которого галерея вызывается). Для вызова галереи из нескольких  документов id можно указать через запятую (без пробелов), или * для всех документов

$modx->documentIdentifier

&docId=`5`

&gallerySortBy

Указывает по какому полю сортировать галереи. Доступные поля (id, pagetitle, longtitle, description, alias, pub_date, introtext, editedby, editedon, publishedon, publishedby, menutitle) или RAND()

menuindex

&gallerySortBy=` longtitle `

&gallerySortDir

Направление сортировки галереи. Возможные варианты ASC или DESC

ASC

&gallerySortDir=` DESC `

&ignoreHidden

Показывать документы, помеченные как скрытые

0

&ignoreHidden=`1`

&excludeDocs

Не показывать в галереи документы с определенными id (без пробелов)

0

&excludeDocs=`8`

&sortBy

Указывает по какому полю сортировать элементы. Доступные поля (id, content_id, filename, title, description, sortorder) or RAND()

sortorder

&sortBy=` content_id `

&sortDir

Направление сортировки элементов. Возможные варианты ASC или DESC

ASC

&sortDir=` DESC `

&limit

Ограничить количество отображаемых элементов

null

&limit=`5`

&tags

Разделенный запятыми набор тегов для фильтрации результатов. Смотрит в поле ключевых слов для изображений.

null

&tags=`images, images1`

&tagMode

Форма поиска для тега AND или OR

AND

&tagMode=`OR`

&tpl

Чанк  для всей галереи (по умолчанию tpl.default.txt  для выбранного типа) Плейсхолдеры: элементы

$this->config['snippetPath'] . $this->config['type'] . '/tpl.default.txt'

 

&itemTpl

Чанк  для каждых миниатюры/изображения элементов галереи

$this->config['snippetPath'] . $this->config['type'] . '/tpl.item.default.txt'

 

&itemTplFirst

Чанк для первых миниатюры/изображения элемента  галереи (по умолчанию tpl.item.first.txt для выбранного типа)

$this->config['snippetPath'] . $this->config['type'] . '/tpl.item.first.txt'

 

&itemTplLast

Чанк для последних миниатюры/изображения элемента  галереи

(по умолчанию tpl.item.last.txt для выбранного типа)

$this->config['snippetPath'] . $this->config['type'] . '/tpl.item.last.txt'

 

&itemTplAlt

Чанк для альтернативных миниатюры/изображения элемента  галереи

(по умолчанию tpl.item.alt.txt для выбранного типа)

$this->config['snippetPath'] . $this->config['type'] . '/tpl.item.alt.txt'

 

&itemAltNum

Модификатор для альтернативных миниатюры/изображения элемента  галереи (по умолчанию каждый второй пункта)

2

&itemAltNum=`4`

&galleriesUrl

URL  к директории галереи (должен содержать папки с Id документа, с превью / папки в галерее каждого документа)

$modx->config[ 'base_url' ] . 'assets/galleries/'

 

&galleriesPath

Путь к каталогу галереи

$modx->config[ 'base_path' ] . 'assets/galleries/'

 

&snippetUrl

Url  к директории сниппета

$modx->config[ 'base_url' ] . 'assets/snippets/evogallery/'

 

&snippetPath

Путь к директории сниппета

$modx->config[ 'base_path' ] . 'assets/snippets/evogallery/'

 

&id

Уникащьный идентификатор галереи и уникальный параметр  Url

 

null

 

&id=`4`

&paginate

Разбивать результат на страницы

0

&paginate=`1`

&paginateAlwaysShowLinks

Определяет являются ли указатели «следующая» и «предыдущая» с

0

&paginateAlwaysShowLinks =`1`

&show

Количество отображаемых элементов при разбиении на страницы

20

&show=`15`

&paginateNextText

Текст для ссылки «следующая»

Next

 

&paginatePreviousText

Текст для ссылки «предыдущая»

Previous

 

&tplPaginatePrevious

Шаблон для ссылки «предыдущая»

<a href='[url]'  class ='eg_previous_link'>  [PagimnatePreviosText] </a>

 

&tplPaginateNext

Шаблон для ссылки «следующая»

<a href='[url]' class ='eg_next_link'> [ PagimnateNextText]</a>

 

&tplPaginateNextOff

Шаблон для внутренней  ссылки «следующая»

<span class='eg_next_off eg_off'> [ PagimnateNextText] </span>

 

&tplPaginatePreviousOff

Шаблон для внутренней  ссылки «предыдущая»

<span class='eg_previous_off eg_off'> [PagimnatePreviosText] </span>

 

&tplPaginatePage

Шаблон для ссылки на страницу

<a class='eg_page' href='[url]'>[page]</a>

 

&tplPaginateCurrentPage

Шаблон для текущей ссылки

<span class='eg_currentpage'> [page]</span>

 

 

Примеры

Вывод списка изображений с помощью  jQuery цикла (jquery-cycle):

[ [EvoGallery? &display=`images` &type=`jquery-cycle`]]

Вывод списка изображений с помощью  jQuery цикла  (jquery-cycle), сортировка по  'sortorder':

[ [EvoGallery? &display=`images` &type=`jquery-cycle` &sortBy=`sortorder`]]

Вывод галереи доступно в специальный контейнер, используя указанный шаблон элемента:

[ [EvoGallery? &display=`galleries` &docId=`22` &itemTpl=`galleryListItem`]]

Комментарии (0)


Оставить комментарий




Разрешённые теги: <b><i><br>Добавить новый комментарий: