MaxiGallery
MODX Wiki
Перейти

Сниппет MaxiGallery один из самых популярных сниппетов, для организации галереи на сайте под управлением MODx Evolution. Этот сниппет достаточно прост в использовании и легко устанавливается. Огромное количество параметров и возможность использовать собственные шаблоны, позволяет настроить галерею практически под любые нужды. Поддерживается несколько типов галерей, в том числе, с применением Ajax. Сниппет автоматически создает эскизы заданных размеров и копирует их в папку с id галереи. Есть возможность наложения водяных знаков и ряд других эффектов. Управление галереей (добавление фотографий, сортировка и т.д.) осуществляется через front-end.

Установка

Первичная установка

1. Скачайте MaxiGallery.

2. Распакуйте архив и поместите содержимое архива в корневую папку сайта. Файлы будут скопированы в правильное место.

3. Для папки assets/galleries/ необходимо установить права на запись.

4. Создайте новый сниппет MaxiGallery и поместите в него код из файла maxigallery.txt.

Обновление

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

2. Удалите папку /assets/snippets/maxigallery/

3. Распакуйте архив и поместите содержимое архива в корневую папку сайта. Файлы будут скопированы в правильное место.

4. Замените код сниппета MaxiGallery, поместив в него код из файла maxigallery.txt.

Параллельная установка

Если вы хотите установить новую версию, но не хотите удалять текущую установку MaxiGallery, вы можете сделать это с помощью параллельной установки.

1. Распакуйте архив на своем компьютере.

2. Переименуйте папку /assets/snippets/maxigallery таким образом: /assets/snippets/maxigallery-new.

3. Откройте файл maxigallery.txt и найдите в нем строку

define(MAXIGALLERY_PATH, "assets/snippets/maxigallery/");

Измените в ней название папки:

define(MAXIGALLERY_PATH, "assets/snippets/maxigallery-new/");

4. Поместите содержимое архива в корневую папку сайта. Файлы будут скопированы в правильное место.

5. Создайте новый сниппет MaxiGalleryNew и поместите в него код из файла maxigallery.txt.

6. Используйте следующий вызов сниппета: MaxiGalleryNew.

Известные проблемы

При возникновении ошибки

Function split() is deprecated

замените в файле maxigallery.class.inc.php в строке 242 устаревшую функцию split на explode.

Русский язык

Изначально в MaxiGallery русский язык не входит, поэтому, необходимо создать собственный файл с переводом. Но так как MaxiGallery состоит из нескольких галерей, которые дополнительно используют скрипты и картинки, общий перевод галереи на русский язык будет состоять из нескольких шагов.

Создаем файл lang_ru-utf8.php

Все файлы с языковыми пакетами находятся в папке /assets/snippets/maxigallery/lang/. Создаем файл lang_ru-utf8.php в этой же папке на основе одного из существующих языковых пакетов, например, lang_en.php и переводим все необходимые строки. Либо скачиваем готовый файл:

lang_ru-utf8.php

Не забудьте, что кодировка файла должна быть utf-8.

Создаем файл slidebox_lang_ru-utf8.js

Вы наверняка обратили внимание на строчки в языковом файле:

// If you are going to make your own language file and are usign the lighbox,
// make a language file for it too, f.ex. /maxigallery/slidebox/slidebox_lang_en.js

Т.е. если мы собираемся создавать собственный языковой файл, нам рекомендуют также перевести и slidebox_lang_en.js. Действуем по тому же принципу, создаем в папке новый файл slidebox_lang_ru-utf8.js на основе файла slidebox_lang_en.js и переводим его. Либо скачиваем готовый файл:

slidebox_lang_ru-utf8.js

Не забудьте, что и в этом случае кодировка файла должна быть utf-8.

Создаем картинки для галерей slimbox и lightboxv2

Галереи slimbox и lightboxv2 в качестве навигации используют картинки closelabel.gif, nextlabel.gif и prevlabel.gif. Эти картинки находятся в папках:

/assets/snippets/maxigallery/lightboxv2/images/   для lightboxv2
/assets/snippets/maxigallery/slimbox/images/    для slimbox

Чтобы и в этих галереях навигация стала на русском языке, создаем собственные картинки и заменяем ими картинки с английским языком. Вы можете создать собственные картинки или скачать готовые:

Вызов русифицированной MaxiGallery

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

&lang=`ru-utf8`

Параметры

