You can pass $args as string or array:

// string kama_thumb_img("w=200 &h=100 &alt=IMG NAME &class=aligncenter", "IMG_URL"); // array kama_thumb_img(array("width" => 200, "height" => 150, "class" => "alignleft" "src" => ""));

You can set only one side: width | height , then other side became proportional.

1. src parameter or second function argument is for cases when you need create thumb from any image not image of WordPress post.

For test is there image for post, use this code:

If(! kama_thumb_img("w=150&h=150&no_stub")) echo "NO img";

Примеры

#1 Get Thumb

In the loop where you need the thumb 150х100:

Результат:

#2 Not show stub image

#3 Get just thumb URL

Result: /wp-content/cache/thumb/ec799941f_100x80.png

This url you can use like:

" alt="">

#4 kama_thumb_a_img() function

Результат:

#5 Thumb of any image URL

Pass arguments as array:

"http://yousite.com/IMAGE_URL.jpg", "w" => 150, "h" => 100,)); ?>

Pass arguments as string:

When parameters passes as string and «src» parameter has additional query args («src=$src &w=200» where $src = http://site.com/img.jpg?foo&foo2=foo3) it might be confuse. That’s why «src» parameter must passes as second function argument, when parameters passes as string (not array).

#6 Parameter post_id

Get thumb of post ID=50:

I don’t need plugin

This plugin can be easily used not as a plugin, but as a simple php file.

If you are themes developer, and need all it functionality, but you need to install the plugin as the part of your theme, this short instruction for you:

1. Create folder in your theme, let it be ‘thumbmaker’ — it is for convenience.
2. Download the plugin and copy the files: class.Kama_Make_Thumb.php and no_photo.jpg to the folder you just create.
3. Include class.Kama_Make_Thumb.php file into theme functions.php , like this:
   require ‘thumbmaker/class.Kama_Make_Thumb.php’;
4. Bingo! Use functions: kama_thumb_*() in your theme code.
5. If necessary, open class.Kama_Make_Thumb.php and edit options (at the top of the file): cache folder URL/PATH, custom field name etc.

• Conditions of Use — mention of this plugin in describing of your theme.

TODO

• Лог stub файлов — чтобы узнать какие файлы были не найдены и на каких страницах
• возможно очистить кэш отдельной картинки
• брать заглушку из медиабиблиотки в настройках
• указывать в альт название записи для kama_thumb_img(), если он пустой и есть ID записи? Но функция работате с URL поэтому альт не всегда можно указать правильно… Может юзать in_the_loop().

Скриншоты

Установка

Instalation via Admin Panel

1. Go to Plugins > Add New > Search Plugins enter «Kama Thumbnail»
2. Find the plugin in search results and install it.

Instalation via FTP

1. Download the .zip archive
2. Open /wp-content/plugins/ directory
3. Put kama-thumbnail folder from archive into opened plugins folder
4. Activate the Kama Thumbnail in Admin plugins page
5. Go to Settings > Media page to customize plugin

Отзывы

Участники и разработчики

«Kama Thumbnail» - проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Журнал изменений

2.8.13

• NEW: фильтр pre_do_thumbnail_src .
• NEW: Обработка SVG — если для создания миниатюры преедана ссылка на SVG файл, эта ссылка просто будет возвращена.

2.8.12

• NEW: фильтр kama_thumb_src .
• NEW: параметр stub_url .

2.8.11

• FIX: Заметка в админке об очистке заглушек теперь показывается только админам.

2.8.10

• FIX: Баг с нестандартными доменами например: domain.academy .

2.8.9

• ADD: Хук kama_thumb_default_args .

2.8.8

• FIX: Проверка строки при получении картинки. Иногда по URL может вернуться HTML код вместо данных картинки.
• NEW: Авто-определение путей при интеграции плагина в тему или в MU плагины. Теперь для интеграции плагина в тему, плагин можно просто положить в папку темы и подключить в functions.php главный файл плагина.
• DEL: Удалил фильтр kama_thumb_allow_admin_options_page . Теперь его работа базируется на фильтре kama_thumb_def_options , если он используется, то страница опций плагина автоматически отключается и опции указываются через этот фильтр.

2.8.7

• FIX: Мелкие правки кода.
• NEW: для kama_thumb_img() автоматически прописывается alt (бурется у вложения), если указан параметр attach_id .
• NEW: Фильтр: kama_thumb_def_options — позволяет изменить опции по умолчанию (когда плаг ставиться не как плаг)
• NEW: Фильтр: kama_thumb_allow_admin_options_page — позволяет отключить страницу опций в админке (когда плаг ставиться не как плаг)
• NEW: Опция: auto_clear_days — каждые сколько дней очищать кэш

2.8.6

• BUG: wrong resizing when rise_small option enabled and specified size smaller then the image one is.

2.8.5

• BUG: on save of any type of post was created empty postmeta ‘photo_URL’, but it must be cleared only if it was exist before.

2.8.4

• CHG: create_function() replaced with lambda function, in order to support PHP 7.2+

2.8.3

• NEW: parameter ‘rise_small’. If set to false, when thumbnail will not become bigger if it size (width/height) is smaller than the specified size. Default: true — small thumbnails size increases.

2.8.2

• IMP: function parse_main_dom() now understand localhosts and IP.

2.8.1

• FIX: incorrect display on options page starting from WP 4.9.0

2.8.0

• Bugfix: there was error if pass post object (WP_Post) in ‘post’ parameter…

2.7.9

• CHG: rename filter start with ‘kmt_’ to ‘kama_thumb_’: ‘kmt_set_args’, ‘kmt_is_allow_host’, ‘kmt_img’, ‘kmt_a_img’ become ‘kama_thumb_set_args’, ‘kama_thumb_is_allow_host’, ‘kama_thumb_img’, ‘kama_thumb_a_img’.
• minor fixes

2.7.8

• ADD: hook ‘kama_thumb_inited’.
• FIX: little logic confuse about trigger_error()

2.7.7

• ADD: support for multisite — in MU plugin has it’s own options page in network settings menu. Child sites don’t have plugin options — it manages globally from network.
• ADD: now all files creates in sub folders of main cache folder, to avoid folder overflow. SEO redirect from old location to new.
• IMP: minor fixes: ‘meta_key’ option insurance. ‘debug’ option works only in WP_DEBUG mode. Code improvements.

2.7.6

• FIX: if set ‘kama_thumb_a_img(‘w=200″, $src)’ where $src is empty. Plugin was tried generate image of current post, but in this case better to show ‘no_photo’ stub.

2.7.5

• ADD: new parameters for adding attributes to A tag: ‘a_class’, ‘a_style’, ‘a_attr’ — kama_thumb_a_img("w=200 &a_class=foobar &a_style=display:block; &a_attr=") .

2.7.3 — 2.7.4

• ADD: ‘crop’ parameter…
• ADD: ‘attach_id’ parameter — ID of wordpress attachment image. Also, you can set this parametr by pass attachment ID to ‘src’ parament or in second parametr of plugin functions: kama_thumb_img("h=200", 250) or kama_thumb_img("h=200 &attach_id=250")
• FIX: ‘class.Kama_Make_Thumb.php’ changes and fixes

2.7.2

• ADD: ‘style’ parameter for ‘kama_thumb_img()’ and ‘kama_thumb_a_img()’ functions.

2.7.0 — 2.7.1

• ADD: new function echo kama_thumb("width") — it allows to get real ‘width/height’ of image if width/height is empty. Or if we set ‘notcrop’ parameter and small image side will be resized proportionally and we don’t know the size beforehand.
• CHG: default no_photo image changed.

2.6.3

• CHG: confusing option ‘debug’ in class.Kama_Make_Thumb now turn on/off on settings page…
• ADD: options sanitization on save for protection reasons…

2.6.1

• NEW: languages dir removed from plugin

2.6.0

• ADD: ‘yes_stub’ parameter for functions ‘kama_thumb_*()’. Useful when ‘no_stub’ set in option, but in special place we need the stub (no photo image)
• ADD: New button on options page to clear all cache and delete metafields at once.
• FIX: bug fix with ‘no_stub’ option. Right after plugin activation it worked incorrectly.

2.5.8

• FIX: To support URL with HTML entity input src noe decodet with html_entity_decode() — ‘it`s-image.jpg’ > ‘it`s-image.jpg’

2.5.7

• FIX: Supports to URL without protocols: //site.com/folder/image.png

2.5.6

• FIX: removed two underscore ‘__’ from all classes methods. Because it reserved by PHP.

2.5.5

• ADD: WP HTTP API to get IMG from URL.
• ADD: ‘width’ & ‘height’ attributes for ‘kama_thumb_img()’ function for images with not specified ‘width’ or ‘height’ parameter (uses with ‘notcrop’ attribute)
• BUG: If set ‘notcrop’ parameter and not set ‘height’ — PHP dies with fatal error…

2.5.4

• ADD: thumb img in post content: now consider ‘srcset’ attribute if it’s set

2.5.3

• FIX: regular about ‘mini’ class in IMG tag and now you can change ‘mini’ class

2.5.2

• FIX: some minor fixes for plugin activation and uninstall

2.5.1

• ADD: Cyrilic domain support — such URL will wokr ‘http://сайт.рф/img.jpg’.
• ADD: ‘allow’ parameter from single function call fix — not work correctly.

2.5

• ADD: New filters for Kama_Make_Thumb class: ‘kmt_set_args’, ‘kmt_is_allow_host’, ‘kmt_img’, ‘kmt_a_img’
• ADD: Is allow host now checks for only main domain (not subdomain). Ex: now plugin works if you try create thumb of ‘http://site.com/img.png’ from ‘foo.site.com’ host
• ADD: New parameter ‘allow’ — set allowed hosts for only current function call. Ex: kama_thumb_img(«w=200 &h=200 &allow=any», ‘http://external-domain.com/img.jpg’);

2.4.4

• IMPROVE: Get file from remote domain not work properly if there were redirects…

2.4.3

• FIX: mini class for IMG in content. Was output error if IMG inside and not inside A tag.

2.4.2

• CHANGE: Kama_Make_Thumb class::get_src_and_set_postmeta() become publik. In order to just original get img url of post.
• FIX: search img url in post content not worked with relative url like: «/foo.jpg», and not worked if img extension «jpeg»;
• FIX: many times faster treatment in post content (regular expression fix);

2.4.1

• FIX: parsing parametrs if it given as string. ex: «h=250 ¬crop &class=aligncenter» notcrop becomes «notcrop_»

2.4

• FIX: If place second function parameter $src (img url) — it didn’t work correctly, because stupid mistake.
• FIX: when use class ‘mini’ in post content and IMG already wrapped with A tag, plugin made double A wrap.
• IMPROVE: Now self hosted images firstly parses as absolute path, and if there is error, it parses as URL. This method is much stable in some cases.
• ADD: Place ‘any’ in alowed hostes string on settings page, and plugin will make thumbs from any domain.

2.3

• Great Bug: Now if parameters passes as string ‘src’ parameter better pass as second argument of functions kama_thumb_*(«w=200 &h=300», ‘http://site.com/image.jpg’).

2.2

• ADD: ‘attr’ parameter. Allow to pass any attributes in IMG tag. String passes as it is, without escaping.

2.1

• ADD: aliases for passed parameters: src = url|link|img, post_id = post (can be passed as post object), q = quality, w = width, h = height
• FIX: when parameters passes as string and «src» parameter has aditional query args («src=$src &w=200» where $src = http://site.com/img.jpg?foo&foo2=foo3) it might be confuse, that’s why «src» parameter must passes in the end of string, when parameters passes as string (not array).
• CHG: some code refactoring in class.Kama_Make_Thumb.php file.
• FIX: no_stub worked only for images from posts. When ‘src’ is setted parameter ‘no_stub’ had no effect;

2.0

• ADD: notice message when no image library instaled on server (GD or Imagic)
• ADD: diferent names for real thumb and nophoto thumb. And possibility to clear only nophoto thumbs from cache. All it needed to correctly create IMGs from external URLs (not selfhosted img) — sometimes it can’t be loaded external imges properly.

1.9.4

• FIX: ext detection if img URL have querya rgs like *.jpg?foo

1.9.3

• CHG: DOCUMENT ROOT detection if allow_url_fopen and CURL disabled on server

1.9.2

• FIX: trys to get image by abs server path, if none of: CURL || allow_url_fopen=on is set on server

1.9.1

• FIX: getimagesizefromstring() only work in php 5.4+

1.9.0

• ADD: Images parses from URL with curl first

1.8.0

• ADD: Images parses from URL. It FIX some bugs, where plugin couldn’t create abs path to img.
• ADD: Allowed hosts settings. Now you can set sites from which tumbs will be created too.

1.7.2

• CHG: Back to PHP 5.2 support 🙁

1.7.1

• CHG: PHP lower then 5.3 now not supported, because it’s bad practice…

1.7

• FIX: refactor — separate one class to two: «WP Plugin» & «Thumb Maker». Now code have better logic!

1.6.5

• ADD: EN localisation

1.6.4

• ADD: now cache_folder & no_photo_url detected automatically
• ADD: notcrop parametr

Flector 5

Это маленький, но весьма полезный плагин, чьей единственной функцией является перегенерация миниатюр в блоге. Любое изменение размера миниатюр в настройках блога коснется лишь новых залитых вами картинок, а все старые картинки останутся с прежними размерами. А что делать, если вы сменили шаблон блога на тот, в котором дизайн заточен под определенный размер миниатюр? Вот тут то вам и понадобится данный плагин. Установили плагин, перегенерировали миниатюры в нужном размере и все, плагин можно удалять. И не стоит бояться экспериментировать с новыми шаблонами и разными размерами миниатюр – плагин создает новые миниатюры, не удаляя при этом старые. Таким образом, вы всегда можете откатиться на свой изначальный шаблон без какого-либо ущерба (ну кроме лишних картинок в папке загрузок) для своего блога.

1 Распаковываем архив.

2 Копируем папку regenerate-thumbnails в /wp-content/plugins/ .

3 Заходим в админку блога на вкладку "Плагины " и активируем плагин.

Никаких настроек в плагине нет. Так что не забываем сначала зайти в "Параметры\Медиафайлы " и установить нужные вам размеры миниатюр.

После этого у нас есть два варианта:

1 Перегенерация всех картинок сразу. Зайдите в "Инструменты\Regen. Thumbnails " и нажмите кнопку "Regenerate All Thumbnails ":

Теперь вам остается лишь ждать, пока плагин пересоздаст все миниатюры. Это может занять от нескольких секунд до десятков минут в зависимости от количества картинок. Сотня картинок пересоздается примерно одну минуту.

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

В шаблоне миниатюры могут выводиться или с относительными размерами или с точно определенными размерами. Относительные размеры (миниатюра, средняя, крупная) означают, что шаблон выведет картинки ровно в тех размерах, которые указаны в настройках блога. Независимо от того, впишутся ли картинки в этих размерах в дизайн шаблона или нет.

Функция the_post_thumbnail (которую вы можете найти в файле index.php в папке шаблона) при этом выглядит примерно так:

the_post_thumbnail("thumbnail"); // миниатюра (150 на 150) the_post_thumbnail("medium"); // средняя (300 на 300) the_post_thumbnail("large"); // большая (640 на 640) the_post_thumbnail("full"); // полная (без ограничений)

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

the_post_thumbnail(array(500,150)); // 500 на 150

Именно эти размеры вы и должны указать в настройках блога, а потом пересоздать картинки именно с этими размерами. Только в таком случае шаблон будет выглядеть именно так, как задумал его автор. Если вы не укажите эти размеры в настройках блога, то будет выведена картинка максимально близкая к указанным размерам. На деле это означает, что вместо этого:

Будет выведено вот это:

Пример, конечно, надуманный. Но, тем не менее, он наглядно показывает, что дизайнер мог иметь ввиду одно, а получается совсем другое только потому, что у вас миниатюры заданы не тех размеров, которые использовал автор шаблона. В данном случае записи вообще налезают друг на друга и портят дизайн напрочь. Многие шаблоны так и отбрасываются пользователями, которые просто не могут понять, что кривизна дизайна этих шаблонов вызвана неправильными размерами миниатюр, а вовсе не кривыми ручками их авторов.

В недалеком прошлом, когда я был совсем еще зеленым в мире программирования, в тот зимний вечер, я трудился над своим первым шаблон для WordPress. Мне нужно было настроить вывод миниатюр к записям. К тому моменту я уже познакомился с рядом шаблонов для WordPress, в которых встречалась реализация этой задачи. А реализовывалась она посредством, наверняка, известного вам скрипта timthumb.php (создает уменьшенную копию изображения по передаваемой ссылке на это самое изображение). Скрипт этот я конечно в итоге прикрутил к шаблону и был доволен результатом, но это продолжалось недолго.

Все работало нормально: вставляешь в запись изображение, брешь ссылку на него и добавляешь её в, специально созданное произвольное поле. В шаблоне ссылка с этого поля считывается и по ней создается миниатюра. Но спустя какое-то время, постоянное копирование ссылки и добавление её в произвольное поле, стало для меня утомительным занятием - рутина. К тому же бывало, что я вообще забывал вставить эту пресловутую ссылку и после публикации приходилось возвращаться к редактированию записи. Знакомо?

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

О плагине создания миниатюр для WordPress

После активации, плагин ничего не делает, чтобы он начал работать нужно будет редактировать шаблон (вызывать функции в том месте, где необходимы миниатюры изображений). Если просто установить и активировать плагин, он ничего делать не будет!

В целом, скрипт очень похож на timthumb.php, однако отличается и в чем-то лучше:

1. Не нужно вручную создавать произвольное поле со ссылкой на картинку. Поле создается автоматически.
2. Работает немного быстрее timthumb.php (timthumb.php – универсальный скрипт и поэтому там много лишних операций-проверок);
3. Ссылка на картинку будет выглядеть валидно /images/название файла.jpg , а не /functions.php?src=/images/название файла.jpg&w=100&h=100&q=80;
4. Кэш чиститься по необходимости. В timthumb.php кэш постоянно проверяется, старые файлы удаляются. На проверку уходят ресурсы (мелочь, но все же). На этом можно можно безболезненно сэкономить;
5. Ресайзинг можно использовать прямо в посте, указав картинке class mini и нужные размеры;
6. Гораздо удобнее использовать при интеграции в тему WordPress: не нужно получать значение произвольного поля, проверять существует ли поле, чтобы вывести картинку заглушку. Все это будет делаться автоматом.
7. На timthumb.php много хакерских атак, что, если не позволит взломать сайт, то привлечет лишнее внимание хакеров и нагрузку на сервер.

Принцип работы Kama Thumbnail

Создает папку кэша: wp-content/cache/thumb . В нее будут создаваться миниатюры.

При публикации или обновлении поста, плагин ищет ссылку на оригинал картинки и записывает её в произвольное поле поста, затем в теме по этой ссылке создается миниатюра. Ссылка определяется в следующем порядке:

1. Если у поста установлена миниатюра WordPress, её ссылка будет взята;
2. Если в тексте поста есть картинка, её ссылка будет взята. Если эта картинка является анкором ссылки на увеличенный вариант этой картинки, то будет взят УРЛ ссылки;
3. Если у поста нет ни миниатюры WP ни картинки в тексте, то плагин проверит нет ли у поста загруженной для него картинки (вложения). Если вложение есть, то ссылка будет взята от туда;
4. Если ничего не найдено, то в произвольное поле будет добавлена запись-заглушка: “no_photo”. Нужно это, чтобы не производить каждый раз эти операции по поиску ссылки.

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

Скачать плагин

Установка

1. Распакуйте архив в каталог плагинов /wp-content/plugins , активируйте плагин в админ-панели. Или установите плагин из админ-панели WordPress: Плагины > Добавить новый > Загрузить > Выбрать > Установить.
2. Настройте плагин на странице админ-панели: Настройки > Медиафайлы (Settings > Media) . Рекомендую там в базовых настройках WP выставить нули у большого размера “большой размер (Large size)” и сделать размер поменьше у среднего размера “Средний размер (Medium size)” (например: 150 х 100). Нужно это, чтобы при загрузке изображения WP не создавал лишних размеров изображений. Эту функцию заменит данный плагин.

Блок настроек плагина на странице “медиафайлы” (media):

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

После установки плагина в шаблоне можно использовать функции:

• kama_thumb_src($args) – возвращает ссылку на созданную миниатюру
• kama_thumb_img($args) – возвращает готовую картинку (img тег)
• kama_thumb_a_img($args) – возвращает ссылку-картинку. Ссылка ведет на оригинал картинки.

Аргументы $args:

• w или width – ширина миниатюры (обязательный)
• h или height – высота миниатюры (обязательный)
• q – качество сжатия jpg (по умолчанию 85. макс.100)
• src – ссылка на оригинал картинки, который нужно уменьшить. В этом случае, картинка не будет парсится из контента.
• alt – alt атрибут картинки
• title - title атрибут картинки
• class – class атрибут картинки. Укажите класс mini и нужные размеры, чтобы создать миниатюру к картинке в статье.
• no_stub – указываем, если не нужно выводить заглушку. Вместо нее будет возвращен пустой результат.
• post_id – идентификатор поста. Его нужно передавать, когда функция вызывается не из Цикла WordPress (например, внутри какой-нибудь функции) или, когда переменная $post определяется неправильно (например, определяется картинка от другой записи или еще какие-нибудь глюки). Если передать этот параметр, то скрипт будет точно знать какой пост обрабатывать. Если этот параметр не передан, то будет обрабатываться пост, находящийся в текущий момент (когда вызывается функция) в переменной $post.

Заметки:

1. Параметры можно указывать:
   

   // строкой kama_thumb_img("w=200 &h=100 &alt=название картинки &class=aligncenter"); // или массивом kama_thumb_img(array("width" => 200, "height" => 150, "class" => "alignleft"));

2. Можно указать только ширину или высоту, тогда противоположная сторона (высота или ширина) будут подобраны пропорционально уменьшенной копии;
3. Параметр src нужен для случаев, когда нужно создать миниатюру, без использования произвольных полей (взять любую картинку и создать миниатюру к ней).
4. Если нужно проверить есть ли у поста картинка и если нет, то сделать что-то другое, то используйте такой код:
   

   $img = kama_thumb_img("w=150&h=150&no_stub"); if(! $img) echo "Картинки нет";

   $ img = kama_thumb_img ("w=150&h=150&no_stub" ) ; if (! $ img ) echo "Картинки нет" ;

Миниатюра картинки в тексте статьи (шоткод)

Если в статье нужно уменьшить картинку и сделать её ссылкой на оригинал, то укажите картинке класс mini и задайте нужные размеры (width или height).

Например, мы вставили картинку в статью:

Но нам не нужна такая большая картинка в статье и мы хотим её уменьшить не визуально, а реально, тогда добавляем к ней класс mini и указываем нужные размеры:

300 ” />

Высота, которую мы удалили будет подобрана автоматически, пропорционально.

Такой подход – не использовать шоткод, мне показался удобнее: мы можем создавать миниатюры к картинкам и при этом видеть как картинка выглядит при редактировании поста, также при возможном удалении плагина, картинки в постах по-прежнему будут показываться (не останется непонятный шоткод).

Чтобы картинка миниатюра создавалась, эта опция должна быть включена в настройках.

Примеры использования

#1 Получаем миниатюру

Внутри цикла WordPress, где нужна миниатюра к посту, с размерами 150х100, используем такой код:

В результате на месте этого кода появится готовый тег :

#2 Не выводим картинку-заглушку

Чтобы картинка-заглушка не выводилась, если у записи нет картинок, то нужно определить параметр no_stub:

Вернет УРЛ миниатюры: /wp-content/cache/thumb/ec799941f_100x80.png . Этот УРЛ можно использовать, например, так:

" alt="" />

Если нужно сделать миниатюру, как картинку, кликнув на которую откроется большое изображение, то используйте такой код: