MODx/Подключаемые сниппеты/MaxiGallery

Материал из Викиучебника — открытых книг для открытого мира

Параметры[править]

Маски и водяные знаки[править]

Маски и водяные знаки для Больших Изображений[править]

Параметр Возможные значения По умолчанию

&big_use_imagemask

Использовать imagemask для больших изображений.

  • 0
  • 1

0

&big_mask_img

Путь к изображению которые вы хотели бы использовать как imagemask для больших изображений (Изображение — водяной знак).

path

assets/snippets/
maxigallery/
imagemask/
demomask-frame2.png

&big_mask_bgcolor

Маска цвета заднего фона для больших картинок. Должна быть того же цвета что и задний фон.

RGB Hexadecimal

FFFFFF

&big_mask_position

Расположение Изображение — водяной знак для больших картинок.

Опция resize изменяет размер imagemask до размера изображения.

  • top
  • topleft
  • topright
  • left
  • center
  • right
  • bottom
  • bottomleft
  • bottomright
  • resize

resize

&big_use_watermark

Использовать Watermark (Вод знаки, текстовые) для больших изображений.

  • 0
  • 1

0

&big_watermark_font

размер шрифта для водяных знаков.

  • 1
  • 2
  • 3
  • 4
  • 5

5

&big_watermark_halign

опция расположения вод знаков по горизонтали.

  • left
  • center
  • right

right

&big_watermark_img

Путь к картинке — вод знаку. Она может быть прозрачным png. Сделайте её края прозрачными.

path

assets/snippets/
maxigallery/watermark/
watermark.png

&big_watermark_txt

Для текстовых водяных знаков. Текст будет наложен на картинку.

text

Copyright <YEAR> <SITENAME>

&big_watermark_txt_color

Цвет текста водяного знака.

RGB Hexadecimal

FFFFFF

&big_watermark_txt_hmargin

Горизонтальное расположение текстового водяного знака (в pixels).

число (px)

15

&big_watermark_txt_vmargin

Вертикальное расположение текстового водяного знака (в pixels).

Число (px)

15

&big_watermark_type

Тип водяного знака: Текстовый или изображение (определенное пользователем).

  • image
  • text

text

&big_watermark_valign

Вертикальное расположение водяного знака.

  • top
  • center
  • bottom

bottom

Маски и водяные знаки для Средних Изображений[править]

Параметр Возможные значения По умолчанию

&pic_use_imagemask

Параметр включающий использование Изображение- маску.

  • 0
  • 1

0

&pic_mask_img

Путь к изображению маски.

path

assets/snippets
/maxigallery/imagemask
/demomask-frame2.png

&pic_watermark_img

Путь к изображениям. Используйте png изображение с прозрачным первым слоем (Бекграундом).

path

assets/snippets
/maxigallery/watermark
/watermark.png

&pic_mask_position

Положение маски. Положение resize растягивает изображение маски на всю картинку.

  • top
  • topleft
  • topright
  • left
  • center
  • right
  • bottom
  • bottomleft
  • bottomright
  • resize

resize

&pic_use_watermark

Использование водяных знаков (текст).

  • 0
  • 1

0

&pic_watermark_font

Размер шрифта для текстовых водяных знаков.

  • 1
  • 2
  • 3
  • 4
  • 5

3

&pic_watermark_halign

Расположения Знаков по горизонтали.

  • left
  • center
  • right

right

&pic_watermark_txt

Текст водного знака (watermark), который будет применен к изображениям.

text

Copyright <YEAR> <SITENAME>

&pic_watermark_txt_color

Цвет текста для водного знака.

RGB Hexadecimal

FFFFFF

&pic_watermark_txt_hmargin

Края(margin) по-горизонтали для водного знака (в пикселах).

Number (px)

10

&pic_watermark_txt_vmargin

Края(margin) по-вертикали для водного знака (в пикселах).

Number (px)

10

&pic_watermark_type

Определяет тип используемого водного знака — текст или изображение, определенное пользователем.

  • image
  • text

text

&pic_watermark_valign

Вертикальное выравнивание водяного знака.

  • top
  • center
  • bottom

bottom

Маски и водяные знаки для Предварительного просмотра[править]

Параметр Возможные значения По умолчанию

