hot!

phpThumbOn

Оптимизированный сниппет phpThumbOf. Схожий синтаксис, но более быстрая работа.
Версия 1.3.5-beta2
Дата выпуска 12.02.2019
Загрузки 11 893
Просмотры 45 023
Оптимизированный сниппет phpThumbOf под MODX Revolution. Схожий синтаксис, но более быстрая работа. Более подробно смотрите в changelog

Автор пакета до версии 1.3.0Евгений Борисов (Agel_Nash)

Сниппет phpthumbon


Данный сниппет можно использовать, как модификатор, например: [[*image:phpthumbon=`w=200&h=200&zc=1`]]



ПараметрОписаниеЗначение
inputПуть к картинке которую нужно обработать

Возможные значения
Строка


Значение по умолчанию
(пусто)


Примечание
Благодаря этому параметру сниппет может работать как модификатор


optionsПараметры для класса phpThumb

Возможные значения
Произвольная строка с параметрами отделенными друг от друга символом & (амперсанд), а значение параметра определяется после символа = (равенство)


Значение по умолчанию
q=96&src={assets_path}components/phpthumbon/noimage.jpg


Примечание
Значения по умолчанию q и src можно переопределить в системных настройках при помощи параметров phpthumbon.noimage и phpthumbon.quality




Системные настройки



ПараметрОписаниеЗначение
phpthumbon.images_dirПапка, которая будет вырезаться из пути в кеш-директории

Возможные значения
Имя папки


Значение по умолчанию
images


Примечание
Относительно директории assets


phpthumbon.qualityКачество картинки по умолчанию

Возможные значения
Целое число больше 0


Значение по умолчанию
96


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


phpthumbon.cache_dirИмя папки с кешем

Возможные значения
Имя папки


Значение по умолчанию
cache_image


Примечание
Относительно папки assets


phpthumbon.extЕсли на сжатие приходит картинка в неизвестном формате, то будет использоваться этот тип

Возможные значения
Расширение имени файла


Значение по умолчанию
jpeg


Примечание
Если на сжатие приходит картинка в неизвестном формате, то будет использоваться этот тип


phpthumbon.noimageПуть к картинки с изображением «картинка не существует»

Возможные значения
Путь к файлу


Значение по умолчанию
{assets_path}components/phpthumbon/noimage.jpg


Примечание
Если картинка указанная в input окажется не доступной или вообще этот параметр пуст, то на обработку поступит картинка указанная в этом параметре


phpthumbon.queueАктивация поддержки очередей

Возможные значения
0, 1, 2


Значение по умолчанию
0


Примечание
0 — не использовать очереди; 1 — использовать очередь и не сжимать noimage; 2 — использовать очередь и сжимать noimage под нужный размер


phpthumbon.queue_classpathПуть к файлу с классом QueueThumb

Возможные значения
0, 1, 2


Значение по умолчанию
{core_path}/components/phpthumbon/queue/QueueThumb.class.php


Примечание
В указанном файле должен располагаться класс QueueThumb с публичным статичным методом add(phpThumbOn $ThumbOn, modX $modx). Класс по умолчанию не использует очередей в прямом смысле слова и лишь сохраняет данные в таблицу modx_thumb_images для последующей обработки через процессор из крона.


phpthumbon.error_modeПравила обработки ошибочных картинок

Возможные значения
1, 2


Значение по умолчанию
1


Примечание
1 (по умолчанию) — сжатие noimage с заданными параметрами; 2 — вывод оригинальной картинки без обработки


phpthumbon.noimage_cacheПапка с закешированными noimage файлами

Возможные значения
полный путь к любой папке


Значение по умолчанию
{assets_path}components/phpthumbon/cache/


Примечание
Путь к папке в которой уже хранятся noimage нужных размеров


phpthumbon.total_queueЧисло обрабатываемых заданий из очереди за 1 раз

Возможные значения
от 1 до 10


Значение по умолчанию
1


Примечание
Не более 10. В случае отсутствия значения у этого параметра устанавливается значение по умолчанию — 1


phpthumbon.make_cachenameСниппет который может подменить дефолтные правила формирования кеш имен картинок

Возможные значения
Любое имя существующего сниппета в системе


Значение по умолчанию
(пусто)


Примечание
Сниппет должен вернуть сериализованный массив со следующими ключами:

  • _cacheFileName (имя файла с полным адресом относительно корня сервера)
  • _cacheSuffix (суффикс в имени кеш файла)
  • _globThumb (шаблон поиска других превьюх этого же файла)


1.3.5-beta (11.02.2019)

  • Fix work on MODX 3

1.3.4-beta (10.09.2018)

1.3.3-beta (15.12.2017)

  • Улучшена регулярка определения кириллицы в названии файла
  • Исправлена регулярка определения формата файла

1.3.2-pl (16.09.2016)

  • Инициализация класса modPhpThumb для работы с MODX 2.5.1

1.3.1-pl (14.01.2015)

  • Параметр $_config в классе phpThumbOn стал public, для непосредственного доступа к нему из сниппета в параметре "phpthumbon.make_cachename"
  • Метод _pathinfo в классе phpThumbOn переписан. Теперь он понимает русские символы более корректнее. Спасибо Василию Наумкину за реализацию данной функции в компоненте ms2Gallery

1.3.0 (23.09.2014)

  • Немецкий и Английский лексикон
  • Обновлен пакет для совместимости с MODX 2.3.x

1.2.1 (27.12.2013)

  • Баг со сбросом информации об объекте при ответе процессора
  • Исправление проблемы с абсолютными путями

1.2.0 (26.12.2013)

  • Удаление ранее созданных превью при повторном вызове сниппета с другими параметрами
  • Избавление от пустоты на выходе, если скрипт не смог создать превьюху
  • Кеширование сжатых noimage картинок
  • Возможность обработки нескольких картинок очереди за 1 запуск процессора
  • Исправлено логирование проблемных картинок
  • Кастомные имена превьюх

1.1.0 (06.12.2013)

  • Добавлена поддержка очереди сжатия

1.0.2 (16.09.2013)

  • Исправлена работа в режиме AJAX

1.0.1 (25.08.2013)

  • Исправлено некорректное восприятие параметра input с начальным слешем

1.0.0 (02.08.2013)

  • Имя файла превьюхи максимально вычищенно от непонятных последовательностей символов
  • Картинки семантично раскладываются по папкам в соответствии с оригинальными картинками
  • Удалены постоянные проверки и отчистки всего кеша
  • Отключена поддержка AWS Amazon
  • Добавлен ряд параметров отвечающих за качество и тип превьюхи по умолчанию
  • Код сниппета оптимизирован под множественные вызовы

Последние обсуждения в сообществе MODX.pro