Similar to the app: perch_kraken, but uses the TinyPNG/TinyJPG API to optimize your uploaded images. TinyPNG/TinyJPG offers their service for free for the first 500 optimizations each month.
- 2 operation modes configurable via Perch Settings:
On UploadorCRON - Queue table shows image, original file size, tiny file size, graphical savings percent bar, and ReQueue options.
- TinyImage Options page allows for manual processing of the queue and a queue cleaning function to purge data if files have been deleted from the server.
- From the root of your project, run the following command to add the app as a submodule. Note to replace
<perch_path>with the path or folder for perch from the root of your project :
$ git submodule add git@github.com:cognetif/tinyimg.git <perch_path>/addons/apps/cognetif_tinyimg
- Download the zip: https://github.com/cognetif/tinyimg/archive/master.zip
- Unzip the file and rename the parent folder to
cognetif_tinyimg. - Copy the
cognetif_tinyimgtoaddons/apps/folder and addcognetif_tinyimgto yourapps.phpfile. - Create an API Key at: https://tinyjpg.com/developers
- Add your API Key in the Tinify API Key settings on the main Perch Settings page.
- You can find the settings for the app in the Perch Settings page
- There is a new app TinyImage in the main side menu available which you can use to access the queue page and options page.
- From the queue page, you can see how many images are in the queue and for those that are done, what % file size reduction has been accomplished.
- You can also re-queue an image if something does not seem right.
- From the options page you can manually run the queue or clean the queue if images have been deleted from the assets system.
- If you have the Perch Scheduled Tasks setup and running, the queue will automatically get cleaned each day.
In the Perch settings page, you can specify if you want to optimize the images in the queue directly on upload or via a scheduled task.
If you select the "Upload" mode, they will be optimized as soon as a user uploads the image but the upload request will take longer.
Optimizing with "CRON" mode will not hinder the upload request, but unoptimized images will be served until the scheduled task completes and optimizes all the images in the queue.
On the Perch settings page, you can specify the CRON frequency in minutes.
If you are using the "CRON" mode, you must have setup the Perch scheduled tasks as documented.
There are 2 ways to handle the original file uploaded and its configurable from the settings page :
- Compress: This saves hosting disk usage as the original file is uploaded and compressed to a smaller file size. Derived images from the original are also compressed. Some developers do not like that derived images are compressed from a compressed source.
- No Compression: This uses more hosting disk space as the original file is not compressed. This mode is intended for developers who want the derived images to be created from an uncompressed source.
This project is free, open source, and GPL friendly. You can use it for commercial projects, open source projects, or really almost whatever you want.
This is free software but it took some time to develop. If you use it, please send me a message I'd be interested to know which site uses it. If you appreciate the app and use it regularly, feel free to Buy me a Beer!
Create a GitHub Issue: https://github.com/cognetif/tinyimg or better yet become a contributor.
Cognetif : Jordin Brown jbrown@cognetif.com