Тип media поля форми забезпечує модальний доступ до медіа-менеджера для вибору зображення. Користувачі з відповідними дозволами можуть завантажувати файли.
- type (обов'язково) - має бути media.
- name (обов'язково) – унікальне ім'я поля.
- label (обов'язково) (дозволяється перекладати) – описовий заголовок поля.
- description (необов'язково) (дозволяється перекладати) - це текст, який буде відображатися як спливаюча підказка, коли користувач наводить вказівник миші на список, що розкривається.
- directory (необов'язково) – це каталог, з якого користувач зможе вибрати файл. Цей атрибут повинен належати до папки верхнього рівня /images/. За налаштуванням користувач буде обмежений папкою верхнього рівня /images/.
- preview (необов'язково) - відображає або приховує попередній перегляд поточного вибраного зображення. («true»: показувати завжди, «tooltip»: показувати як підказку, «false»: ніколи не показувати). За налаштуванням - «tooltip». (починаючи з Joomla! 2.5.5)
- preview_width (необов'язково) - встановлює максимальну ширину зображення попереднього перегляду (за налаштуванням: «200»).
- preview_height (необов'язково) - встановлює максимальну висоту зображення попереднього перегляду (за налаштуванням: «200»).
Приклад XML визначення
<field name="myimage" type="media" directory="stories" />
Це відкриє медіа-менеджер із вже вибраним каталогом /images/stories/.
Зверніть увагу: якщо ви використовуєте це поле у зовнішньому інтерфейсі, швидше за все, діятимуть обмеження дозволів. Якщо користувач не авторизований для перегляду або додавання мультимедіа, він побачить сторінку з помилкою в спливаючому вікні («403 Ви не авторизовані для перегляду цього ресурсу.»).
Переглянути всі стандартні типи полів форми можна тут: https://d-nik.site/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi
