Плагин для создания эскизов в материалах - jdvThumbs

Информация о материале
Категория: Разработка плагинов, компонент, модулей для Joomla

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

Эскизы создаются плагином в папке cache/plg_jdvthumbs.

В состав плагина входит slimbox. Но вместо него можно использовать другой лайтбокс, задав имя класса и rel в настроках плагина, в соответствии с используемым лайтбоксом. В этом случае лайтбокс должен уже быть на сайте.

Плагин делает эскизы для файлов jpg. png, gif. В настройках можно выбрать пропускать gif, если на сайте используются анимированные gif. Иначе можно добавлять класс nothumb, чтобы эскиз для изображения не делался.

Настройки плагина включают разделы для

  • главной страницы
  • блога
  • материалов
  • mod_custom

Можно включить опцию создания эскизов для вступительного изображения intro_image.

Также можно задавать специальные настроки для пунктов меню по Itemid.

Например:

  • 50: 150 150 
  • a50: 500 500

a - применяется к материалу, верхняя строка к блогу

еще пример:

  • 50: 150 150 crop window

crop - изображение обрезается, window - открывается в новом окне

Для экономии места на диске можно использовать общие настройки для категории, главной страницы и материалов. Например, если для материалов задать параметр Использовать параметры из - Category, то для категории и материала будет создваться один эскиз, с параметрами заданными в Параметры для блога.

Для изображений возможны следующие действия:

  • none - действие не производится
  • both - размеры эскиза подбираются так, чтобы он вписался в заданные ширину и высоту
  • width - эскизы создаются по высоте
  • height - по ширине
  • crop - производится обрезка изображения, возможны два варианта - это верхняя часть изображения и второй вариант средняя часть.
  • stylesize - испольщуются размеры, заданные в визуальном редакторе (чтобы этот параметр применялся нужно использовать настройки материала, то есть для категории и материала будут созданы два эскиза)

Открытие большого изображения задается следующими параметрами:

  • none - просто эскиз, при клике большое изображение не открывается
  • window - в новом окне
  • slimbox - в лайт боксе, в слимбоксе или другом лайбоксе, см. выше.

Дополнительные возможности плагина:

  • Размер эскиза можно также регулировать в материале, используя классы
    stylesize или tagsize для изображения.
    Размер эскиза будет в соответствии с параметрами width height стиля или ширина и высота будет браться из параметров тэга. Также можно использовать сокращенные обозначения для классов: ss и ts.
  • Для эскиза можно загрузить отдельный файл - custom-имяфайла.jpg В этом случае эскизы будут делаться с этого файла, а для большого изображения будет использоваться файл имяфайла.jpg
  • Наложение на большое изображение водяного знака. Для этого нужно указать в настроках делать большой эскиз.
  • Для внешних ссылок добавляется класс outer, что позволяет в CSS задать класс для внешних ссылок.
  • Не создаются эскизы для изображений, находящихся внутри ссылки, для изображений с классом nothumb, или внутри контейнера с классом nothumb.
  • Можно задать минимальный размер для создания эскизов - эскизы будут делаться только для изображений большего размера.

Если при включенной опции Загрузить slimbox в joomla 3 slimbox работать не будет, нужно отключить эту опцию в настройках плагина и добавить следующий код в шаблон.

Добавление slimbox в шаблон для Joomla 3:

<script src="/media/plg_content_jdvthumbs/slimbox-jquery/slimbox2.js" type="text/javascript"></script>
<link rel="stylesheet" href="/media/plg_content_jdvthumbs/slimbox-jquery/css/slimbox2<?php echo (JFactory::getLanguage()->isRTL() ? '-rtl' : ''); ?>.css" type="text/css" />

после

<jdoc:include type="head" />

либо 

$doc = JFactory::getDocument();
$doc->addScript(JURI::base() . '/media/plg_content_jdvthumbs/slimbox-jquery/slimbox2.js', 'text/javascript');
$doc->addStyleSheet(JURI::base() . '/media/plg_content_jdvthumbs/slimbox-jquery/css/slimbox2'.(JFactory::getLanguage()->isRTL() ? '-rtl' : '').'.css', 'text/css');

до тега jdoc head.

Если вы делаете свой модуль или компонент, то можно использовать код плагина для генерации эскизов.

Пример использования кода для создания эскизов. Этот код я использовал в модуле mod_articles_category

if (!class_exists('JdvThumbs2')) {
require_once( JPATH_BASE . DIRECTORY_SEPARATOR . 'plugins' . DIRECTORY_SEPARATOR . 'content' . DIRECTORY_SEPARATOR . 'dvthumbs' . DIRECTORY_SEPARATOR . 'thumb2.class.php' );
}
$thumbObj = new JdvThumbs2();

$thumbObj->set( 'quality', 100 );
$thumbObj->set( 'width', 290 );
$thumbObj->set( 'height', 200 );
$thumbObj->set( 'sizeon', 'both' );
$thumbObj->set( 'prefix', 'mod-ac' );

$images = json_decode($item->images);

$thumb = $thumbObj->doThumbnail($images->image_intro);
//$images->image_intro - путь к изображению

echo '<img alt="alt-text" class="media-object" src="/<?php echo $thumb[0]; ?>" />';