Multimedia Field — галерея и файлы для пользовательских полей Joomla

Что такое Multimedia Field

Multimedia Field добавляет в «Пользовательские поля» Joomla тип «Мультимедиа (галерея или файлы)». Поле строится на штатном повторяемом subform: в каждой строке стандартное поле «Медиа» с выбором файла и предпросмотром, описание (оно же alt и подпись) и ручная сортировка. Файлы можно выбрать в менеджере медиа Joomla или загрузить с компьютера кнопкой и перетаскиванием.

У поля два режима. Режим выбирается при создании и после сохранения не меняется, а в настройках остаются только параметры своего режима. Нужны и фото, и документы — создаются два поля.

Режим «Галерея»: фото

При загрузке изображения можно вписать в рамку или обрезать по рамке, задать качество, преобразовать в WebP и повернуть по EXIF. Метаданные (EXIF и геометки) удаляются. Миниатюры создаются при первом показе и кэшируются. Крупный просмотр работает через WT Fancybox, а если плагина нет — во встроенном окне на <dialog>, без внешних сетей.

Вариант 1. Сетка

Три колонки на широком экране, две на планшете, одна на телефоне. Клик по фото открывает его крупно.

Фотогалерея (сетка):

Вариант 2. Слайдер

Прокрутка на CSS scroll-snap без библиотек: кнопки, свайп и клавиши со стрелками. Под фото показана подпись.

Фотогалерея (слайдер):

Режим «Файлы»: документы

Список документов для скачивания: название, тип и размер файла. Допустимые расширения задаются в настройках поля (по умолчанию PDF, Word, Excel, PowerPoint, OpenDocument, TXT, CSV и ZIP). Исполняемые типы отклоняются всегда.

Вариант 3. Список

Компактный список: подходит для длинных перечней и прайс-листов.

Документы (список):

• DOCX Образец договора (DOCX) DOCX, 997 B
• CSV Прайс-лист (CSV) CSV, 167 B
• ZIP Примеры макетов (ZIP) ZIP, 216 B

Вариант 4. Карточки

Крупные карточки с типом файла и размером: хорошо для нескольких важных документов.

Документы (карточки):

• DOCX Образец договора (DOCX) DOCX, 997 B
• CSV Прайс-лист (CSV) CSV, 167 B
• ZIP Примеры макетов (ZIP) ZIP, 216 B

Установка и настройка

В админке Joomla откройте Система → Установка → Расширения → Установить по URL-адресу, вставьте ссылку и нажмите «Проверить и установить»:

https://github.com/shivayanamahom/plg_fields_multimedia/releases/latest/download/plg_fields_multimedia.zip

1. Откройте Содержимое → Поля → Создать и выберите тип «Мультимедиа (галерея или файлы)».
2. Выберите режим и задайте параметры: папку загрузки, максимум элементов, размер файла, вид галереи или списка.
3. Сохраните поле и заполните его в материале. Чтобы вывести поле в нужном месте текста, отключите автоматическое отображение и вставьте в материал код {field ID}.

Требования: Joomla 5.2 или новее (проверено на 6.2), PHP 8.2 или новее, расширения fileinfo и gd. Обновления приходят штатно через Система → Обновление → Расширения.

Безопасность загрузки

• Настройки загрузки сервер берёт из параметров поля, а не из запроса браузера; проверяются токен формы, вход, права и уровень доступа.
• Тип файла определяется по содержимому. Изображения пересохраняются через GD, поэтому в них не остаются EXIF и «хвосты» с кодом.
• Расширения php, html, svg, js, exe и двойные вроде shell.php.jpg отклоняются всегда.
• Папка загрузок только внутри images/, в ней создаются .htaccess и web.config против выполнения скриптов. В разметке нет inline-скриптов и стилей.

Исходный код и документация

• Multimedia Field на GitHub — код, структура и инструкция по сборке.
• Выпуски и история версий.

Актуальная версия и список изменений опубликованы в репозитории.