endroid / image-placeholder-bundle
Endroid Image Placeholder
Fund package maintenance!
endroid
Requires
- php: >=7.2
- endroid/installer: ^1.2.2
Requires (Dev)
- endroid/quality: dev-master
- twig/twig: ^2.4||^3.0
README
By endroid
Provides a Twig filter that replaces empty or invalid URLs with a placeholder image from any of the registered image providers.
Installation
Use Composer to install the library.
$ composer require endroid/image-placeholder
Configuration
The default placeholder generation parameters can be overridden via the constructor arguments or service definition. All parameters are optional.
Usage
Placeholders are placed via a Twig filter that shows the placeholder image in case the service is activated and the given URL is empty or invalid.
<img src="{{ image_url|image_placeholder(200, 300) }}" /> <img src="{{ image_url|image_placeholder(200, 300, { provider: 'placehoff' }) }}" />
Providers
Currently the following providers are supported.
- baconmockup.com
- loremflickr.com
- lorempixel.com
- pipsum.com
- placebear.com
- place-hoff.com
- placeholder.pics
- placehold.it
- placeskull.com
- unsplash.it
Versioning
Version numbers follow the MAJOR.MINOR.PATCH scheme. Backwards compatibility breaking changes will be kept to a minimum but be aware that these can occur. Lock your dependencies for production and test your code when upgrading.
License
This library is under the MIT license. For the full copyright and license information please view the LICENSE file that was distributed with this source code.