[![Build Status][ico-github-actions]][link-github-actions]
![Quality Score][ico-code-quality]
, (*1)
This library integrates LoremPixel service into Twig. You can use it to generate random image urls that you can use as placeholders in your application., (*2)
Installation
composer require "davidepastore/lorempixel-twig-extension"
Usage
Add LoremPixelTwigExtension to your Twig extensions:, (*3)
$twig->addExtension(new LoremPixelTwigExtension());
In the templates, you then just call <img src="{{ lorempixel() }}">., (*4)
You can use different parameters for this function in this order:, (*5)
| Name |
Type |
Description |
Default |
Example |
| gray |
boolean |
Is it a gray image? |
false |
lorempixel(true) |
| width |
int |
The width of the image. |
400 |
lorempixel(true, 500) |
| height |
int |
The height of the image. |
200 |
lorempixel(true, 500, 300) |
| category |
string |
The category of the image. You can find all supported categories here. |
null |
lorempixel(true, 500, 300, 'cats') |
| number |
int |
The number of the image from the given category. |
null |
lorempixel(true, 500, 300, 'cats', 2) |
| text |
string |
The custom text to add to the image. |
null |
lorempixel(true, 500, 300, 'cats', 2, 'Dummy Text') |
An example with all the parameters could be:, (*6)
<img src="{{ lorempixel(true, 500, 300, 'cats', 2, 'Dummy Text') }}">
Testing
bash
$ phpunit, (*7)
Contributing
Please see CONTRIBUTING for details., (*8)
Credits
License
This library is released under the MIT license., (*9)