webmen / silverstripe-webp-images
webp images module
Installs: 6 269
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 5
Forks: 4
Open Issues: 0
Requires
- php: ^8.1
- silverstripe/cms: ^5
Requires (Dev)
README
This SilverStripe module generates webp images from resized jpeg and png images.
Requirements
- See
composer.json
requirements - GD with webp support
Installation
composer require wedevelopnl/silverstripe-webp-images
Next, you'll need to run a dev/build
(or at least flush
) to allow access to files with the .webp
extension from the .htaccess
in your assets
directory.
Known issues
Using $Image.DisableWebP
in a template
Putting $Image.DisableWebP
in a template will not work, this somehow calls getUrl twice, properly disabling the webp URL generation on the first run, but actually outputting the second run after which the disabled flag will have been removed. A workaround for this is to use <img $Image.DisableWebP.AttributesHTML />
License
See License
Maintainers
Configuration
SilverStripe\Core\Injector\Injector: WeDevelop\WebpImages\WebpGenerator: properties: enabled: true quality: 80
To disable generating webp images in code
WebpGenerator::singleton()->setEnabled(false)
Development and contribution
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. See read our contributing document for more information.
Getting started
We advise to use Docker/Docker compose for development.
We also included a Makefile to simplify some commands
Our development container contains some built-in tools like PHPCSFixer
.
Getting development container up
make build
to build the Docker container and then run detached.
If you want to only get the container up, you can simply type make up
.
You can SSH into the container using make sh
.
All make commands
You can run make help
to get a list with all available make
commands.