Сніппет 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 і знайдіть в ньому рядок
Змініть в ній назву папки:
4. Помістіть вміст архіву в кореневу папку сайту. Файли будуть скопійовані в правильне місце.
5. Створіть новий сниппет MaxiGalleryNew і помістіть в нього код з файлу maxigallery.txt.
6. Використовуйте наступний виклик сниппета: MaxiGalleryNew.
відомі проблеми
При виникненні помилки
замініть в файлі maxigallery.class.inc.php в рядку 242 застарілу функцію split на explode.
Спочатку в MaxiGallery російська мова не входить, тому, необхідно створити власний файл з перекладом. Але так як MaxiGallery складається з декількох галерей, які додатково використовують скрипти і картинки, загальний переклад галереї на російську мову буде складатися з декількох кроків.
Створюємо файл lang_ru-utf8.php
Всі файли з мовними пакетами знаходяться в папці / assets / snippets / maxigallery / lang /. Створюємо файл lang_ru-utf8.php в цій же папці на основі одного з існуючих мовних пакетів, наприклад, lang_en.php і переводимо всі необхідні рядки. Або викачуємо готовий файл:
Не забудьте, що кодування файлу повинна бути utf-8.
Створюємо файл slidebox_lang_ru-utf8.js
Ви, напевно, звернули увагу на рядки в мовному файлі:
Тобто якщо ми збираємося створювати власний мовний файл, нам рекомендують також перевести і slidebox_lang_en.js. Діємо за тим же принципом, створюємо в папці новий файл slidebox_lang_ru-utf8.js на основі файлу slidebox_lang_en.js і переводимо його. Або викачуємо готовий файл:
Не забудьте, що і в цьому випадку кодування файлу повинна бути utf-8.
Створюємо картинки для галерей slimbox і lightboxv2
Галереї slimbox і lightboxv2 як навігації використовують картинки closelabel.gif. nextlabel.gif і prevlabel.gif. Ці картинки знаходяться в папках:
Щоб і в цих галереях навігація стала російською мовою, створюємо власні картинки і замінюємо ними картинки з англійською мовою. Ви можете створити власні картинки або завантажити готові:
Виклик русифікованої MaxiGallery
Щоб підключити російський мовний файл, не забудьте при виклику MaxiGallery використовувати наступний параметр:
Завантаження зображень за допомогою FTP
1. Визначаємо ID галереї. в яку необхідно закачати зображення. Наприклад, ця галерея має ID 89.
2. Створюємо папку / assets / galleries / 89 якщо такий папки ще не існує. Якщо в цій галереї вже існує кілька зображень, завантажених через MaxiGallery то така папка вже має бути створена.
3. Права на папку повинні бути 777.
4. Закачуємо в папку 89 зображення за допомогою FTP.
5. Права на зображення повинні бути 666.
6. Переходимо до управління зображеннями в MaxiGallery і натискаємо кнопку "Пересінхронізіровать Галерею".
простий виклик
Створіть новий документ в дереві документів MODx і помістіть в ньому виклик сниппета:
Примітка: управління зображеннями галереї (завантаження, сортування, видалення) здійснюється не в адміністративній панелі а на сторінці з висновком галереї.
Виклик з додатковими параметрами
- 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` - включаємо відображення тіні у ескізів.
Додаємо водяні знаки
- keep_bigimg = `1` - зберігаємо оригінал зображення.
- big_img_linkstyle = `popup` - вибираємо спосіб відображення великих зображень.
- pic_use_watermark = `1` - включаємо використання водяних знаків для зображень нормального розміру.
- pic_watermark_type = `image` - встановлюємо тип водяного знака для нормальних зображень у вигляді картинки. Ми можемо використовувати власну картинку для водяного знака, вказавши до неї шлях за допомогою параметра pic_watermark_img = `шлях до картінке`.
Висновок дочірніх галерей
Створимо в папці Галереї кілька дочірніх галерей Галерея 1. Галерея 2 і т.д. і завантажимо фотографії. Ми можемо вивести список всіх дочірніх галерей розмістивши в батьківській папці Галереї такий виклик сниппета.
- display = `childgalleries` - визначаємо тип галереї.
- childgalleries_ids = `all` - включаємо відображення всіх дочірніх галерей. Ми також можемо вказати тільки певні галереї, вказавши список ID галерей через кому.
- order_by = `random` - включаємо відображення випадкового зображення з дочірньою галереї.
- childgalleries_order_by = `createdon` - поле, по якому упорядковано дочірні галереї.
Висновок заданих дочірніх галерей
- childgalleries_ids = `67,5` - задаємо ID галерей, які необхідно вивести.
Фотоблог з Jot
1. Створіть новий чанк, наприклад, mgPictureTplComment і помістіть в нього код з файлу maxigallery / templates / picturetpl.html.
2. У цей шаблон додайте виклик Jot (ви можете змінювати всі параметри сниппета, крім tagid):
3. Створіть нову галерею і помістіть такий виклик сниппета (додайте до виклику будь-які параметри, які ви хочете):
Зображення та ескізи на одній сторінці
1. Створюємо виклик сниппета, що відображає список ескізів:
5. Створюємо чанк mgPicture для показу одного зображення:
Спливаюче вікно з ескізами
Цей приклад показує, як зробити спливаюче вікно з ескізами зображень, яке має prev / next посилання.
1. Створіть новий документ для спливаючого вікна. Виберіть шаблон blank, зніміть прапорець з Показувати в меню. В вміст документа помістіть наступний код:
2. Створіть новий документ для показу ескізів і помістіть в нього ттакой виклик сниппета. замініть