Формат: Разделённые запятой названия групп веб пользователей
Значение по умолчанию: нет
Примечание: Разделённые запятой названия групп веб пользователей
Пример:
&admin_webgroups=`manager`
Формат: Разделённые запятой имена веб-пользователей
Значение по умолчанию: нет
Примечание: Разделённые запятой имена веб-пользователей
Пример:
&admin_webusers=``
Формат: slidebox | lightboxv2 | popup | external
Значение по умолчанию: external
Примечание:
Пример:
&big_img_linkstyle=`popup`
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание: Должна быть того же цвета что и задний фон.
Пример:
&big_mask_bgcolor=`000000`
Формат: путь
Значение по умолчанию: assets/snippets/ maxigallery/ imagemask/ demomask–frame2.png
Примечание: Путь к изображению которые вы хотели бы использовать как imagemask для больших изображений (Изображение - водяной знак).
Пример:
&big_mask_img=``
Формат: top | topleft | topright | left | center | right | bottom | bottomleft | bottomright | resize
Значение по умолчанию: resize
Примечание: Расположение Изображение - водяной знак для больших картинок. Опция resize изменяет размер imagemask до размера изображения.
Пример:
&big_mask_position =`center`
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание: Должен быть таким же, как и цвет фона страницы.
Пример:
&big_shadow_bgcolor=`000000`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/dropshadow/
Примечание:
Пример:
&big_shadow_path=``
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&big_use_dropshadow=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&big_use_imagemask=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&big_use_watermark =`1`
Формат: 1 | 2 | 3 | 4 | 5
Значение по умолчанию: 5
Примечание:
Пример:
&big_watermark_font=`3`
Формат: left | center | right
Значение по умолчанию: right
Примечание:
Пример:
&big_watermark_halign=`center`
Формат: путь
Значение по умолчанию: assets/snippets/ maxigallery/watermark/ watermark.png
Примечание: Изображение может быть прозрачным PNG.
Пример:
&big_watermark_img=``
Формат: текст
Значение по умолчанию: Copyright <YEAR> <SITENAME>
Примечание:
Пример:
&big_watermark_txt =``
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание:
Пример:
&big_watermark_txt_color=`000000`
Формат: число (px)
Значение по умолчанию: 15
Примечание:
Пример:
&big_watermark_txt_hmargin=`25`
Формат: число (px)
Значение по умолчанию: 15
Примечание:
Пример:
&big_watermark_txt_vmargin=`25`
Формат: text | image
Значение по умолчанию: text
Примечание:
Пример:
&big_watermark_type=`image`
Формат: top | center | bottom
Значение по умолчанию: bottom
Примечание:
Пример:
&big_watermark_valign=`center`
Формат: ID документов, через запятую | all
Значение по умолчанию: Текущий документ
Примечание:
Разделяемый запятыми список ID для поиска галерей в них.
"all" отобразить все галереи.
Пример:
&childgalleries_ids=`all`
Формат: число
Значение по умолчанию: 0
Примечание: Ноль - все уровни.
Пример:
&childgalleries_level_limit=`3`
Формат: число
Значение по умолчанию: 0
Примечание: Значение 0 служит для вывода всех дочерних галерей.
Пример:
&childgalleries_limit=`10`
Формат: поле документа
Значение по умолчанию: menuindex
Примечание:
Пример:
&childgalleries_order_by =`pagetitle`
Формат: ASC | DESC
Значение по умолчанию: ASC
Примечание:
Пример:
&childgalleries_order_direction=`DESC`
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:assets/snippets /maxigallery/templates /childgallerytpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&childgalleryTpl=``
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:assets/snippets /maxigallery/templates /clearertpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&clearerTpl=``
Формат: путь | имя чанка | строка
Значение по умолчанию: assets/snippets/maxigallery/ css/default.css
Примечание:
Пример:
&css=`MaxigalleryCss`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание: функция до конца не реализована
Пример:
&debug=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание: Используется когда MooTools, Prototype или Scriptaculous javascript библиотеки вызваны в заголовке шаблона сайта и вы хотите чтобы MaxiGallery не подгружал свои копии этих библиотек.
Пример:
&disable_js_libs=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&disable_rightclick=`1`
Формат: normal | embedded | childgalleries | pictureview
Значение по умолчанию: normal
Примечание:
Пример:
&display=`pictureview`
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:assets/snippets /maxigallery/templates /draggabletpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&draggableTpl=``
Формат: slidebox | lightboxv2 | slimbox | smoothgallery | popup | external
Значение по умолчанию: нет
Примечание: Если в display указан параметр "embedded", этим параметром можно регулировать эффекты. "External" откроет картинку на другой странице.
Пример:
&embedtype=`external`
Формат: путь
Значение по умолчанию: /
Примечание: Например, если корневой каталог для FTP /home/username/ и MODx установлен в папке /home/username/public_html/modx/ то в качестве значения парметра ftp_base_dir укажите /public_html/modx/
Пример:
&ftp_base_dir=`/public_html/modx/`
Формат: пароль
Значение по умолчанию: нет
Примечание:
Пример:
&ftp_pass=``
Формат: число
Значение по умолчанию: 21
Примечание:
Пример:
&ftp_port=``
Формат: FTP-адрес
Значение по умолчанию: нет
Примечание:
Пример:
&ftp_server=``
Формат: имя пользователя
Значение по умолчанию: нет
Примечание:
Пример:
&ftp_user=``
Формат: ID документов, через запятую | all
Значение по умолчанию: нет
Примечание:
Список ID документов, разделенный запятыми
"all" - все документы
Пример:
&gal_query_ids=`all`
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /galleryoutertpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&galleryOuterTpl=``
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /gallerypicturetpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&galleryPictureTpl=``
Формат: строка
Значение по умолчанию: maxigallery
Примечание: К таблице MODx добавляется префикс
Пример:
&gtable=``
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&is_target=`1`
Формат: путь | имя чанка | строка
Значение по умолчанию: нет
Примечание:
Пример:
&js=`<scripttype="text/javascript"> alert(hello);</script>`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&keep_bigimg=`1`
Формат: en | fi
Значение по умолчанию: en
Примечание: Языковые файлы не полностью реализованы. Не стесняйтесь добавлять собственные языки. (См. lang_en.php для примера.)
Пример:
&lang=`ru`
Формат: число
Значение по умолчанию: 9999999
Примечание:
Пример:
&limit=``
Формат: ID документа
Значение по умолчанию: нет
Примечание:
Пример:
&manage_gallery=``
Формат: ID документа
Значение по умолчанию: нет
Примечание:
Пример:
&manage_target=``
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /manageoutertpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&manageOuterTpl=``
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /managepicturetpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&managePictureTpl=``
Формат: список веб-групп пользователей через запятую
Значение по умолчанию:
Примечание:
Пример:
&manager_webgroups=``
Формат: Разделённые запятой имена веб-пользователей
Значение по умолчанию:
Примечание: Разделённые запятой имена веб-пользователей
Пример:
&manager_webusers=``
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /managebuttontpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&manageButtonTpl=``
Формат: путь | имя чанка | строка
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /manageuploadtpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&manageUploadTpl=``
Формат: число (px) | WidthxHeight (px) (например 200x400) | 0
Значение по умолчанию: 1024
Примечание: Желаемый размер изображения в пикселях, или ноль для использования оригинального размера изображения
Пример:
&max_big_size=`200x400`
Формат: число | 0
Значение по умолчанию: 0
Примечание: 0 - неограниченное количество изображений
Пример:
&max_pic_number=`25`
Формат: число (px) | WidthxHeight (px) (например 200x400) | 0
Значение по умолчанию: 450
Примечание: 0 - оригинальный размер изображения
Пример:
&max_pic_size=`0`
Формат: число (px) | WidthxHeight (px) (например 200x400) | 0
Значение по умолчанию: 130
Примечание: 0 - оригинальный размер изображения
Пример:
&max_thumb_size=`0`
Формат: число
Значение по умолчанию: 0
Примечание: Количество строк, которые нужно пропустить
Пример:
&offset=``
Формат: date, pos, filename, title, id, random
Значение по умолчанию: pos,date
Примечание:
date
pos
filename
title
id
random - случайный порядок
Пример:
&order_by=`random`
Формат: ASC | DESC
Значение по умолчанию: DESC
Примечание:
Пример:
&order_direction=`ASC`
Формат: имя чанка | @FILE | @CODE
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /pagenumbertpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&pageNumberTpl=``
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание: Должен быть того же цвета, как цвет фона страницы.
Пример:
&pic_mask_bgcolor=`000000`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/imagemask /demomask-frame2.png
Примечание:
Пример:
&pic_mask_img=``
Формат: top | topleft | topright | left | center | right | bottom | bottomleft | bottomright | resize
Значение по умолчанию: resize
Примечание: Положение resize растягивает изображение маски на всю картинку.
Пример:
&pic_mask_position=``
Формат: Разделенный запятыми список идентификаторов изображений
Значение по умолчанию:
Примечание:
Пример:
&pic_query_ids=``
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание: Должен быть того же цвета, как и цвет фона страницы.
Пример:
&pic_shadow_bgcolor=`000000`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/dropshadow/
Примечание:
Пример:
&pic_shadow_path=``
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&pic_use_dropshadow=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&pic_use_imagemask=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&pic_use_watermark=`1`
Формат: 1 | 2 | 3 | 4 | 5
Значение по умолчанию: 3
Примечание:
Пример:
&pic_watermark_font=`4`
Формат: left | center | right
Значение по умолчанию: right
Примечание:
Пример:
&pic_watermark_halign=`center`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/watermark /watermark.png
Примечание:
Пример:
&pic_watermark_img=``
Формат: строка
Значение по умолчанию: Copyright <YEAR> <SITENAME>
Примечание:
Пример:
&pic_watermark_txt=``
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание:
Пример:
&pic_watermark_txt_color=``
Формат: число (px)
Значение по умолчанию: 10
Примечание:
Пример:
&pic_watermark_txt_hmargin=`5`
Формат: число (px)
Значение по умолчанию: 10
Примечание:
Пример:
&pic_watermark_txt_vmargin=`5`
Формат: text | image
Значение по умолчанию: text
Примечание:
image
text
Пример:
&pic_watermark_type=`image`
Формат: top | center | bottom
Значение по умолчанию: bottom
Примечание:
Пример:
&pic_watermark_valign=`center`
Формат: число
Значение по умолчанию: 0
Примечание: 0 - не ограничено
Пример:
&pics_per_page=`25`
Формат: число
Значение по умолчанию: 4
Примечание:
Пример:
&pics_per_row=`5`
Формат: ID документа
Значение по умолчанию: Текущий документ
Примечание: Используйте тот же вызов сниппета в этом документе, и добавьте в его вызове параметр: &is_target=`1`
Пример:
&picture_target=`10`
Формат: имя чанка | @FILE | @CODE
Значение по умолчанию: @FILE:/assets/snippets /maxigallery/templates /picturetpl.html
Примечание:
Имя чанка
@FILE:<path to a file>
@CODE:<template string>
Пример:
&pictureTpl=``
Формат: идентификатор фотографии
Значение по умолчанию: нет
Примечание: При &display=`pictureview`
Пример:
&pictureview_start_id=``
Формат: число
Значение по умолчанию: 1
Примечание: При &display=`pictureview`
Пример:
&pictureview_start_pos=``
Формат: число (%)
Значение по умолчанию: 100
Примечание: Процент от 0-100 для больших изображений
Пример:
&quality_big=`90`
Формат: число (%)
Значение по умолчанию: 70
Примечание: Процент от 0-100 для нормального изображения
Пример:
&quality_pic=`90`
Формат: число (%)
Значение по умолчанию: 70
Примечание: Качество в процентах между 0-100 для эскизов.
Пример:
&quality_thumb=`60`
Формат: число
Значение по умолчанию: 1
Примечание: Определяет, сколько уровней в глубину, чтобы перейти от родителя кдокументам, указанным в gal_query_ids
Пример:
&query_level_limit=`3`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание: Если включено, будут применяться случайные имена у загруженных фотографий.
Пример:
&random_filenames=`1`
Формат: число от 0 до 1
Значение по умолчанию: 0.7
Примечание: Где: 0 = прозрачный (не виден) и 1,0 = полностью непрозрачный
Пример:
&smoothgallery_carouselMaximizedOpacity=`0.9`
Формат: число (px)
Значение по умолчанию: 20
Примечание:
Пример:
&smoothgallery_carouselMinimizedHeight=`25`
Формат: число от 0 до 1
Значение по умолчанию: 0.4
Примечание: Где: 0 = прозрачный (не виден) и 1,0 = полностью непрозрачный
Пример:
&smoothgallery_carouselMinimizedOpacity=`0.5`
Формат: число (ms)
Значение по умолчанию: 9000
Примечание:
Пример:
&smoothgallery_delay=`8000`
Формат: true | false
Значение по умолчанию: true
Примечание: Если Вы удаляете этот параметр, также удаляйте ссылку из galleryPictureTpl
Пример:
&smoothgallery_embedLinks=`false`
Формат: число (ms)
Значение по умолчанию: 500
Примечание:
Пример:
&smoothgallery_fadeDuration=`1000`
Формат: число (px)
Значение по умолчанию: max_pic_size
Примечание: Переполнения будут скрыты, так что это должно быть высотой крупнейших изображений (например, как и max_pic_size).
Пример:
&smoothgallery_height=``
Формат: число
Значение по умолчанию: нет
Примечание: Это позволяет иметь несколько smoothgalleries на одной странице.
Пример:
&smoothgallery_id=``
Формат: true | false
Значение по умолчанию: true
Примечание:
Пример:
&smoothgallery_preloader=`false`
Формат: true | false
Значение по умолчанию: true
Примечание:
Пример:
&smoothgallery_showArrows=`false`
Формат: true | false
Значение по умолчанию: true
Примечание:
Пример:
&smoothgallery_showCarousel=`false`
Формат: true | false
Значение по умолчанию: true
Примечание:
Пример:
&smoothgallery_showInfopane=`false`
Формат: число
Значение по умолчанию: 0.7
Примечание: 0 = прозрачная (не видна) и 1,0 = полностью непрозрачная
Пример:
&smoothgallery_slideInfoZoneOpacity=`0.9`
Формат: текст
Значение по умолчанию: "pictures" текст из файла языка lang
Примечание:
Пример:
&smoothgallery_textShowCarousel=``
Формат: число (px)
Значение по умолчанию: 75
Примечание:
Пример:
&smoothgallery_thumbHeight=`90`
Формат: число (px)
Значение по умолчанию: 10
Примечание:
Пример:
&smoothgallery_thumbSpacing=`15`
Формат: число (px)
Значение по умолчанию: 100
Примечание:
Пример:
&smoothgallery_thumbWidth=`150`
Формат: true | false
Значение по умолчанию: false
Примечание:
Пример:
&smoothgallery_timed=`true`
Формат: число (px)
Значение по умолчанию: max_pic_size
Примечание: Переполнения будут скрыты, так что это должно быть шириной крупнейших изображений (например, как и max_pic_size).
Пример:
&smoothgallery_width=``
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание: Должен быть таким же, как и цвет фона страницы.
Пример:
&thumb_mask_bgcolor=`000000`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/imagemask /demomask-frame1.png
Примечание:
Пример:
&thumb_mask_img=``
Формат: top | topleft | topright | left | center | right | bottom | bottomleft | bottomright | resize
Значение по умолчанию: resize
Примечание: Опция resize - подгоняет размер imagemask к размеру изображения.
Пример:
&thumb_mask_position=`center`
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание: Должен быть того же цвета, как цвет фона страницы.
Пример:
&thumb_shadow_bgcolor=`000000`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/dropshadow/
Примечание:
Пример:
&thumb_shadow_path=``
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&thumb_use_dropshadow=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&thumb_use_imagemask=`1`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример:
&thumb_use_watermark=`1`
Формат: 1 | 2 | 3 | 4 | 5
Значение по умолчанию: 1
Примечание:
Пример:
&thumb_watermark_font=`2`
Формат: left | center | right
Значение по умолчанию: right
Примечание:
Пример:
&thumb_watermark_halign=`center`
Формат: путь
Значение по умолчанию: assets/snippets /maxigallery/watermark /watermark.png
Примечание:
Пример:
&thumb_watermark_img=``
Формат: текст
Значение по умолчанию: Copyright <YEAR>
Примечание:
Пример:
&thumb_watermark_txt=``
Формат: RGB Hexadecimal
Значение по умолчанию: FFFFFF
Примечание:
Пример:
&thumb_watermark_txt_color=`000000`
Формат: число (px)
Значение по умолчанию: 2
Примечание:
Пример:
&thumb_watermark_txt_hmargin=`5`
Формат: число (px)
Значение по умолчанию: 2
Примечание:
Пример:
&thumb_watermark_txt_vmargin=`5`
Формат: text | image
Значение по умолчанию: text
Примечание:
Пример:
&thumb_watermark_type=``
Формат: top | center | bottom
Значение по умолчанию: bottom
Примечание:
Пример:
&thumb_watermark_valign=`center`
Формат: число
Значение по умолчанию: 10
Примечание:
Пример:
&upload_field_count=`15`
Формат: 0 | 1
Значение по умолчанию: 0
Примечание: Это необходимо в определенных серверных средах.
Пример:
&use_ftp_commands=`1`
Формат: ID документа
Значение по умолчанию: нет
Примечание:
Пример:
&view_gallery=``

Плейсхолдеры

manageButtonTpl - - Шаблон для кнопки управления фотографиями.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/managebuttontpl.html
[+maxigallery.urlaction+] URL для обработчика формы
[+maxigallery.hiddenfields+] Скрытые поля формы
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

manageOuterTpl - Внешний шаблон для управления галереей

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/manageoutertpl.html
[+maxigallery.messages+] Сообщение об ошибке / уведомление в управлении изображениями (берется из языкового файла)
[+maxigallery.urlback+] URL для ссылки "Вернуться в обычный просмотр"
[+maxigallery.urlaction+] URL для обработчика формы
[+maxigallery.urldragsort+] URL для ссылки "Сортировать изображения"
[+maxigallery.managepictures+] Изображения (контент из managePictureTpl)
[+maxigallery.uploadpictures+] Поле для загрузки изображений (контент из manageUploadTpl)
[+maxigallery.hiddenfields+] Скрытое поле для формы Управление изображениями, которая должно быть в ней
[+maxigallery.pics_allowed_count+] Количество изображений, разрешенных к загрузке
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.
[+maxigallery.pageinfo.fieldname+] Поле документа MODx, в котором находится галерея. "fieldname" может быть pagetitle, longtitle, pub_date и т.д.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.

managePictureTpl - Шаблон для одного элемента изображения в управлении галереей

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/managepicturetpl.html
[+maxigallery.picture.fieldname+] Содержание для области изображения MaxiGallery. "fieldname" может иметь значения id, gal_id, filename, title, date, descr, pos или own_id.
[+maxigallery.path_to_gal+] Путь к текущему изображению галереи, например: assets/galleries/120/
[+maxigallery.fieldnames.field+] Названия полей ввода формы. "field" может быть delete, position, title, pictureid, modified и description. Посмотрите в шаблоне по умолчанию, как они используются.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

manageUploadTpl - Шаблон для загрузки файла в управлении галереей

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/manageuploadtpl.html
[+maxigallery.counter+] Номер для текущей строки
[+maxigallery.fieldnames.file+] Имя для поля формы
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

galleryOuterTpl - Внешний шаблон для краткого обзора галереи

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/galleryoutertpl.html
[+maxigallery.managebutton+] Кнопка для управления изображениями
[+maxigallery.childgalleries+] Дочерние галереи (содержимое childgalleryTpl)
[+maxigallery.childgallerycount+] Количество дочерних галерей
[+maxigallery.currentpage+] Номер текущей страницы
[+maxigallery.pagecount+] Общее число страниц
[+maxigallery.previous_page_url+] Ссылка на предыдущую страницу
[+maxigallery.next_page_url+] Ссылка на следующую страницу
[+maxigallery.pagenumbers+] Номера страниц (содержимое pageNumberTpl)
[+maxigallery.pictures+] Галерея изображений (содержимое galleryPictureTpl)
[+maxigallery.picscount+] Количество фотографий в галерее
[+maxigallery.embedtype+] Выбранный embedtype
[+maxigallery.pageinfo.fieldname+] Поле документа MODx, в котором находится галерея. "fieldname" может быть pagetitle, longtitle, pub_date и т.д.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

