MODx/Подключаемые сниппеты/MaxiGallery
Параметры
[править]Маски и водяные знаки
[править]Маски и водяные знаки для Больших Изображений
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&big_use_imagemask Использовать imagemask для больших изображений. |
|
0 |
|
&big_mask_img Путь к изображению которые вы хотели бы использовать как imagemask для больших изображений (Изображение — водяной знак). |
path |
assets/snippets/ |
|
&big_mask_bgcolor Маска цвета заднего фона для больших картинок. Должна быть того же цвета что и задний фон. |
RGB Hexadecimal |
FFFFFF |
|
&big_mask_position Расположение Изображение — водяной знак для больших картинок. Опция resize изменяет размер imagemask до размера изображения. |
|
resize |
|
&big_use_watermark Использовать Watermark (Вод знаки, текстовые) для больших изображений. |
|
0 |
|
&big_watermark_font размер шрифта для водяных знаков. |
|
5 |
|
&big_watermark_halign опция расположения вод знаков по горизонтали. |
|
right |
|
&big_watermark_img Путь к картинке — вод знаку. Она может быть прозрачным png. Сделайте её края прозрачными. |
path |
assets/snippets/ |
|
&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 Тип водяного знака: Текстовый или изображение (определенное пользователем). |
|
text |
|
&big_watermark_valign Вертикальное расположение водяного знака. |
|
bottom |
Маски и водяные знаки для Средних Изображений
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&pic_use_imagemask Параметр включающий использование Изображение- маску. |
|
0 |
|
&pic_mask_img Путь к изображению маски. |
path |
assets/snippets |
|
&pic_watermark_img Путь к изображениям. Используйте png изображение с прозрачным первым слоем (Бекграундом). |
path |
assets/snippets |
|
&pic_mask_position Положение маски. Положение resize растягивает изображение маски на всю картинку. |
|
resize |
|
&pic_use_watermark Использование водяных знаков (текст). |
|
0 |
|
&pic_watermark_font Размер шрифта для текстовых водяных знаков. |
|
3 |
|
&pic_watermark_halign Расположения Знаков по горизонтали. |
|
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 Определяет тип используемого водного знака — текст или изображение, определенное пользователем. |
|
text |
|
&pic_watermark_valign Вертикальное выравнивание водяного знака. |
|
bottom |
Маски и водяные знаки для Предварительного просмотра
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&thumb_mask_bgcolor Цвет фона маски для эскизов изображений. Должен быть таким же, как и цвет фона страницы. |
RGB Hexadecimal |
FFFFFF |
|
&thumb_mask_img Путь к изображению imagemask, которое должно быть применено к эскизам изображений. |
path |
assets/snippets |
|
&thumb_mask_position Позиция Imagemask. Опция resize — подгоняет размер imagemask к размеру изображения. |
|
resize |
|
&thumb_use_imagemask Применить imagemask к изображениям эскиза. |
|
0 |
|
&thumb_use_watermark Использовать водный знак(watermark) для эскизов. |
|
0 |
|
&thumb_watermark_font Размер шрифта водяного знака. |
|
1 |
|
&thumb_watermark_halign Горизонтальный выравнивание текста водяного знака. |
|
right |
|
&thumb_watermark_img Путь к изображению водяного знака. Используйте png изображение с прозрачным фоном или alpha каналом. |
path |
assets/snippets |
|
&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 Определяет тип используемого водного знака — текст или изображение, определенное пользователем. |
|
text |
|
&thumb_watermark_valign Вертикальное выравнивание водяного знака. |
|
bottom |
Другое
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&big_shadow_bgcolor Цвет тени для больших изображений. Должен быть таким же, как и цвет фона страницы. |
RGB Hexadecimal |
FFFFFF |
|
&big_shadow_path Путь к вашему изображению заднего фона, если не хотите использовать стандартные. |
path |
assets/snippets |
|
&big_use_dropshadow Отбрасывание тени для больших изображений. |
|
0 |
параметр child galleries
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&childgalleries_ids Родительская галерея, отображает дочерние галереи. |
|
Текущий документ |
|
&childgalleries_level_limit Определяет сколько уровней из родительской галереи перечислить. Ноль — все уровни. |
Number |
0 |
|
&childgalleries_limit Определяет сколько дочерних галерей необходимо отобразить. Значение 0 служит для вывода всех дочерних галерей. |
Number |
0 |
|
&childgalleries_order_by Имя поля по которому нужно произвести сортировку галерей. |
MODx document object field. |
menuindex |
|
&childgalleries_order_direction Направление сортировки дочерних галерей: ascending (по возрастанию) или descending (по убыванию). |
|
ASC |
| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&debug Показывает некоторую отладочную информацию на странице MaxiGallery. (функция до конца не реализована). |
|
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 |
|
&disable_rightclick Включает javascript отключающий 'правый клик', чтобы не было возможности сохранять картинки. |
|
0 |
Внешний вид
[править]Просто
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&display Выбор типа галереи. |
|
normal |
|
&embedtype Если в &display указан параметр «embedded», этим параметром можно регулировать эффекты. «External» откроет картинку на другой странице. |
|
|
|
&big_img_linkstyle Описывает способ отображения Больших картинок. |
|
external |
|
&keep_bigimg Сохранять оригинал изображения. |
|
false |
|
&max_big_size Размер большого изображения. Размер в пикселях желаемого изображения, или ноль для использования оригинального размера изображения. |
|
1024 |
|
&max_pic_size Размер среднего (нормального) изображения. Размер в пикселях желаемого изображения, или ноль для использования оригинального размера изображения. |
|
450 |
|
&max_thumb_size Размер маленького изображения (превью). Размер в пикселях желаемого изображения, или ноль для использования оригинального размера изображения. |
|
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 |
|
&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 |
|
&smoothgallery_showArrows Show the next — back arrows in the slideshow. |
|
true |
|
&smoothgallery_showCarousel Show the thumbnails in carousel mode when using slideshow. |
|
true |
|
&smoothgallery_showInfopane Show the info pane (this is the picture title and description). |
|
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. |
|
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 Шаблон для попап окна ручной сортировки (перетаскивания мышью) фотографий альбома. |
|
@FILE:assets/snippets |
|
[[MaxiGallery#childgalleryTpl|childgalleryTpl]] Шаблон используемый для отображения дочерней галереи (image) В предпросмотре галерей. |
|
@FILE:assets/snippets |
|
[[MaxiGallery#clearerTpl|clearerTpl]] Шаблон используемый при вызове параметра &pics_per_row. |
|
@FILE:assets/snippets |
|
[[MaxiGallery#galleryOuterTpl|galleryOuterTpl]] Внешний шаблон для краткого обзора галереи |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#galleryPictureTpl|galleryPictureTpl]] The template for each picture element (thumbnail) in the gallery overview. |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#manageOuterTpl|manageOuterTpl]] Внешний шаблон для управления галереей. |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#managePictureTpl|managePictureTpl]] Шаблон для одного элемента фотографии в управлении галереей. |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#manageButtonTpl|manageButtonTpl]] Шаблон для кнопки управления фотографиями. |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#manageUploadTpl|manageUploadTpl]] The template for the file upload rows in gallery management. |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#pageNumberTpl|pageNumberTpl]] Шаблон для показа номеров страниц в кратком обзоре галереи. |
|
@FILE:/assets/snippets |
|
[[MaxiGallery#pictureTpl|pictureTpl]] Шаблон для предпросмотра фотографии. |
|
@FILE:/assets/snippets |
Внешний вид через css
[править]| Параметр | Возможные значения | По умолчанию |
|---|---|---|
|
&css Путь к стилю (css) используему для оформления галереи, или имя чанка, содержащего css, или css код. |
|
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 |
Модифицированная 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. |
|
|
|
>able 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 |
|
&js Link to an extra javascript file supporting a gallery or chunk name or javascript code as text. |
|
|
|
&keep_date When modifying an image title or description, keep the original upload date. |
|
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 |
|
&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. |
|
pos, date |
|
&order_direction Sort order direction: ascending or descending. |
|
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 |
|
&pic_use_dropshadow Apply a dropshadow to normal pictures. |
|
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 |
|
&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 |
|
&thumb_use_dropshadow Apply a dropshadow to thumbnail pictures. |
|
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 |