tiny-compress-images
Last commit date
docs
8 months ago
src
2 months ago
LICENSE
3 years ago
readme.txt
2 months ago
tiny-compress-images.php
2 months ago
uninstall.php
2 months ago
readme.txt
402 lines
| 1 | === TinyPNG - JPEG, PNG & WebP image compression === |
| 2 | Contributors: TinyPNG |
| 3 | Donate link: https://tinypng.com/ |
| 4 | Tags: compress images, compression, image size, page speed, performance |
| 5 | Requires at least: 4.0 |
| 6 | Tested up to: 7.0 |
| 7 | Stable tag: 3.6.13 |
| 8 | License: GPLv2 or later |
| 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | Speed up your website. Optimize your JPEG, PNG, and WebP images automatically with TinyPNG. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | The best & easiest image compression plugin for WordPress. Speed up your website by compressing and converting your images with TinyPNG for WordPress. Improve your websites’ performance by significantly reducing file sizes without noticeable quality loss. Support for WebP, AVIF, JPG and PNG formats. |
| 16 | Start optimizing your images today to boost SEO, improve your PageSpeed scores, save bandwidth and enhance your website’s user experience. |
| 17 | |
| 18 | = Why TinyPNG? = |
| 19 | |
| 20 | * Next-gen format conversion, convert images to WebP and AVIF for even smaller files (NEW) |
| 21 | * Smart compression algorithm, reduce image file sizes without visible quality loss |
| 22 | * Broad format support, supports AVIF, WebP, PNG, animated PNG (APNG) and JPG. |
| 23 | * Automatic image compression, compresses new images on upload. |
| 24 | * Bulk optimization, optimize your full media library in just one click. |
| 25 | * Individual image control, optimize a single image straight from your media library. |
| 26 | * Preserve meta-data, choose to retain copyright metadata, creation date and GPS location in your original images. |
| 27 | * Resize large images, automatically resize huge image uploads by setting a maximum width and/or height for more reasonable browser display. |
| 28 | * Custom thumbnail optimization, choose which image size should be processed. |
| 29 | * Advanced background processing, optimization run quietly in the background to speed up your workflow. |
| 30 | * Multisite support, use one API key across all sites. |
| 31 | * Detailed statistics, see how much file size you have saved by compressing your Media Library |
| 32 | * George the Panda, our lovely mascot brings joy and hugs. |
| 33 | * and much more… |
| 34 | |
| 35 | = Convert to next-gen formats like AVIF and WebP = |
| 36 | |
| 37 | With the TinyPNG WordPress plugin, you can easily convert your images to next-gen formats like AVIF and WebP. AVIF and WebP are modern image formats designed for the web. They are often smaller in size than older formats like JPEG and PNG, while keeping excellent image quality. |
| 38 | |
| 39 | * WebP images are 25–34% smaller than JPEG (lossy) according to Google. |
| 40 | * AVIF can reduce image size by up to 50% compared to JPEG, often even beating WebP in compression. |
| 41 | |
| 42 | Google’s PageSpeed Insights and other tools strongly recommend serving images in AVIF or WebP. Most modern browsers (like Chrome, Firefox, Edge, and Safari) now fully support WebP and AVIF. That means you can safely serve these formats to most of your visitors. |
| 43 | |
| 44 | With the TinyPNG WordPress plugin, your images can be automatically converted to AVIF or WebP when you upload them. No extra steps are required. |
| 45 | |
| 46 | = Optimizing all your images = |
| 47 | |
| 48 | You can bulk optimize your existing JPEG, PNG, and WebP images all at once by going to Media > Bulk TinyPNG. Clicking on the big button will start compressing and converting, when needed, all unoptimized images in your media library. |
| 49 | |
| 50 | If you have more images than your free credits allow, the tool will show you an estimated cost to optimize your entire library. If you are interested, you can upgrade your account to the paid plan and optimize the full library all in one go. Prefer to stay on the free plan? No problem! The bulk optimization tool will simply process images until your free limit is reached. |
| 51 | |
| 52 | = Compress for performance = |
| 53 | |
| 54 | The Tinify optimization engine is more than just compression. It is built to deliver the best image performance for the web, without sacrificing visual quality. Here’s how it helps: |
| 55 | |
| 56 | * Display JPEG images more quickly with progressive JPEG encoding. |
| 57 | * Color profiles are automatically translated to standard RGB color. |
| 58 | * Convert CMYK to RGB to save more space and add compatibility. |
| 59 | |
| 60 | = Compatibility = |
| 61 | |
| 62 | The TinyPNG plugin is fully compatible with *WordPress Multisite*. Next to this, TinyPNG for WordPress works smoothly with most themes and plugins. Here is a list of the popular plugins that have been tested to work smoothly with TinyPNG. |
| 63 | |
| 64 | * [WPML](https://wpml.org/documentation/plugins-compatibility/optimize-wordpress-images-multilingual-sites/) |
| 65 | * WooCommerce |
| 66 | * WP Retina 2x |
| 67 | * WP Offload |
| 68 | |
| 69 | = Getting Started = |
| 70 | |
| 71 | Install this plugin and follow the instructions to set up your account. No payment details are required. |
| 72 | |
| 73 | Learn more about the plugin with these step-by-step tutorials: |
| 74 | |
| 75 | * [How to set up the TinyPNG WordPress plugin?](https://help.tinify.com/help/how-to-set-up-the-tinypng-wordpress-plugin) |
| 76 | * [How to compress existing images with the WordPress plugin?](https://help.tinify.com/help/how-to-compress-existing-images-with-plugin) |
| 77 | |
| 78 | = Pricing = |
| 79 | You get 500 credits per month at no cost. |
| 80 | |
| 81 | With a regular WordPress installation, you can compress roughly 100 images per month. Please note that converting images to AVIF or WebP uses an additional credit per image size. This means with the conversion feature enabled, you can roughly compress and convert 50 images per month for free. |
| 82 | |
| 83 | The exact number depends on how many thumbnail sizes are generated by your theme or plugins. You can choose which of the generated thumbnail sizes should be optimized by going to Settings > TinyPNG page. You can upgrade to a paid plan to remove the limit and compress as many images as you like. |
| 84 | |
| 85 | = Need more? = |
| 86 | |
| 87 | Upgrade to a paid plan to remove the limit and compress as many images as you want. To view the pricing details, visit: [tinify.com/developers/pricing](https://tinify.com/developers/pricing) |
| 88 | |
| 89 | = Privacy = |
| 90 | |
| 91 | At Tinify, we take your privacy seriously. Only you have access to the uploaded images. All images are stored for a maximum of 48 hours, after which they will be deleted forever. |
| 92 | |
| 93 | = Contact us = |
| 94 | |
| 95 | Got questions or feedback? Let us know! Contact us at support@tinypng.com or find us on X: [@tinypng](https://twitter.com/tinypng). |
| 96 | |
| 97 | = Contributors = |
| 98 | |
| 99 | Want to contribute? Check out the [Tinify Wordpress plugin on GitHub](https://github.com/tinify/wordpress-plugin). |
| 100 | |
| 101 | == Installation == |
| 102 | |
| 103 | = From your WordPress dashboard = |
| 104 | |
| 105 | 1. Visit *Plugins > Add New*. |
| 106 | 2. Search for 'tinypng' and press the 'Install Now' button for the plugin named 'TinyPNG - JPEG, PNG & WebP image compression' by 'TinyPNG'. |
| 107 | 3. Activate the plugin from your *Plugins* page. |
| 108 | 4. Go to the *Settings > TinyPNG* page and register a new account. |
| 109 | 5. Or enter the API key you got from https://tinypng.com/developers. |
| 110 | 6. Go to *Media > Bulk TinyPNG* and optimize all your images! |
| 111 | |
| 112 | = From WordPress.org = |
| 113 | |
| 114 | 1. Download the plugin named 'TinyPNG - JPEG, PNG & WebP image compression' by 'TinyPNG'. |
| 115 | 2. Upload the `tiny-compress-images` directory to your `/wp-content/plugins/` directory, using your favorite method (ftp, sftp, scp, etc...) |
| 116 | 3. Activate the plugin from your Plugins page. |
| 117 | 4. Go to the *Settings > TinyPNG* page and register a new account. |
| 118 | 5. Or enter the API key you got from https://tinypng.com/developers. |
| 119 | 6. Go to *Media > Bulk TinyPNG* and optimize all your images! |
| 120 | |
| 121 | = Optional configuration = |
| 122 | |
| 123 | The API key can also be configured in your *wp-config.php* file. To do this you can add the following PHP code that sets the API key. |
| 124 | |
| 125 | `define( 'TINY_API_KEY', 'YOUR_API_KEY_HERE' );` |
| 126 | |
| 127 | Once set up you will see a message on the *Settings > TinyPNG* page. This will work for normal and multisite WordPress installations. |
| 128 | |
| 129 | == Screenshots == |
| 130 | |
| 131 | 1. Register a new account or enter your existing API key. Then choose the image sizes to optimize and any other options like resizing and preserving metadata in your original image uploads. |
| 132 | 2. In the Media Library list view you can see the savings on your images. |
| 133 | 3. From the Media Library you can compress individual images and use the Bulk Actions drop-down to quickly optimize multiple images at once. |
| 134 | 4. Last but not least you can also use Bulk TinyPNG to optimize your entire WordPress site. |
| 135 | |
| 136 | == Frequently Asked Questions == |
| 137 | |
| 138 | = Q: How many images can I optimize for free? = |
| 139 | A: In a default WordPress installation you can optimize around 100 images for free each month. WordPress creates different thumbnails of your images which all have to be compressed. Some plugins even add more sizes, so take a look at the *Settings > TinyPNG - JPEG, PNG & WebP image compression* page before you start optimization. |
| 140 | |
| 141 | = Q: How much does it cost to use the plugin? = |
| 142 | A: The plugin is free to use, you receive 500 free compressions each calendar month. |
| 143 | If you need to compress more, you can upgrade to the pay-per-compression pricing. You can view the current pricing at [tinify.com](https://tinify.com/developers/pricing). |
| 144 | When you use the bulk optimization tool, the plugin will first scan your media library and show you an estimated number of credits needed to optimize all uncompressed images. You can decide whether you want to upgrade your plan or stay within the free limit. |
| 145 | |
| 146 | = Q: How can I remove the 500 limit? = |
| 147 | A: Just add your *Payment details* on your [account dashboard](https://tinypng.com/dashboard/api) to remove the limit. For a small fee the additional compressions above 500 will then be charged to your account at the end of each month. |
| 148 | |
| 149 | = Q: What happens to the optimized images when I uninstall the plugin? = |
| 150 | A: When you remove the plugin all your optimized images will remain optimized. |
| 151 | |
| 152 | = Q: I don't recall uploading 500 photos this month but my limit is already reached. How is this number calculated? = |
| 153 | A: When you upload an image to your website, WordPress will create different sized versions of it (see *Settings > TinyPNG*). The plugin will compress each of these sizes, so when you have 100 images and 5 different sizes you will do 500 compressions. |
| 154 | |
| 155 | = Q: Is there a file size limit? = |
| 156 | A: Yes, but they are **very** generous! The maximum file size is 500MB and the maximum canvas size is 256MP (16000px by 16000px in any ratio). |
| 157 | |
| 158 | = Q: Can I use the same API key on all my websites? = |
| 159 | A: Yes, there are no limitations. You can add the same key everywhere. |
| 160 | |
| 161 | = Q: Can I hide my API key from the admin? = |
| 162 | A: Yes, you can hide your API key from the admin so other admin users will not be able to see it. To do this you should define the API key in your *wp-config.php* file. See the installation instructions for more information. |
| 163 | |
| 164 | = Q: What happens when I reach my monthly limit? = |
| 165 | A: Everything will keep on working, but newly uploaded images will not be optimized. Of course we encourage everyone to [switch](https://tinypng.com/dashboard/api) to a paid account to cover the hosting and development costs of the service. |
| 166 | |
| 167 | = Q: Can I optimize all existing images in my media library? = |
| 168 | A: Yes! After installing the plugin, go to *Media > Bulk TinyPNG*, and click on the start button to optimize all unoptimized images in your media library. |
| 169 | |
| 170 | = Q: How do I switch to a paid account? = |
| 171 | A: You can upgrade to a paid account by adding your *Payment details* on your [account dashboard](https://tinypng.com/dashboard/api). Additional compressions above 500 will then be charged at the end of each month as a one-time fee. |
| 172 | |
| 173 | = Q: Does converting to AVIF or WebP use more credits? = |
| 174 | A: When the conversion feature is enabled (to convert images to AVIF or WebP), each image will use double the number of credits: one for compression and one for format conversion. |
| 175 | |
| 176 | == Changelog == |
| 177 | = 3.6.13 = |
| 178 | * fix: will copy sizes attribute to picture element |
| 179 | * fix: will no longer clear logs on each save settings |
| 180 | * feat: if supported, can serve modern formats like webp/avif through htacess rules |
| 181 | * fix: when img has no src, will not attempt to transform it to a picture element |
| 182 | |
| 183 | = 3.6.12 = |
| 184 | * chore: updated tiny package to 1.6.4 |
| 185 | * fix: resolved warning when img tag was missing src attribute |
| 186 | |
| 187 | = 3.6.9 = |
| 188 | * fix: prevent picture element on product pages (WooCommerce) |
| 189 | |
| 190 | = 3.6.8 = |
| 191 | * feat: download logs and diagnostics |
| 192 | * chore: updated phpcs rules and formatting |
| 193 | |
| 194 | = 3.6.7 = |
| 195 | * Added support for WordPress 6.9 |
| 196 | |
| 197 | = 3.6.6 = |
| 198 | * fix: Improve compatibility with Avada page builder |
| 199 | |
| 200 | = 3.6.5 = |
| 201 | * fix: prevent picture element when using a page builder |
| 202 | |
| 203 | = 3.6.4 = |
| 204 | * added a guard to prevent bulk processing to requeue already processed images |
| 205 | |
| 206 | = 3.6.3 = |
| 207 | * Changed the source priority for picture elements |
| 208 | |
| 209 | = 3.6.2 = |
| 210 | * Resolved an issue where the amount of parameters were incorrect when rendering a notice. |
| 211 | |
| 212 | = 3.6.1 = |
| 213 | * Resolved issue where a picture element would be nested within a picture element |
| 214 | |
| 215 | = 3.6.0 = |
| 216 | * Added a link to leave a review in the bulk and settings page |
| 217 | * Renamed menu title for bulk to "Bulk TinyPNG" |
| 218 | * Renamed menu title for settings to "TinyPNG" |
| 219 | * Resolved warning when library was empty |
| 220 | * Resolved warning when resize options was empty |
| 221 | * New feature to enable converting images to WebP or AVIF |
| 222 | |
| 223 | = 3.5.2 = |
| 224 | * Removed devdependencies and test files from plug-in |
| 225 | * Fixed a warning when library contained no images |
| 226 | |
| 227 | = 3.5.1 = |
| 228 | * Will only check local file removal if AS3CF is active |
| 229 | |
| 230 | = 3.5.0 = |
| 231 | * Support files uploaded through the WordPress REST API |
| 232 | * Removed notification on WooCommerce incompatibility |
| 233 | * Updated Tinify SDK from 1.5.2 to 1.6.2 |
| 234 | * Improved support for WP Offload |
| 235 | |
| 236 | = 3.4.6 = |
| 237 | * Error resolved where Tiny_Helpers was not available |
| 238 | |
| 239 | = 3.4.5 = |
| 240 | * Error when mb_strimwidth is not available resolved |
| 241 | |
| 242 | = 3.4.4 = |
| 243 | * CSRF fix, added nonce check |
| 244 | |
| 245 | = 3.4.3 = |
| 246 | * Removed more deprecated PHP syntax that was triggering a warning message. |
| 247 | * Updated Wordpress compatibility |
| 248 | |
| 249 | = 3.4.2 = |
| 250 | * Removed deprecated PHP syntax that was triggering a warning message. |
| 251 | |
| 252 | = 3.4.1 = |
| 253 | * Fixed a bug that sometimes prevented failing requests to the Tinify servers from being retried. |
| 254 | |
| 255 | = 3.4 = |
| 256 | * Correct filesize metadata retrieval for compressed images in WordPress 6. |
| 257 | * Updated WordPress compatibility. |
| 258 | |
| 259 | = 3.3 = |
| 260 | * You can now optimise WebP images, in addition to JPEG and PNG. |
| 261 | |
| 262 | = 3.2.1 = |
| 263 | * Fixed bug that caused the original version of images that started with a special character to not be compressed. |
| 264 | * Updated Wordpress compatibility. |
| 265 | |
| 266 | = 3.2.0 = |
| 267 | * Support for WP Retina 2x Pro. |
| 268 | * More capability checks for extra security. |
| 269 | * Less resource intensive AJAX requests. |
| 270 | * Fixed CSS issues from Analytify plugin. |
| 271 | * Removed legacy Enhanced Media Library compatibility. |
| 272 | |
| 273 | = 3.1.0 = |
| 274 | * Remaining free compressions shown in settings page. |
| 275 | * Easier way to upgrade a free account. |
| 276 | * WPML and WPML Media compatibility in collaboration with the authors of WPML. Make sure to upgrade WPML to version 4.1. |
| 277 | * Added a notice to the Bulk Optimization page for free accounts with not enough available free compressions. |
| 278 | * Added a new hook after compression of an image useful for CDN cache flushing. |
| 279 | |
| 280 | = 3.0.1 = |
| 281 | * Fixed bug that caused an error when registering a new account. |
| 282 | * No longer use create_function, which is deprecated in PHP 7.2. The plugin no longer supports PHP 5.2. |
| 283 | * Rephrased incompatible plugins notice to avoid confusion. |
| 284 | |
| 285 | = 3.0.0 = |
| 286 | * Compress new images in the background to speed up your workflow. |
| 287 | * Turbo-charged Bulk Optimization page with simultaneous image compression. |
| 288 | * Improved memory usage for installations with extreme media libraries. |
| 289 | * Detection of incompatible plugins. |
| 290 | * Fallback to fopen whenever the curl_exec function is disabled. |
| 291 | * Additional notices for WP Offload S3 users. |
| 292 | * Several minor fixes and tweaks. |
| 293 | |
| 294 | = 2.2.6 = |
| 295 | * Fixed bug in compression of file types other than JPEG and PNG that have a thumbnail generated automatically. |
| 296 | |
| 297 | = 2.2.5 = |
| 298 | * Fixed bug in the Bulk Optimization page that sometimes caused it to stop. |
| 299 | * Fixed a problem that would prevent dashboard widget from loading. |
| 300 | * Tweaked styling of the dashboard widget for the latest version of WordPress. |
| 301 | * Fixed a warning in the media library when certain plugins are used. |
| 302 | |
| 303 | = 2.2.4 = |
| 304 | * Fixed bug with drop-down menu in the Media Library. |
| 305 | * Compression limit notice now links directly to your API dashboard. |
| 306 | * Tweaked styling of the dashboard widget. |
| 307 | |
| 308 | = 2.2.3 = |
| 309 | * Changed links to make it easier to go directly to your API dashboard. |
| 310 | * Fixed a compression issue for some fopen users. |
| 311 | |
| 312 | = 2.2.2 = |
| 313 | * Improved robustness in case an unexpected network error occurs. |
| 314 | * Fixed false positive warning with Sucuri scanner. |
| 315 | * Fixed compression issue for fopen users. |
| 316 | |
| 317 | = 2.2.1 = |
| 318 | * Fixed an error that was introduced in v2.2.0 where all custom image sizes did not show up. |
| 319 | * Added support for image sizes with unspecified height or width. |
| 320 | |
| 321 | = 2.2.0 = |
| 322 | * New dashboard widget that shows your media library savings. |
| 323 | * Support compressing medium_large image sizes. |
| 324 | |
| 325 | = 2.1.0 = |
| 326 | * Compression of retina images generated by WP Retina 2x. |
| 327 | * Solved a bug which caused the API key to be cleared on the settings page. |
| 328 | * Fixed an error that occurred with some PHP 7 installations. |
| 329 | * Fixed an fopen error when preserving metadata. |
| 330 | |
| 331 | = 2.0.2 = |
| 332 | * Faster Bulk Optimization page with reduced memory usage (thanks to @esmus). |
| 333 | * Fixed XML-RPC error (thanks @ironmanixs, @gingerdog, @quicoto and @isaumya). |
| 334 | |
| 335 | = 2.0.1 = |
| 336 | * Fixed a bug when searching from the admin interface (thanks to @bapcsuk). |
| 337 | |
| 338 | = 2.0.0 = |
| 339 | * Completely new Bulk Optimization page. |
| 340 | * Better detection of image sizes with duplicate filenames. |
| 341 | * Simplified account activation and API key creation. |
| 342 | * Fix to the bottom drop-down menu in the Media Library. |
| 343 | * Use the latest PHP client library for connecting to TinyJPG and TinyPNG. |
| 344 | * Added fallback to fopen for older systems running PHP 5.2. |
| 345 | |
| 346 | = 1.7.2 = |
| 347 | * Show more information about compressed image sizes in details popup. |
| 348 | * Add compression details to image overview. |
| 349 | |
| 350 | = 1.7.1 = |
| 351 | * Preserve GPS locations and creation dates in the original JPEG images. |
| 352 | * Option to preserve copyright information in your original PNG images. |
| 353 | * Improved detection of unsupported file types. |
| 354 | |
| 355 | = 1.7.0 = |
| 356 | * Option to preserve copyright information in your original JPEG images. |
| 357 | * Added proxy support for cURL. |
| 358 | * Support for translate.wordpress.org plugin translations. |
| 359 | |
| 360 | = 1.6.0 = |
| 361 | * Improved compression status in the Media Library with new details window. |
| 362 | * Show total compression savings on the Media Settings page. |
| 363 | * Moved Compress All Images from the Tools to the Media menu. |
| 364 | |
| 365 | = 1.5.0 = |
| 366 | * Resize original images by specifying a maximum width and/or height. |
| 367 | * Support for the mobile WordPress app (thanks to David Goodwin). |
| 368 | |
| 369 | = 1.4.0 = |
| 370 | * Indication of the number of images you can compress for free each month. |
| 371 | * Link to the Media Settings page from the plugin listing. |
| 372 | * Clarification that original images will be overwritten when compressed. |
| 373 | |
| 374 | = 1.3.2 = |
| 375 | * Detect different thumbnail sizes with the same dimensions. |
| 376 | |
| 377 | = 1.3.1 = |
| 378 | * Media library shows files that are in the process of compression. |
| 379 | |
| 380 | = 1.3.0 = |
| 381 | * Added option to bulk compress your whole media library in one go. |
| 382 | * Better indication of image sizes that have been compressed. |
| 383 | * Detection of image sizes modified after compression by other plugins. |
| 384 | |
| 385 | = 1.2.1 = |
| 386 | * Prevent compressing the original image if it is the only selected image size. |
| 387 | |
| 388 | = 1.2.0 = |
| 389 | * Show if you entered a valid API key. |
| 390 | * Display connection status and number of compressions this month. |
| 391 | * Show a notice to administrators when the free compression limit is reached. |
| 392 | * The plugin now works when php's parse_ini_file is disabled on your host. |
| 393 | * Avoid warnings when no image thumbnail sizes have been selected. |
| 394 | |
| 395 | = 1.1.0 = |
| 396 | * The API key can now be set with the TINY_API_KEY constant in wp-config.php. This will work for normal and multisite WordPress installations. |
| 397 | * Enable or disable compression of the original uploaded image. |
| 398 | * Improved display of original sizes and compressed sizes showing the total compression size in the Media Library list view. |
| 399 | |
| 400 | = 1.0.0 = |
| 401 | * Initial version. |
| 402 |