galleryPictureTpl - Шаблон для каждого изображения (эскиза) при обзоре галереи.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/gallerypicturetpl.html
[+maxigallery.embedtype+] Значение параметра embedtype конфигурации MaxiGallery
[+maxigallery.picture.fieldname+] Содержание для области изображения MaxiGallery. "fieldname" может иметь значения id, gal_id, filename, title, date, descr, pos или own_id.
[+maxigallery.path_to_gal+] Путь к текущему изображению галереи, например: assets/galleries/120/
[+maxigallery.picture_link_url+] URL для ссылки на изображение
[+maxigallery.big_pic_exists+] Индикатор, отображающий существование большого изображения. 1 - да, 0 - нет
[+maxigallery.picture_height_big+] Высота большого изображения
[+maxigallery.picture_width_big+] Ширина большого  изображения
[+maxigallery.picture_height_normal+] Высота нормального изображения
[+maxigallery.picture_width_normal+] Ширина нормального изображения
[+maxigallery.picture_height_thumb+] Высота эскиза
[+maxigallery.picture_width_thumb+] Ширина эскиза
[+maxigallery.pageinfo.fieldname+] Поле документа MODx, в котором находится галерея. "fieldname" может быть pagetitle, longtitle, pub_date и т.д.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.
[+maxigallery.rownumber+] Номер строки для изображения (только для версии 0.6)
[+maxigallery.picrownumber+] Количество изображений в строке (только для версии 0.6)
[+maxigallery.picpagenumber+] Количество изображений на странице (только для версии 0.6)
[+maxigallery.picnumber+] Количество изображений в галерее (только для версии 0.6)

childgalleryTpl - Шаблон для отображения дочерней галереи.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/childgallerytpl.html
[+maxigallery.picscount+] Количество фотографий в галерее
[+maxigallery.pageinfo.fieldname+] Поле документа MODx, в котором находится галерея. "fieldname" может быть pagetitle, longtitle, pub_date и т.д.
[+maxigallery.pageinfo.tv.tvname+] Переменные шаблона из дочернего документа галереи. "tvname" - имя TV-параметра.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.picture.fieldname+] Содержание для области изображения MaxiGallery (первое изображение в дочерней галереи). "fieldname" может иметь значения id, gal_id, filename, title, date, descr, pos или own_id.
[+maxigallery.childurl+] URL к документу дочерней галереи
[+maxigallery.path_to_gal+] Путь к текущему изображению галереи, например: assets/galleries/120/
[+maxigallery.big_pic_exists+] Индикатор, отображающий существование большого изображения. 1 - да, 0 - нет
[+maxigallery.picture_height_big+] Высота большого изображения
[+maxigallery.picture_width_big+] Ширина большого изображения
[+maxigallery.picture_height_normal+] Высота нормального изображения
[+maxigallery.picture_width_normal+] Ширина нормального изображения
[+maxigallery.picture_height_thumb+] Высота эскиза
[+maxigallery.picture_width_thumb+] Ширина эскиза
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

pictureTpl - Шаблон для предпросмотра изображения.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/childgallerytpl.html
[+maxigallery.managebutton+] Кнопка для управления изображениями
[+maxigallery.big_img_linkstyle+] Значение параметра big_img_linkstyle
[+maxigallery.keep_bigimg+] Значение параметра keep_bigimg
[+maxigallery.path_to_gal+] Путь к текущему изображению галереи, например: assets/galleries/120/
[+maxigallery.picture.fieldname+] Содержание для области изображения MaxiGallery. "fieldname" может иметь значения id, gal_id, filename, title, date, descr, pos или own_id.
[+maxigallery.counter+] Текущий номер изображения
[+maxigallery.total_pics_count+] Общее количество изображений в галерее
[+maxigallery.previous_pic_url+] Ссылка на предыдущее изображение
[+maxigallery.next_pic_url+] Ссылка на следующее изображение
[+maxigallery.index_url+] Ссылка на краткий обзор галереи
[+maxigallery.big_pic_exists+] Индикатор, отображающий существование большого изображения. 1 - да, 0 - нет
[+maxigallery.picture_height_big+] Высота большого изображения
[+maxigallery.picture_width_big+] Ширина большого изображения
[+maxigallery.picture_height_normal+] Высота нормального изображения
[+maxigallery.picture_width_normal+] Ширина нормального изображения
[+maxigallery.picture_height_thumb+] Высота эскиза
[+maxigallery.picture_width_thumb+] Ширина эскиза
[+maxigallery.pageinfo.fieldname+] Поле документа MODx, в котором находится галерея. "fieldname" может быть pagetitle, longtitle, pub_date и т.д.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

pageNumberTpl - Шаблон для показа номеров страниц в кратком обзоре галереи.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/pagenumbertpl.html
[+maxigallery.pageurl+] URL к странице
[+maxigallery.pagenumber+] Номер страницы
[+maxigallery.pagecount+] Общее число страниц
[+maxigallery.currentpage+] Номер текущей страницы
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

draggableTpl - Шаблон для ручной сортировки изображений галереи.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/draggabletpl.html
[+maxigallery.path+] Путь к папке MaxiGallery
[+maxigallery.path_to_gal+] Путь к текущему изображению галереи, например: assets/galleries/120/
[+maxigallery.pageinfo.fieldname+] Поле документа MODx, в котором находится галерея. "fieldname" может быть pagetitle, longtitle, pub_date и т.д.
[+maxigallery.strings.keyname+] Текст из языкового файла MaxiGallery. "keyname" может быть click_to_zoom, previous, next и т.д.
[+maxigallery.config.parameter+] Значение параметра сниппета. "parameter" - любой из параметров сниппета.

clearerTpl - Шаблон используемый при использовании параметра pics_per_row.

Шаблон по умолчанию находится в файле: assets/snippets/maxigallery/templates/clearertpl.html
Нет используемых плэйсхолдеров

Примеры

Загрузка изображений с помощью FTP

1. Определяем ID галереи, в которую необходимо закачать изображения. К примеру, эта галерея имеет ID 89.

2. Создаем папку /assets/galleries/89 если такой папки еще не существует. Если в этой галерее уже существует несколько изображений, загруженных через MaxiGallery то такая папка должна уже существовать.

3. Права на папку должны быть 777.

4. Закачиваем в папку 89 изображения с помощью FTP.

5. Права на изображения должны быть 666.

6. Переходим к управлению изображениями в MaxiGallery и нажимаем кнопку "Пересинхронизировать Галерею".

Простой вызов

Создайте новый документ в дереве документов MODx и поместите в нем вызов сниппета:

[!MaxiGallery!]

Примечание: управление изображениями галереи (загрузка, сортировка, удаление) осуществляется не в административной панели а на странице с выводом галереи .

При таком вызове на странице галереи отобразится кнопка для управления изображениями: "Manage pictures". Эта кнопка будет видна только авторизованным пользователям. Нажав на эту кнопку вы попадете на страницу с формой загрузки изображений. Все изображения загружаются в папку assets/galleries/ID-галереи/ где ID-галереи - это ID документа MODx, в котором помещен вызов галереи.

Вызов с дополнительными параметрами

[!MaxiGallery? &lang=`ru-utf8` &display=`embedded` &embedtype=`slimbox` &pics_per_row=`3` &max_thumb_size=`110` &max_pic_size=`0` &thumb_use_dropshadow=`1`!]

где:

  • &lang=`ru-utf8` - подключаем языковой файл (см. Русский язык в MaxiGallery) По умолчанию en.
  • &display=`embedded` - выбираем тип галереи (по умолчанию normal).
  • &embedtype=`slimbox` - выбираем эффект смены изображений (только для типа галереи embedded).
  • &pics_per_row=`3` - определяем количество эскизов в одном ряду (по умолчанию 4).
  • &max_thumb_size=`110` - выбираем размер эскиза (по умолчанию 130).
  • &max_pic_size=`0` - устанавливаем размер нормального изображения как оригинальное (по умолчанию 450).
  • &thumb_use_dropshadow=`1` - включаем отображение тени у эскизов.

Добавляем водяные знаки

[!MaxiGallery? &lang=`ru-utf8` &pics_per_row=`3` &max_thumb_size=`110` &max_pic_size=`400` &keep_bigimg=`1` &big_img_linkstyle=`popup`  &pic_use_watermark=`1` &pic_watermark_type=`image`!]

где:

  • &keep_bigimg=`1` - сохраняем оригинал изображения.
  • &big_img_linkstyle=`popup` - выбираем способ отображения больших изображений.
  • &pic_use_watermark=`1` - включаем использование водяных знаков для изображений нормального размера.
  • &pic_watermark_type=`image` - устанавливаем тип водяного знака для нормальных изображений в виде картинки. Мы можем использовать собственную картинку для водяного знака, указав к ней путь с помощью параметра &pic_watermark_img=`путь к картинке`.

Вывод дочерних галерей

Создадим в папке Галереи несколько дочерних галерей Галерея 1, Галерея 2 и т.д. и загрузим фотографии. Мы можем вывести список всех дочерних галерей разместив в родительской папке Галереи такой вызов сниппета.

[!MaxiGallery? &lang=`ru-utf8` &display=`childgalleries` &childgalleries_ids=`all` &order_by=`random` &childgalleries_order_by=`createdon`!]

где:

  • &display=`childgalleries` - определяем тип галереи.
  • &childgalleries_ids=`all` - включаем отображение всех дочерних галерей. Мы также можем указать только определенные галереи, указав список ID галерей через запятую.
  • &order_by=`random` - включаем отображение случайного изображения из дочерней галереи.
  • &childgalleries_order_by=`createdon` - поле, по которому сортируются дочерние галереи.

Вывод заданных дочерних галерей

[!MaxiGallery? &lang=`ru-utf8`&display=`childgalleries` &childgalleries_ids=`67,5`!]

где:

  • &childgalleries_ids=`67,5` - задаем ID галерей, которые необходимо вывести.

Фотоблог с Jot

1. Создайте новый чанк, например, mgPictureTplComment и поместите в него код из файла maxigallery/templates/picturetpl.html.

2. В этот шаблон добавьте вызов Jot (вы можете изменять все параметры сниппета, кроме &tagid):

[[Jot? &subscribe=`1` &tagid=`[+maxigallery.picture.id+]` &pagination=`10` &badwords=`something` &customfields=`name,email` &canmoderate=`Jot Moderators` &trusted=`Jot Trusted Users`]]

3. Создайте новую галерею и поместите такой вызов сниппета (добавьте к вызову любые параметры, которые вы хотите):

[!MaxiGallery? &pictureTpl=`mgPictureTplComment`!]

Изображения и эскизы на одной странице

Этот пример показывает, как сделать собственный шаблон, чтобы получить эскизы и картины в одном документе и добавить изменение изображения с помощью JavaScript.

1. Создаем вызов сниппета, отображающий список эскизов:

[!MaxiGallery? &galleryPictureTpl=`mgGalleryPicture` &js=`mgJs`!]

