Zool! Arty Workshop

zoolJoomLibs.mediaImageChooser — удобный выбор картинок в Joomla!

Описание

Это расширение для разработчиков, которое позволяет пользователям вашего Joomla-приложения выбирать картинки в HTML-формах с помощью встроенного медиа-менеджера. Расширение это нужно только для Джумлы версии 1.5, так-как в 1.6 уже появилось специальное поле формы как-раз для этих целей.

История изменений

0.02:

• Базовая поддержка параметра "folder" компонента com_media (спасибо Cristiano Cucco за идею).
• Теперь возможно использование mediaImageChooser без виджета предпросмотра.
• Теперь виджет предпросмотра не обладает умолчательными высотой и шириной. Поэтому, по-умолчанию, ваши изображения будут показываться в своём полном размере. Вы можете менять размеры этого виджета если передадите html-аттрибуты "width" и "height" методу mediaImageChooser::imagePreview().
• Исправлены несколько ошибок (#19665, #19684) и внесены небольшие улучшения.

0.01:

• Изначальная версия. 

Загрузки

• zoolJoomLibs.Base плагин
• zoolJoomLibs.mediaImageChooser плагин

Установка

• установите плагин zoolJoomLibs.Base и опубликуйте его
• установите плагин zoolJoomLibs.mediaImageChooser (публиковать не обязательно)

Использование

Сначала импортируйте плагин zoolJoomLibs.Base:

 if (!JPluginHelper::importPlugin('zoolJoomLibs', 'base')) {
     JError::raiseError(2001, 'Please, install and publish zoolJoomLibs.Base first.');
 }

 Импортируйте класс mediaImageChooser:

 if(!zjl_import('mediaImageChooser')) {
     JError::raiseError(2001, 'Please, install zoolJoomLibs.mediaImageChooser first.');
 }

 Потом добавьте поведение для mediaImageChooser на вашей странице:

JHTML::_('mediaImageChooser.behavior.all');

 или, со своей картинкой-пустышкой:

JHTML::_('mediaImageChooser.behavior.all', '/path/to/blank/image.png');

 Также не забудьте добавить поведение для модальных окон:

JHTML::_('behavior.modal');

 Теперь можно использовать наш класс:

 // ...
 // Начало формы выше
 // ...
 $image_chooser = new mediaImageChooser('form_var_name', 'path/to/current/image.png');
 // Показываем поле ввода
 echo $image_chooser->inputBox();
 // Показываем кнопку вызывающую окно медиа-менеджера
 echo $image_chooser->button();
 // Показываем виджет предпросмотра
 echo $image_chooser->imagePreview();
 // Выводим ява-скрипт который подготовит все элементы для работы
 echo $image_chooser->start();
 // ...
 // Конец формы идёт ниже
 // ...

Документация

Вы можете почитать автоматически сгенерированную документацию здесь.

Поддержка

Пожалуйста, обсуджайте mediaImageChooser в Форуме и сообщайте об ошибках через Bug Tracker.