Kama Thumbnail v3.5.1

Удобный способ создания миниатюр постов на лету без перегрузки сервера.

Лучшая альтернатива скриптам типа "thumbnail.php".

Поддерживает мультисайт.

Применение

Плагин в первую очередь для разработчиков, потому что после установки он ничего не делает. Чтобы плагин начал работать, вам необходимо использовать одну из функций плагина в вашей теме или плагине. Пример:

<?php echo kama_thumb_img("w=150 &h=150"); ?>

Используя код в цикле, вы получите готовую миниатюру IMG-тега. Плагин берет миниатюру сообщения или находит первое изображение в содержимом сообщения, изменяет его размер и создает кеш. Также создает настраиваемое поле для публикации с URL-адресом исходного изображения. Проще говоря, он кэширует всю рутину, а при загрузке следующей страницы просто берет результат кэширования.

Вы можете сделать превью из собственного URL-адреса, например:


URL_TO_IMG должен быть с локального сервера: по умолчанию плагин не работает с внешними изображениями из соображений безопасности. Но вы можете установить разрешенные хосты на странице настроек: Настройки > Медиа.

Все функции плагина:

// возвращаем URL-адрес миниатюры
echo kama_thumb_src($args, $src);

// возвращаем тег IMG большого пальца
echo kama_thumb_img($args, $src);

// возвращаем тег IMG большого пальца, заключенный в <a>. Ссылка A приведет к исходному изображению.
echo kama_thumb_a_img($args, $src);

// чтобы получить ширину или высоту изображения после создания миниатюры
echo kama_thumb($optname);
// пример:
echo "<img src="". kama_thumb_src("w=200") ."" width="". kama_thumb("width") ."" height="". kama_thumb("height") ."" alt="" />";

Параметры:

- $args (массив/строка)

Аргументы для создания большого пальца. Принимает:

- ш | ширина

(int) желаемая ширина.

- ч | высота

(int) желаемая высота.

если параметры w и h не заданы, они оба становятся 100 - квадратный большой палец 100х100 пикселей.

- необрезать

(isset), если установленный параметр обрезки становится ложным -crop=false.

- урожай

(isset) Управление обрезкой изображения. По умолчанию всегда верно.

Чтобы отключить обрезку, установите здесь false/0/no/none или установите параметр notcrop. Тогда изображение не будет обрезано и будет создано как уменьшенная копия исходного изображения с настройками размеров одной стороны: ширины или высоты - здесь плагин выбирает наименьшую подходящую сторону. Таким образом, одна сторона будет такой, как установлено в w или h, а другая сторона будет меньше, чем w или h.

Положение обрезки

Также вы можете указать строки: "верхняя", "нижняя", "левая", "правая" или "центральная" и любые другие комбинации этих строк, склеенные с помощью /. Пример: "справа/снизу". Все это задаст область обрезки:

- "left", "right" - горизонтальная сторона (w)

- "верх", "низ" - вертикальная сторона (h)

- "центр" - для обеих сторон (ш и в)

Если установлено только одно значение, другое будет по умолчанию. По умолчанию: "центр/центр".

Примеры:

// изображение будет уменьшено по высоте и обрезано по ширине.
// "правая" означает, что будет показана правая часть изображения, а левая будет обрезана.
kama_thumb_img("w=200 &h=400 &crop=right");

// изображение будет уменьшено по ширине, а высота будет обрезана.
// "верх" означает, что будет показана верхняя часть изображения, а нижняя сторона будет обрезана.
kama_thumb_img("w=400 &h=200 &crop=top");

// вы можете указать положение двух сторон одновременно, порядок не имеет значения
kama_thumb_img("w=400 &h=200 &crop=сверху/справа");

Уменьшить изображение по указанной стороне

Чтобы получить необрезанное изображение, пропорционально перерезайте его по заданной стороне: по ширине или высоте. Вам нужно указать только ширину или только высоту, тогда другая сторона будет уменьшена пропорционально. И никакой обрезки здесь не появится.

kama_thumb_img("w=200");

Итак, ширина нашего изображения будет 200, а высота такая…

Теперь ширина всегда будет 200, а высота какая получится… И картинка всегда будет полной, без обрезки.

- д | качество

(int) качество сжатия jpg (по умолчанию 85, макс. 100)

- stub_url

(строка) URL-адрес изображения no_photo.

- альтернативный вариант

(str) alt атрибут тега img.

- титул

(str) атрибут заголовка тега img.

- класс

(str) атрибут класса тега img.

- стиль

(str) атрибут стиля тега img.

- атрибут

(str) Разрешить передачу любых атрибутов в теге IMG. Строка передается в тег IMG как есть, без экранирования.

- а_класс

(str) атрибут класса тега A.

- a_style

(str) атрибут стиля тега A.

- a_attr

(str) Разрешить передачу любых атрибутов в тег A. Строка передается в тег A как есть, без экранирования.

- no_stub

(isset) не показывать заглушку изображения, если изображения нет. Вернуть пустую строку.

- да_stub

(isset) показать заглушку изображения, если глобальная опция в опции отключить отображение заглушки, но она нам нужна…

- пост_ид | пост

(int|WP_Post) идентификатор сообщения. Это необходимо при использовании функции не из цикла. Если передать параметр, плагин будет точно знать, какой пост обрабатывать. Параметр "post" добавлен в версии 2.1.

- Attach_id

(int) Идентификатор изображения вложения WordPress. Также вы можете установить этот параметр, передав идентификатор вложения в параметр $src - второй параметр функций плагина: kama_thumb_img("h=200", 250) или kama_thumb_img("h=200 &attach_id=250")

- разрешить

(str) Какие хосты разрешены. Эта опция устанавливается глобально в настройках плагина, но если вам нужно разрешить хосты только для вызова функции, укажите здесь разрешить хосты. Установите "любой", чтобы разрешить делать превью с любого сайта (хоста).

- $источник

(строка) URL-адрес любого изображения. В этом случае п