2. Создаем чанк mgGalleryPicture , который будет использоваться при просмотре эскизов:

<li>
       <a href="javascript:void(0);"onClick="javascript:showPic('[(base_url)][+maxigallery.path_to_gal+][+maxigallery.picture.filename+]','[+maxigallery.picture.title:htmlent+]','[+maxigallery.picture.descr:htmlent+]',[+maxigallery.picture_width_normal+],[+maxigallery.picture_height_normal+]);return false;">
               <img src="[(base_url)][+maxigallery.path_to_gal+]tn_[+maxigallery.picture.filename+]" class="thumbnail" title="[+maxigallery.picture.title:htmlent+]" alt="[+maxigallery.picture.title:htmlent+]" />
       </a>
</li>

3. Создаем чанк mgJs с JavaScript, котрый будем использовать для переключения изображений. (Можно также создать его как внешний файл .js и определить путь к нему в параметре &js):

<script type="text/javascript">
function showPic(url,title,descr,width,height) {
       var img = document.getElementById('maxImage');
       var titleHolder = document.getElementById('maxTitle');
       var descrHolder = document.getElementById('maxDescr');
       var newImg = new Image();
       newImg.onLoad = doImage(img,url,width,height);
       if (titleHolder != null) {
               for (var i = 0; i < titleHolder.childNodes.length; i++) {
                       titleHolder.removeChild(titleHolder.childNodes[i]);
               };
               if (title != "") {
                       var node=document.createTextNode(title);
               }
               else {
                       var node=document.createTextNode("");
               }
               titleHolder.appendChild(node);
       }
       if (descrHolder != null) {
               for (var i = 0; i < descrHolder.childNodes.length; i++) {
                       descrHolder.removeChild(descrHolder.childNodes[i]);
               };
               if (descr != "") {
                       var node=document.createTextNode(descr);
               }
               else {
                       var node=document.createTextNode("");
               }
               descrHolder.appendChild(node);
       }
}
 
function doImage(img,url,width,height) {
img.src=url;
}
</script>

4. Создаем еще ​​один вызов снипеета, чтобы показать изображение. Мы используем параметр &display=`pictureview`, чтобы показывать изображение в режиме просмотра по умолчанию. Если вы используете какие-то другие параметры сортировки, чем использующиеся по умолчанию, добавьте их в этот вызов сниппета, так он получает первое изображение автоматически.

[!MaxiGallery? &pictureTpl=`mgPicture` &display=`pictureview`!]

5. Создаем чанк mgPicture для показа одного изображения:

<div class="picturecontainer">
       <img id="maxImage" src="[(base_url)][+maxigallery.path_to_gal+][+maxigallery.picture.filename+]" alt="[+maxigallery.picture.title:htmlent+]" />
       <p id="maxTitle">[+maxigallery.picture.title:htmlent+]</p>
       <p id="maxDescr">[+maxigallery.picture.descr:htmlent+]</p>
</div>

Всплывающее окно с эскизами

Этот пример показывает, как сделать всплывающее окно с эскизами изображений, которое имеет prev/next ссылки.

1. Создайте новый документ для всплывающего окна. Выберите шаблон blank, снимите флажок с Показывать в меню. В содержимое документа поместите следующий код:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<base href="[(site_url)]" />
<title>[(site_name)] | [*pagetitle*]</title>
</head>
<body
[!MaxiGallery? &is_target=`1`!]
</body>
</html>

2. Создайте новый документ для показа эскизов и поместите в него ттакой вызов сниппета. Замените <docid> на идентификатором документа, который вы сделали в шаге 1:

[!MaxiGallery? &js=`mgJs` &galleryPictureTpl=`mgGalleryPicture` &picture_target=`<docid>`!]

3. Создать чанк mgJs, содержащий JavaScript, открывающий всплывающее окно. Измените ширину и высоту окна на необходимые:

 <script type="text/javascript">
function openWindow(URL) {
       var day = new Date();
       var id = day.getTime();
       var width=600;
       var height=600;
       var left = Math.floor( (screen.width - width) / 2);
       var top = Math.floor( (screen.height - height) / 2);
       var str = "page" + id + " = window.open('" + URL + "', '" + id +
"','toolbar=0,scrollbars=0,location=0,statusbar=0,menubar=0,resizable=0,width="
+ width + ",height=" + height + ",left=" + left + ",top=" + top +
"');";
       eval(str);
       if (window.focus) {eval("page"+id+".focus();");}
}
</script>

4. Создайте чанк mgGalleryPicture с шаблоном, который будет использоваться при просмотре эскизов:

<li>
       <a href="javascript:void(0);"onClick="javascript:openWindow('[+maxigallery.picture_link_url+]');return false;">
               <img src="[(base_url)][+maxigallery.path_to_gal+]tn_[+maxigallery.picture.filename+]" class="thumbnail" title="[+maxigallery.strings.click_to_zoom+]" alt="[+maxigallery.picture.title:htmlent+]" />
       </a>
       <p style="width: [+maxigallery.picture_width_thumb+]px;">
               [+maxigallery.picture.title:htmlent+]
       </p>
</li>

Поделитесь ссылкой

Статистика

Яндекс цитирования
© 2011 - 2016 Школа MODX