Привет, земляне! Так как я являюсь обладателем сайта на такой прекрасной CMS как Joomla и у меня есть потребность выводить галереи изображений на его страницах, то для этой задачи я в свое время выбрал расширение sigplus. В данной статье я хочу рассказать о том, как я автоматизировал создание файлов с описаниями изображений.

Что из себя представляет расширение для sigplus

sigplus - это минималистичное расширение для CMS Joomla, которое позволяет выводить галереи изображений на страницах сайта, галерея добавляется на страницу с помощью одной короткой строчки кода.

Ключевые особенности:

Простой код вставки: Вставка галереи прямо в тексте статьи через команду {gallery [опции]}<путь к папке>{/gallery}.
Работа с папками: Избавляет от необходимости использования менеджера медиафайлов. Вы просто загружаете изображения в папку на сервере (например, images/gallery/content), а sigplus автоматически их подгружает.
Разные способы визуализации: Позволяет выбрать тип показа — от простой сетки миниатюр (с лайтбоксом) до каруселей и слайд-шоу (Slimbox, Fancybox, Lytebox и др.).
Автоматическая обработка: Самостоятельно создает миниатюры, накладывает водяные знаки и добавляет подписи из специальных файлов.
Настройка тем: Поддерживает кастомизацию внешнего вида через CSS-стили. Отлично адаптируется под мобильные устройства.
Мультиязычные описания изображений: расширение выводит изображения, которые находятся в папке, которая передана в коде вставки, и оно автоматически подгружает описания изображений из файла labels.txt или labels.<локаль языка>.txt, оно автоматически выбирает нужный файл в зависимости от текущего языка на сайте, поэтому для одного набора изображений можно сделать описания на разных языках.

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

Позвольте представиться, 3A Joomla

К сожалению sigplus не поставляется с инструментами для удобного создания и редактирования файлов описаний, поэтому я создал специальную утилиту на базе Pyrog - 3A Joomla (для нас русскоговорящих следует произносить как: за джумла), все справочные материалы можете найти на странице проекта.

Установка плагина

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

Но, ничего страшного, я вас быстро проведу по основным шагам:

Установите Python версией не ниже 3.13;
Скачайте файлы Pyrog и скопируйте их на свой компьютер (страница загрузки, руководство по использованию);
Скачайте файлы плагина 3A Joomla (страница загрузки, руководство по использованию));
Распакуйте файлы плагина в папку …/Pyrog/manager/plugins/3A-Joomla
Запустите скрипт …Pyrog\manager\Pyrog.pyw

Если все сделали правильно должен появится экран программы, если в поле несколько вкладок, то перейдите на вкладку 3A Joomla. Данное расширение состоит из модулей, нас интересует Sigplus filler (данная программа позиционируется как набор утилит для работы с сайтом на базе Joomla, но на данный момент она пока только одна; поэтому подписывайтесь на мой телеграмм канал, чтобы быть в курсе обновлений, все ссылки в конце статьи; также не стесняйтесь высказывать свои предложения и замечания).

Какую проблему решает Sigplus filler

Те, кто пользуется sigplus знают, а может и нет, что описания изображений хранятся в файлах labels.txt. Само расширение не помогает с создание этих файлов, поэтому приходится по дефолту брать текстовый редактор и записывать данные ручками, вот так выглядит запись описания для трех изображений

<имя файла 1>.jpg|<Заголовок файла 1>|<Описание файла 1>
<имя файла 2>.jpg|<Заголовок файла 2>|<Описание файла 2>
<имя файла 3>.jpg|<Заголовок файла 3>|<Описание файла 3>

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

Применение Sigplus filler

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

Чтобы добавить папки, просто перетащите нужные из проводника в область интерфейса, тогда все они будут добавлены в выпадающий список (область 1), или нажмите на кнопку «+» в области 2 и выберите нужные директории через специальное диалоговое окно, в нем можно выделять сразу несколько папок, данные операции можно производить несколько раз, тогда новые папки будут добавляться в список, вложенные папки тоже будут добавлены, если это не нужно, отключите соответствующую опцию в настройках (чтобы узнать о том как получить доступ к настройками читайте руководство по Pyrog). Удалить выбранную папку или все их разом, можно при помощи соответствующих кнопок в выделенной области 2. Если в папках уже есть файлы с описаниями, информация из них будет загружена автоматически.
Когда добавите папки, то в выделенной области 3 увидите список изображений для текущей директории, вы можете переключаться между изображениями, щелкнув по нужному элементу или используя кнопки в выделенной области 4 или с помощью сочетаний клавиш: Alt+↑ и Alt+↓, переключаться между папками можно, выбрав нужную в выпадающем списке или переключаться между соседними при помощи сочетаний клавиш: Alt+← и Alt+→.
Если вы не планируете использовать описания для многоязычного сайта, то можете не добавлять конкретные языки. В случае, если все таки нужно сделать файлы описаний на нескольких языках, то обратите внимание на выделенную область 6: в выпадающем списке содержится список языков, по умолчанию там только None, это означает что никакой язык не привязан, чтобы выбрать конкретный язык нажмите на кнопку «+», после этого появится диалоговое окно для ввода локали, для быстроты просто введите нужную локаль в верхнее поле, например «ru-ru» (регистр не учитывается) или выберите нужный язык и страну при помощи выпадающих списков. Если добавлено 2 и более папки, то программа предложит привязать выбранный язык другим папкам, в зависимости от потребностей примите запрос или отклоните. Ненужные языки можете удалить нажав кнопку «-».

После того как все приготовления сделаны начните вводить заголовки и описания в соответствующие поля в выделенной области 7. Между полями можно перемещать нажатием сочетаний клавиш Shift+Enter и Enter. Если нужно, чтобы выводились данные для всех языков сразу - отметьте флажок Показать все языки. Когда ввод закончен или вам нужно сделать перерыв, то нажмите кнопку «Сохранить», после чего все введенные данные будут записаны в файлы. Если вам нужно отредактировать данные, просто добавьте папки с нужными файлами повторно.

Внимание! Данные не сохраняются автоматически, это нужно делать вручную!

Вместо заключения

Сегодня вы узнали как с комфортом создавать файлы описаний изображений в галереях расширения sigplus CMS Joomla при помощи утилиты 3A Joomla, работающей в составе программного комплекса Pyrog, читайте о нем мою статью.

Предлагайте свои идеи для модулей 3A Joomla. Создавайте собственные приложения на базе Pyrog.

Создаем описания изображений для sigplus (Joomla) без боли