內容簡介
thumbGen 是一款專為開發者設計的縮圖產生外掛，提供 thumbGen() 函式讓你以指定尺寸顯示任何圖片，並支援裁切、對齊、旋轉及濾鏡效果，所有產生的縮圖皆存於快取資料夾，不會造成伺服器負擔。
【主要功能】
• 以自訂寬高動態產生圖片縮圖
• 支援裁切模式與水平／垂直對齊設定
• 可套用灰階與復古褐色濾鏡效果
• 支援自訂旋轉角度與背景顏色
• 自動快取已產生的縮圖，避免重複運算
• 可保留 GIF 動畫或僅擷取第一幀
外掛標籤
開發者團隊
原文外掛簡介
This plugin is made for developers.
It creates a function named thumbGen() that allows to show any image in the specified size. Additionally you can specify values like crop, center, rotation and effects.
It saves all generated thumbs in a cache folder, so it won’t overload your server at all.
Usage
To use this function you just need to use this line code:
[image:] the URL of the original image you need to create a thumbnail from (needed).
[width:] the width you need for the generated thumbnail (default=0 – if not specified it gets the
proportional value from the specified height).
[height:] the height you need for the generated thumbnail (default=0 – if not specified it gets the proportional value from the specified width).
note: if you don’t specify the with AND height (or if you set both to 0), the image will be generated in the source size.
Additional parameters
[filename:] some people have troubles with duplicated names, so I’ve added this parameter for you to specify a new filename (or ID or something like that) in order to differentiate each file (if not set it will use the source filename).
[md5:] by default, the images are generated with an md5 encode filename. If you don’t want the generated file to have an encoded name set this to 0
[force:] force thumb creation, even if it already exists (default=0) (NOT RECOMENDED! – use it just for testing or debugging)
[crop:] if you want the thumbnail to be cropped (no image deformation) if the width and height are different from the original image, set this value as 1 or true. If you want the content of the thumbnail to be resized to fit the space (image deformation) set this to 0 or false (default=1).
[halign:] horizontal align of the croped image. You can set it to left, center or right (default=center)
[valign:] vertical align of the croped image. You can set it to top, center or bottom (default=center)
[effect:] you can apply two effects: grayscale and sephia
[rotate:] you can specify a rotation angle
[background:] hex color (like #ffffff) to apply on the background ONLY when you rotate the image. If you don’t want a color applied you can set this to transparent (default=transparent)
[return:] if set to 1 (or true) the image name will be returned instead of printed (default=0).
[preserveAnimation:] if set to 1 (or true) it will show animated gif’s with motion but without applying other parameters. Otherwise, it will show the first frame of the animated gif resized.
[quality:] you can chooos from 0 to 9, where 0 is the worst quality (lower file size) and 9 is the best (bigger file size). The default value is 7.
Examples of usage
In this example I will not explain detailed how this WordPress code works, but I will show this as an example of this plugin usage:
$post->ID,
'post_type' => 'attachment',
'numberposts' => 1,
'post_mime_type' => 'image'
);
$attachs = get_posts($args);
if ($attachs) {
$img=wp_get_attachment_image_src($attachs[0]->ID,'full');
}
if(!empty($img)){
?>
This example reads the first attached image of a post and save it’s information in a variable called $img. In the thumbGen function the first parameter is $img[0] and that’s the image URL. The second and third parameters are the width and height of the generated thumbnail we need. The rest of the parameters are defined in the string in the format parameter=value, concatenated with an &. the values not specified will use their default value.
