Download the PHP package superbig/craft-imagerpretransform without Composer
On this page you can find all versions of the php package superbig/craft-imagerpretransform. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download superbig/craft-imagerpretransform
More information about superbig/craft-imagerpretransform
Files in superbig/craft-imagerpretransform
Package craft-imagerpretransform
Short Description Pretransform any Assets on save, with Imager
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package craft-imagerpretransform
Imager Pretransform plugin for Craft CMS 3.x
Pretransform any Assets on save, with Imager
Requirements
This plugin requires Craft CMS 3.0.0-beta.23 or later.
Installation
To install the plugin, follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/project -
Then tell Composer to load the plugin:
composer require superbig/craft-imagerpretransform - In the Control Panel, go to Settings → Plugins and click the “Install” button for Imager Pretransform.
Imager Pretransform Overview
If you have suffered from memory or execution time issues when creating many transforms on demand, you should look into pre-generating transforms per image.
This plugin, combined with a long cache duration time, will make sure transforms will only be generated once, and one at a time.
When users upload an Asset, a task will be created, which in turn will use Imager to pre-generate the transform(s).
Configuring Imager Pretransform
Copy the config template from vendor/superbig/craft-imagerpretransform/src/config.php to craft/config as imager-pretransform.php and make your changes there to override default settings.
You can either have a set of transforms per Asset source handle:
Or just a set of transforms that will be applied to all Assets on upload/save:
You can also use a Twig template to setup your transforms:
The Twig template will be passed the variables asset and pretransform. You can check if pretransform is defined if you need to conditionally do transforms in a certain way.
_imager-pretransform.twig:
This way you can keep your transforms in one place.
You should also set Imager's cache duration to a long time, say 1 year:
In imager.php:
If any of your transform settings depends on a value from the specific Asset, you can pass a function instead of a string.
The function will be passed the Asset.
As an example, this is how you would use the built-in focal point selector in Craft:
Using Imager Pretransform
There is 3 ways to pretransform images:
- Automatically on upload
- Manually through element action
- Console command that takes either folder id or volume handle as argument
Console command
To transform assets in a volume:
./craft imager-pretransform/default/index --volume=<volumeHandle> or -v <volumeHandle>
To transform assets in a folder:
./craft imager-pretransform/default/index --folderId=<folder id>
By default, the command will only transform the topmost folder of the volume or the specified folder by id. To include all subfolders, add the --include-subfolders / -s param.
Brought to you by Superbig
