Timur Kamaev

Convenient way to create post thumbnails on the fly without server overload.
The best alternative to scripts like “thumbnail.php”.
Supports Multisite.
<h3>Usage</h3>
The plugin for developers firstly, because it don’t do anything after install. In order to the plugin begin to work, you need use one of plugin function in your theme or plugin. Example:
<pre><code><?php echo kama_thumb_img( 'w=150 &h=150' ); ?>
</code></pre>
Using the code in the loop you will get ready thumbnail IMG tag. Plugin takes post thumbnail image or find first image in post content, resize it and create cache. Also creates custom field for the post with URL to original image. In simple words it cache all routine and in next page loads just take cache result.
You can make thumbs from custom URL, like this:
 
The <code>URL_TO_IMG</code> must be from local server: by default, plugin don’t work with external images, because of security. But you can set allowed hosts on settings page: <code>Settings > Media</code>.
All plugin functions:
<pre><code>// return thumb url URL
echo kama_thumb_src( $args, $src );

// return thumb IMG tag
echo kama_thumb_img( $args, $src );

// return thumb IMG tag wraped with <a>. A link of A will leads to original image.
echo kama_thumb_a_img( $args, $src );

// to get image width or height after thumb creation
echo kama_thumb( $optname );
// ex:
echo '<img src="'. kama_thumb_src('w=200') .'" width="'. kama_thumb('width') .'" height="'. kama_thumb('height') .'" alt="" />';
</code></pre>
Parameters:
<ul>
<li>
$args (array/string) 
Arguments to create thumb. Accepts:
<ul>
<li>
w | width 
(int) desired width.
</li>
<li>
h | height 
(int) desired height.
if parameters <code>w</code> and <code>h</code> not set, both of them became 100 – square thumb 100х100 px.
</li>
<li>
notcrop 
(isset) if set <code>crop</code> parameter become false – <code>crop=false</code>.
</li>
<li>
crop 
(isset) Control image cropping. By default always <code>true</code>.
To disable cropping set here <code>false/0/no/none</code> or set parameter <code>'notcrop'</code>. Then image will not be cropped and will be created as small copy of original image by sizes settings of one side: width or height – here plugin select the smallest suitable side. So one side will be as it set in <code>w</code> or <code>h</code> and another side will be smaller then <code>w</code> or <code>h</code>.
Cropping position
Also, you can specify string: <code>'top'</code>, <code>'bottom'</code>, <code>'left'</code>, <code>'right'</code> or <code>'center'</code> and any other combinations of this strings glued with <code>/</code>. Ex: <code>'right/bottom'</code>. All this will set cropping area:
<ul>
<li><code>'left', 'right'</code> – horizontal side (w)</li>
<li><code>'top', 'bottom'</code> – vertical side (h)</li>
<li><code>'center'</code> – for both sides (w and h)</li>
</ul>
When only one value is set, the other will be by default. By default: <code>'center/center'</code>.
Examples:
<pre><code>// image will be reduced by height, and width will be cropped.
// "right" means that right side of image will be shown and left side will be cut.
kama_thumb_img('w=200 &h=400 &crop=right');

// image will be redused by width, and height will be cropped.
// "top" means that the top of the image will be shown and bottom side will be cut.
kama_thumb_img('w=400 &h=200 &crop=top');

// you can specify two side position at once, order doesn't matter
kama_thumb_img('w=400 &h=200 &crop=top/right');
</code></pre>
Reduce image by specified side
In order to get not cropped proportionally rediced image by specified side: by width or height. You need specify only width or only height, then other side will be reduced proportional. And no cropping will appear here.
<pre><code>kama_thumb_img('w=200');
</code></pre>
So, width of our image will be 200, and height will be as it will… 
Теперь ширина всегда будет 200, а высота какая получится… And the picture will be always full, without cropping.
</li>
<li>
q | quality 
(int) jpg compression quality (Default 85. max.100)
</li>
<li>
stub_url 
(string) URL to no_photo image.
</li>
<li>
alt 
(str) alt attr of img tag.
</li>
<li>
title 
(str) title attr of img tag.
</li>
<li>
class 
(str) class attr of img tag.
</li>
<li>
style 
(str) style attr of img tag.
</li>
<li>
attr 
(str) Allow to pass any attributes in IMG tag. String passes in IMG tag as it is, without escaping.
</li>
<li>
a_class 
(str) class attr of A tag.
</li>
<li>
a_style 
(str) style attr of A tag.
</li>
<li>
a_attr 
(str) Allow to pass any attributes in A tag. String passes in A tag as it is, without escaping.
</li>
<li>
no_stub 
(isset) don’t show picture stub if there is no picture. Return empty string.
</li>
<li>
yes_stub 
(isset) show picture stub if global option in option disable stub showing, but we need it…
</li>
<li>
post_id | post 
(int|WP_Post) post ID. It needs when use function not from the loop. If pass the parameter plugin will exactly knows which post to process. Parametr ‘post’ added in ver 2.1.
</li>
<li>
attach_id 
(int) ID of wordpress attachment image. Also, you can set this parametr by pass attachment ID to ‘$src’ parament – second parametr of plugin functions: <code>kama_thumb_img('h=200', 250)</code> or <code>kama_thumb_img('h=200 &attach_id=250')</code>
</li>
<li>
allow 
(str) Which hosts are allowed. This option sets globally in plugin setting, but if you need allow hosts only for the function call, specify allow hosts here. Set ‘any’ to allow to make thumbs from any site (host).
</li>
</ul>
</li>
<li>
$src 
(string) URL to any image. In this case plugin will not parse URL from post thumbnail/content/attachments.
If parameters passes as array second argument <code>$src</code> can be passed in this array, with key: <code>src</code> или <code>url</code> или <code>link</code> или <code>img</code>:
<pre><code> echo kama_thumb_img( array(
 'src' => 'http://yousite.com/IMAGE_URL.jpg',
 'w' => 150,
 'h' => 100,
 ) );