&thumb_mask_bgcolor

Цвет фона маски для эскизов изображений. Должен быть таким же, как и цвет фона страницы.

RGB Hexadecimal

FFFFFF

&thumb_mask_img

Путь к изображению imagemask, которое должно быть применено к эскизам изображений.

path

assets/snippets
/maxigallery/imagemask
/demomask-frame1.png

&thumb_mask_position

Позиция Imagemask. Опция resize — подгоняет размер imagemask к размеру изображения.

  • top
  • topleft
  • topright
  • left
  • center
  • right
  • bottom
  • bottomleft
  • bottomright
  • resize

resize

&thumb_use_imagemask

Применить imagemask к изображениям эскиза.

  • 0
  • 1

0

&thumb_use_watermark

Использовать водный знак(watermark) для эскизов.

  • 0
  • 1

0

&thumb_watermark_font

Размер шрифта водяного знака.

  • 1
  • 2
  • 3
  • 4
  • 5

1

&thumb_watermark_halign

Горизонтальный выравнивание текста водяного знака.

  • left
  • center
  • right

right

&thumb_watermark_img

Путь к изображению водяного знака. Используйте png изображение с прозрачным фоном или alpha каналом.

path

assets/snippets
/maxigallery/watermark
/watermark.png

&thumb_watermark_txt

Текст водяного знака, который будет применен к изображениям.

text

Copyright <YEAR>

&thumb_watermark_txt_color

Цвет водяного знака.

RGB Hexadecimal

FFFFFF

&thumb_watermark_txt_hmargin

Горизонтальный отступ к тексту водяного знака.

Number (px)

2

&thumb_watermark_txt_vmargin

Вертикальный отступ текста водяного знака.

Number (px)

2

&thumb_watermark_type

Определяет тип используемого водного знака — текст или изображение, определенное пользователем.

  • image
  • text

text

&thumb_watermark_valign

Вертикальное выравнивание водяного знака.

  • top
  • center
  • bottom

bottom

Другое[править]

Параметр Возможные значения По умолчанию

&big_shadow_bgcolor

Цвет тени для больших изображений. Должен быть таким же, как и цвет фона страницы.

RGB Hexadecimal

FFFFFF

&big_shadow_path

Путь к вашему изображению заднего фона, если не хотите использовать стандартные.

path

assets/snippets
/maxigallery/dropshadow/

&big_use_dropshadow

Отбрасывание тени для больших изображений.

  • 0
  • 1

0

параметр child galleries[править]

Параметр Возможные значения По умолчанию

&childgalleries_ids

Родительская галерея, отображает дочерние галереи.

  • Разделяемый запятыми список ID для поиска галерей в них.
  • «all» отобразить все галереи.

Текущий документ

&childgalleries_level_limit

Определяет сколько уровней из родительской галереи перечислить. Ноль — все уровни.

Number

0

&childgalleries_limit

Определяет сколько дочерних галерей необходимо отобразить. Значение 0 служит для вывода всех дочерних галерей.

Number

0

&childgalleries_order_by

Имя поля по которому нужно произвести сортировку галерей.

MODx document object field.

menuindex

&childgalleries_order_direction

Направление сортировки дочерних галерей: ascending (по возрастанию) или descending (по убыванию).

  • ASC
  • DESC

ASC

Параметр Возможные значения По умолчанию

&debug

Показывает некоторую отладочную информацию на странице MaxiGallery. (функция до конца не реализована).

  • 0
  • 1

0

&disable_js_libs

Используется когда MooTools, Prototype или Scriptaculous javascript библиотеки вызваны в заголовке шаблона сайта и вы хотите чтобы MaxiGallery не подгружал свои копии этих библиотек. (Used when MooTools, Prototype or Scriptaculous javascript libraries are linked in the head of the site template and you want to prevent MaxiGallery from calling them also.)

  • 0
  • 1

0

&disable_rightclick

Включает javascript отключающий 'правый клик', чтобы не было возможности сохранять картинки.

  • 0
  • 1

0

Внешний вид[править]


Просто[править]

Параметр Возможные значения По умолчанию

&display

Выбор типа галереи.

  • normal — Простая
  • embedded — с наворотами от ajax
  • childgalleries — список дочерних галерей
  • pictureview

normal

&embedtype

Если в &display указан параметр «embedded», этим параметром можно регулировать эффекты. «External» откроет картинку на другой странице.

  • slidebox
  • lightboxv2
  • slimbox
  • smoothgallery
  • popup
  • external

&big_img_linkstyle

Описывает способ отображения Больших картинок.

  • slidebox
  • lightboxv2
  • popup
  • external

external

&keep_bigimg

Сохранять оригинал изображения.

  • false
  • true

false

&max_big_size

Размер большого изображения. Размер в пикселях желаемого изображения, или ноль для использования оригинального размера изображения.

  • Число (px)
  • WidthxHeight (px) (eg. 200x400)

1024

&max_pic_size

Размер среднего (нормального) изображения. Размер в пикселях желаемого изображения, или ноль для использования оригинального размера изображения.

  • Number (px)
  • WidthxHeight (px) (eg. 200x400)

450

&max_thumb_size

Размер маленького изображения (превью). Размер в пикселях желаемого изображения, или ноль для использования оригинального размера изображения.

  • Number (px)
  • WidthxHeight (px) (eg. 200x400)

130

&pics_per_page

Количество эскизов изображений на одной странице. Ноль — бесконечно.

Number

0

&pics_per_row

Количество эскизов, умещаемых в одном ряду.

Number

4


Параметры Smooth Gallary[править]
Параметр Возможные значения По умолчанию

&smoothgallery_carouselMaximizedOpacity

Значение непрозрачности для carousel, когда она развернута.

Where:

0 = is transparent (not visible) and 1.0 = is totally opaque

Number

0.7

&smoothgallery_carouselMinimizedHeight

Высота carousel в свернутом виде (в пикселях).

Number (px)

20

&smoothgallery_carouselMinimizedOpacity

Значение непрозрачности для carousel, когда она свернута.

Where:

0 = is transparent (not visible) and 1.0 = is totally opaque

Number

0.4

&smoothgallery_delay

Delay in milliseconds for the timed slideshow picture change.

Number (ms)

9000

&smoothgallery_embedLinks

Open picture by clicking on the slide.

NOTE: if you remove this parameter, also remove the link tags from galleryPictureTpl

  • true
  • false

true

&smoothgallery_fadeDuration

Duration in milliseconds of the fade effect.

Number (ms)

500

&smoothgallery_height

Height in pixels for the smoothgallery div. Overflow will be hidden, so this should be the height of biggest picture (eg. same as max_pic_size).

Number (px)

max_pic_size

&smoothgallery_id

Individual id for the smoothgallery instance. This allows to have multiple smoothgalleries in one page.

Text

Gallery id

&smoothgallery_preloader

Preload the pictures.

  • true
  • false

true

&smoothgallery_showArrows

Show the next — back arrows in the slideshow.

  • true
  • false

true

&smoothgallery_showCarousel

Show the thumbnails in carousel mode when using slideshow.

  • true
  • false

true

&smoothgallery_showInfopane

Show the info pane (this is the picture title and description).

  • true
  • false

true

&smoothgallery_slideInfoZoneOpacity

Opacity value in % for the info pane. This determines the visibility of the infopane.

Where:

0 = is transparent (not visible) and 1.0 = is totally opaque

Number

0.7

&smoothgallery_textShowCarousel

Text that is shown in the carousel.

text

'pictures' text from the the language file

&smoothgallery_thumbHeight

Height of the thumnails, in pixels, in the SmoothGallery carousel.

Number (px)

75

&smoothgallery_thumbSpacing

Space in pixels between thumbnails in the SmoothGallery carousel.

Number (px)

10

&smoothgallery_thumbWidth

Width in pixels of the thumbnails in SmoothGallery carousel.

Number (px)

100

&smoothgallery_timed

Change the image in a timed slideshow mode.

  • true
  • false

false

&smoothgallery_width

Width in pixels, for the smoothgallery div. Overflow (of the picture) will be hidden, so this should be the maximum width of the biggest picture (eg. same as max_pic_size).

(px)

max_pic_size

Tpl[править]



Параметр Возможные значения По умолчанию

&draggableTpl

Шаблон для попап окна ручной сортировки (перетаскивания мышью) фотографий альбома.

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:assets/snippets
/maxigallery/templates
/draggabletpl.html

[[MaxiGallery#childgalleryTpl|childgalleryTpl]]

Шаблон используемый для отображения дочерней галереи (image) В предпросмотре галерей.

  • Имя чанка
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:assets/snippets
/maxigallery/templates
/childgallerytpl.html

[[MaxiGallery#clearerTpl|clearerTpl]]

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

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:assets/snippets
/maxigallery/templates
/clearertpl.html

[[MaxiGallery#galleryOuterTpl|galleryOuterTpl]]

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

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/galleryoutertpl.html

[[MaxiGallery#galleryPictureTpl|galleryPictureTpl]]

The template for each picture element (thumbnail) in the gallery overview.

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/gallerypicturetpl.html

[[MaxiGallery#manageOuterTpl|manageOuterTpl]]

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

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/manageoutertpl.html

[[MaxiGallery#managePictureTpl|managePictureTpl]]

Шаблон для одного элемента фотографии в управлении галереей.

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/managepicturetpl.html

[[MaxiGallery#manageButtonTpl|manageButtonTpl]]

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

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/managebuttontpl.html

[[MaxiGallery#manageUploadTpl|manageUploadTpl]]

The template for the file upload rows in gallery management.

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/manageuploadtpl.html

[[MaxiGallery#pageNumberTpl|pageNumberTpl]]

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

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/pagenumbertpl.html

[[MaxiGallery#pictureTpl|pictureTpl]]

Шаблон для предпросмотра фотографии.

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

@FILE:/assets/snippets
/maxigallery/templates
/picturetpl.html

Внешний вид через css[править]


Параметр Возможные значения По умолчанию

&css

Путь к стилю (css) используему для оформления галереи, или имя чанка, содержащего css, или css код.

Examples:
assets/css/gallery.css
MaxigalleryCss
<style>.classname{}</style>

  • Chunk name
  • path to a file
  • template string

assets/snippets/maxigallery/ css/default.css

Пользователи и группы, прочий менеджмент[править]

Параметр Возможные значения По умолчанию

&admin_webgroups

Web названия групп веб пользователей, которые могут редактировать галерею.

Разделённые запятой названия групп веб пользователей

&admin_webusers

Названия веб пользователей, которые могут редактировать галерею.

Разделённые запятой имена веб пользователей

&manage_gallery

ID of the gallery to be managed. The ID of the document (page) that has the gallery call. Use this to avoid going to the gallery page. Set the same parameters as used in the gallery itself.

Document id

&manage_target

ID of the document that will be used for managing the pictures. Use the same snippet call in that target document and add the parameter: &is_target=`1` to the call.

Document id

&manager_webgroups

Comma delimited web groups that can post pictures to this gallery and can manage their own pictures.

Comma delimited list of web groups.

&manager_webusers

Comma delimited web user names that can post pictures to this gallery and can manage their own pictures.

Comma delimited list of web users.

FTP[править]

Параметр Возможные значения По умолчанию

&ftp_base_dir

Path to go from FTP root to MODx installation root. Eg. if your FTP root directory is /home/username/ and MODx is installed in /home/username/public_html/modx/ you would use /public_html/modx/ as ftp_base_dir.

path

&ftp_pass

FTP account password

password

&ftp_port

Port number for the FTP service.

number

21

&ftp_server

FTP address to the server running MODx.

FTP address

&ftp_user

FTP account username

username

&use_ftp_commands

If enabled, MaxiGallery uses PHP FTP commands to create filesystem folders for the gallery pictures. This is needed in certain server environments.

  • 0
  • 1

0

Модифицированная Maxigallery[править]

Вырезка заданных размеров
Администраторский интерфейс модифицированной Maxigallery

Модифицированна Maxigallery имеет ряд дополнительных возможностей, а также улучшений, по сравнению с базовой. Ниже приведён список нового функционала Maxigallery.

  • Новые опции которые указывают на необходимость приведения изображения к точно заданным размерам, это весьма удобно так как thumbs получаются одного размера и весьма хорошо смотрятся на сайте. Также возможно указать откуда начинается вырезка изображения, с верхнего левого угла или от центра.
  • Maxigallery JQuery. Доступны новые плагины для отображения галереи совместимые и основанные на библиотеке JQuery
  • Maxigallery Highslide. Доступен новый плагин для отображения галереи на базе javascript фреймворка Highslide
  • Новый интерфейс режима администрирования. Довольно часто у меня админский интерфейс выходил не так как бы мне этого хотелось, поэтому в модифицированной версии администраторский интерфейс отстранён от дизайна сайта. (см. скриншоты)
  • Интеграция с модулем smartConfig (теперь не надо писать ручками параметры в вызове сниппета).

для перевода[править]

Параметр Возможные значения По умолчанию

&gal_query_ids

ID’s of the documents from which you want to retrieve pictures.

  • Comma delimited list of document ID’s
  • «all» to get pictures from all galleries

&gtable

Name of the database table for the gallery (modx table prefix is added)

text

maxigallery

&is_target

Determines if the document is to be the target for picture browsing mode or picture manager mode.

  • 0
  • 1

0

&js

Link to an extra javascript file supporting a gallery or chunk name or javascript code as text.

Examples:
/assets/js/gallery.js
MaxigalleryJs
<scripttype="text/javascript">
alert(hello);</script>

  • path
  • chunk name
  • text

&keep_date

When modifying an image title or description, keep the original upload date.

  • 0
  • 1

1

&lang

Sets the gallery language.

Note: Language files are not fully implemented yet. Feel free to add your language(s). (See lang_en.php for examples.)

  • en
  • fi

en

&limit

Limit value to use for the query result set.

Maximum number of rows for query.

9999999

&max_pic_number

Maximum number of images allowed in this gallery. Use zero for an unlimited number of images.

Number

0

&offset

Offset value to use for the query result set.

Number of rows to skip.

0

&order_by

The database field name to use to order the pictures by. If «random» is used maxigallery will show pictures in a random order or will display a random picture in the childgalleries display mode.

  • date
  • pos
  • filename
  • title
  • id
  • random

pos, date

&order_direction

Sort order direction: ascending or descending.

  • ASC
  • DESC

DESC

&pic_query_ids

ID’s of single pictures to retrieve.

Comma delimited list of picture ID’s

&pic_shadow_bgcolor

Shadow background color for normal pics. This should be the same color as page background color.

RGB Hexadecimal

FFFFFF

&pic_shadow_path

Path to the shadow images to be used, if you don’t wish to use the default shadow images.

path

assets/snippets
/maxigallery/dropshadow/

&pic_use_dropshadow

Apply a dropshadow to normal pictures.

  • 0
  • 1

0

&pic_mask_bgcolor

Mask background color for normal pics. This should be the same color as the page background color.

RGB Hexadecimal

FFFFFF

&picture_target

ID of the document that will be used for browsing the pictures. Use the same snippet call in that target document and add the parameter: &is_target=`1` to the call.

Document id

Current document

&pictureview_start_id

If pictureview display mode is used, this parameter can be used to define the picture id from which to start automatically.

Picture id

&pictureview_start_pos

If pictureview display mode is used, this parameter can be used to define the position from which to start automatically.

Picture number to start from

First picture

&quality_big

The quality of the big picture. A percentage between 0-100 for the big images.

Number (%)

100

&quality_pic

The quality. Percentage between 0-100 for the normal images.

Number (%)

70

&quality_thumb

The quality percentage between 0-100 for the thumbnail images.

Number (%)

70

&query_level_limit

Defines how many levels deep to go from the parent in gal_query_ids documents.

Number

1

&random_filenames

If enabled, this will apply generated random filenames to uploaded pictures.

  • 0
  • 1

0

&thumb_shadow_bgcolor

The shadow background color for thumbnail pics. This should be the same color as page background color.

RGB Hexadecimal

FFFFFF

&thumb_shadow_path

The path to the dropshadow images. If you do not wish to use the default shadow images, set this to the path to your shadow images.

path

assets/snippets
/maxigallery/dropshadow/

&thumb_use_dropshadow

Apply a dropshadow to thumbnail pictures.

  • 0
  • 1

0

&upload_field_count

The number of upload fields to show in the manager view.

Number

10

&view_gallery

Show a childgallery from a document (page) other than the gallery parent document. Use the ID of the document that contains the childgallery call of the childgallery you wish to use.

Document ID