</code></pre>
</li>
</ul>
<h3>Notes</h3>
<ol>
<li>
You can pass <code>$args</code> as string or array:
<pre><code> // 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' => ''
 ) );
</code></pre>
</li>
<li>
You can set only one side: <code>width</code> | <code>height</code>, then other side became proportional.
</li>
<li><code>src</code> parameter or second function argument is for cases when you need create thumb from any image not image of WordPress post.</li>
<li>
For test is there image for post, use this code:
<pre><code> if( ! kama_thumb_img('w=150&h=150&no_stub') )
 echo 'NO img';
</code></pre>
</li>
</ol>
<h3>Examples</h3>
<h4>#1 Get Thumb</h4>
In the loop where you need the thumb 150х100:
<pre><code><?php echo kama_thumb_img('w=150 &h=100 &class=alignleft myimg'); ?>
</code></pre>
Result:
<pre><code><img src='thumbnail_URL' alt='' class='alignleft myimg' width='150' height='100'>
</code></pre>
<h4>#2 Not show stub image</h4>
<pre><code><?php echo kama_thumb_img('w=150 &h=100 &no_stub'); ?>
</code></pre>
<h4>#3 Get just thumb URL</h4>
<pre><code><?php echo kama_thumb_src('w=100&h=80'); ?>
</code></pre>
Result: <code>/wp-content/cache/thumb/ec799941f_100x80.png</code>
This url you can use like:
<pre><code><img src='<?php echo kama_thumb_src('w=100 &h=80 &q=75'); ?>' alt=''>
</code></pre>
<h4>#4 <code>kama_thumb_a_img()</code> function</h4>
<pre><code><?php echo kama_thumb_a_img('w=150 &h=100 &class=alignleft myimg &q=75'); ?>
</code></pre>
Result:
<pre><code><a href='ORIGINAL_URL'><img src='thumbnail_URL' alt='' class='alignleft myimg' width='150' height='100'></a>
</code></pre>
<h4>#5 Thumb of any image URL</h4>
Pass arguments as array:
<pre><code><?php
 echo kama_thumb_img( array(
 'src' => 'http://yousite.com/IMAGE_URL.jpg',
 'w' => 150,
 'h' => 100,
 ) );
?>
</code></pre>
Pass arguments as string:
<pre><code><?php
 echo kama_thumb_img('w=150 &h=200 ', 'http://yousite.com/IMAGE_URL.jpg');
?>
</code></pre>
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).
<h4>#6 Parameter post_id</h4>
Get thumb of post ID=50:
<pre><code><?php echo kama_thumb_img("w=150 &h=100 &post_id=50"); ?>
</code></pre>
<h3>I don’t need plugin</h3>
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:
<ol>
<li>Create folder in your theme, let it be ‘thumbmaker’ – it is for convenience.</li>
<li>Download the plugin and copy the files: <code>class.Kama_Make_Thumb.php</code> and <code>no_photo.jpg</code> to the folder you just create.</li>
<li>Include <code>class.Kama_Make_Thumb.php</code> file into theme <code>functions.php</code>, like this: 
require ‘thumbmaker/class.Kama_Make_Thumb.php’;</li>
<li>Bingo! Use functions: <code>kama_thumb_*()</code> in your theme code.</li>
<li>If necessary, open <code>class.Kama_Make_Thumb.php</code> and edit options (at the top of the file): cache folder URL/PATH, custom field name etc.</li>
</ol>
<ul>
<li>Conditions of Use – mention of this plugin in describing of your theme.</li>
</ul>

Kama Thumbnail

Great plugin! Allows you to save space on hosting and speeds up the site. The author quickly reacts and modifies the plugin. Thank you!

Must have

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

Количество фоток на сервере стало заметно меньше (а размеров у нас очень много) и делать руками приходится не так много работы.

Спасибо!

Пожалуй, лучший плагин для создания тумбочек у постов

Creates post thumbnails on fly and cache the result. Auto-create of post thumbnails based on: WP post thumbnail OR first img in post content OR attach …

Vicky Arulsingam

Allow authors to select an image from a pre-defined list while in the Post Editor screen. This image will be displayed together with a post.
Post Avatar is similar in concept to Livejournal userpics wherein authors choose images uploaded by the site owner. Developed with Dominik Menke.
<h4>Features</h4>
<ul>
<li>Easy selection of images from within the Post Editor screen.</li>
<li>Scans images in sub-directories of the image option folder.</li>
<li>Allows the following file types: .jpg, .jpeg, .gif and .png.</li>
<li>Flexible with customizing avatar display.
<ul>
<li>Display avatars using the default HTML/CSS tags.</li>
<li>HTML/CSS tags can be edited from with the Settings screen.</li>
<li>Use template tags and custom filters within themes for advanced customization.</li>
</ul>
</li>
<li>International language support for Belorussian, Czech, Dutch, French, German, Hindi, Irish, Italian, Polish, Romanian, Serbo-Croatian, Spanish</li>
<li>Does not display missing images.</li>
<li>Can be further extended to show images for pages and custom post types</li>
</ul>
<h4>Bug Submission and Forum Support</h4>
<a href="https://wordpress.org/support/plugin/post-avatar/" rel="ugc">WordPress Forum</a>
<a href="http://garinungkadol.com/plugins/post-avatar/support/" rel="nofollow ugc">Post Avatar home page</a>
<h4>Please Vote and Review</h4>
Your votes and feedback are greatly appreciated. Thanks.
<h3>Advanced Customization</h3>
<h4>For Front End Display</h4>
By default, the plugin hooks into the following filters: <a href="https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content" rel="nofollow ugc">the_content()</a> and <a href="https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content" rel="nofollow ugc">the_excerpt()</a>.
OVERRIDE HTML DISPLAY USING FILTER HOOK: gklpa_the_postavatar
The <code>gklpa_the_postavatar</code> filter takes two parameters:
<ol>
<li>
<code>$post_avatar_text</code> – Original HTML display
</li>
<li>
<code>$post_avatar</code> – Post Avatar data in array format. The keys are:
<pre><code>avatar_url: The URL to the image 
show_image_dim: 1 indicates to show image dimensions, 0 to hide them 
image_height: integer value of image height or null if image dimensions is turned off 
image_width: integer value of image width or null if image dimensions is turned off 
post_id: ID of current post 
post_title: Post title for the image attribute 
image_name: Image file name
</code></pre>
</li>
</ol>
Example: Display a default image if no avatar is selected
This example makes use of the HTML/CSS settings defined by the site admin.
<pre><code> add_filter( 'gklpa_the_postavatar', 'prefix_show_default_image', 10, 2 );
 function prefix_show_default_image( $post_avatar_html, $post_avatar_array ){
 global $post, $gklpa_plugin_settings;

 // Display default image;
 if( is_null( $post_avatar_array ) ){
 if( !empty( $gklpa_plugin_settings['css_class'] ) {
 $css = 'class="' . $gkl_plugin_settings['css_class']. '"';
 }
 $post_avatar_html = $gklpa_plugin_settings['html_before' ] . '<img '. $css . ' src="http://wplatest.dev/images/default-image.jpg" alt="' . esc_attr(strip_tags($post->post_title) ) . '" />'. $gklpa_plugin_settings['html_after'];
 }
 return $post_avatar_html;
 }
</code></pre>
OVERRIDE HTML DISPLAY WITH CUSTOM CONTENT HOOK
If you want to change the HTML completely or override the option to display avatars automatically, use the <a href="https://codex.wordpress.org/Function_Reference/remove_filter" rel="nofollow ugc">remove_filter()</a> like so: 
 remove_filter(‘the_content’, ‘gkl_postavatar_filter’, 99 ); 
 remove_filter(‘the_excerpt’, ‘gkl_postavatar_filter’, 99 );
You can then define your own <code>the_content</code> filter function that makes use of the <code>gkl_postavatar()</code> or <code>gkl_get_postavatar()</code> functions
You will need to use the function <code>gkl_get_postavatar()</code> which takes the post object and returns the array of post avatar information.
<ol>
<li>
<code>$post_avatar_array</code> – Post Avatar data in array format. The keys are:
<pre><code>avatar_url: The URL to the image

show_image_dim: 1 indicates to show image dimensions, 0 to hide them

image_height: integer value of image height or null if image dimensions is turned off

image_width: integer value of image width or null if image dimensions is turned off

post_id: ID of current post

post_title: Post title for the image attribute

image_name: Image file name
</code></pre>
</li>
</ol>
Example:
<pre><code> add_filter( 'the_content', 'my_custom_post_avatar' );
 function my_custom_post_avatar( $content ){
 global $post;

 $current_avatar = gkl_get_postavatar( $post );
 $html_before = '';
 $html_after = '';
 // Display default image
 if( is_null( $current_avatar ) ) {
 $image_url = 'http://wplatest.dev/images/default-image.jpg';
 $alt_text = esc_attr(strip_tags($post->post_title) );
 } else {
 $image_url = $current_avatar['avatar_url'];
 $alt_text = $current_avatar['post_title'];
 }
 $post_avatar_html = $html_before . '<img src="'. $image_url . '" alt="' . $alt_text . '" />'. $html_after;

 return $post_avatar_html; 
 }
</code></pre>
OVERRIDE HTML DISPLAY WITH template tag <code>gkl_postavatar</code>
If you want the post avatar to appear outside of the content, e.g. with the entry’s meta information, make use of the <code>gkl_postavatar()</code> template tag.
It takes four paramters:
<pre><code> class: CSS class to use in the `<img>` tag. 
 before: HTML to appear before the image. 
 after: HTML to appear after the image. 
 do_what: Use `echo` to display the post avatar, `return` to pass it to a variable. Defaults to `echo`.
</code></pre>
Example: In a template file:
<pre><code> <div class="entry-meta"> 
 <?php gkl_postavatar('', "", "" );?>

 -- more template tags here --
 </div>
</code></pre>
Or you can make your own template tag function like in the example for “Override HTML display with custom content hook”, except you call the function directly in your template instead of hooking into <code>the_content()</code>.
<h4>For Administration Screens</h4>
Add Post Avatar to Pages and Custom Post Types
Use the filter hook <code>gklpa_allowed_post_types</code> to add further post types that you want the Post Avatar selection to appear on.
It takes an array of post type slugs as a parameter.
<pre><code> add_filter( 'gklpa_allowed_post_types', 'prefix_my_custom_post_types' );
 function prefix_my_custom_post_types( $current_post_types ){
 $current_post_types = array( 'post', 'page', 'review', 'event' );
 return $current_post_types;
 }
</code></pre>
Enable Image Selection for Folder Outside of WordPress Installation
By default, Post Avatar looks for your images folder in relation to your WordPress installation. If you want to move your folder elsewhere, use these pair of filter hooks: <code>gklpa_image_url</code> and <code>gklpa_image_dir</code>. They take a single parameter: Image folder url and absolute path to the image folder, respectively.
<pre><code> add_filter( 'gklpa_image_url', 'prefix_change_folder_url' );
 function prefix_change_folder_url( $current_url ){
 return esc_url( 'http://mysite.com/images/' );
 }

 add_filter( 'gklpa_image_dir', 'prefix_change_folder_dir' );
 function prefix_change_folder_dir ){
 return '/user/public_html/images/';
 }
</code></pre>
Please visit the <a href="http://www.garinungkadol.com/plugins/post-avatar/" rel="nofollow ugc">Post Avatar Page</a> for details on customizing the avatar display.
<h4>Translations</h4>
Post Avatar is translation-ready and supports a number of languages. If you can’t find your language here, please consider contributing a language pack.
If you’re interested, please check out the <a href="https://wordpress.org/extend/plugins/codestyling-localization/" rel="ugc">“Codestyling Localization” plugin</a> and for validating the <a href="http://www.poedit.net/" rel="nofollow ugc">“Poedit Editor”</a>.
Send in your translations to vix@garinungkadol.com
Thanks to the following for their language packs.
<ul>
<li>Belorussian (ru_RU) Fat Cower</li>
<li>Czech (cz_CZ) Lelkoun</li>
<li>Dutch (nl_NL) Jay August</li>
<li>French (fr_FR) Mathieu Haratyk</li>
<li>German (de_DE) Dominik Menke</li>
<li>Hindi (hi_IN_Hindi) Outshine Solutions </li>
<li>Irish (ga_IR) Ray S.</li>
<li>Italian (it_IT) Gianni Diurno</li>
<li>Polish (pl_PL) Meloniq</li>
<li>Romanian (ro_RO) Webhosting Geeks</li>
<li>Serbo-Croatian (sr_RS) Webhosting Hub</li>
<li>Spanish (es_ES) gogollack</li>
</ul>

Post Avatar

Choose an avatar from a pre-defined list to include in a post.

Kama Thumbnail vs Post Avatar