twig-natural-join
Twig filter that joins an array using a different separator for the last element (e.g. "John, Mary, Bob and Jim")., (*1)
, (*2)
Installation
The filter is registered at Packagist as cviebrock/twig-natural-join and can be installed using composer:, (*3)
"require": {
...
"cviebrock/twig-natural-join": "0.9.*",
}
Or just download the zip file and copy the file into your src folder., (*4)
Enable the extension:, (*5)
$twig = new Twig_Environment($loader, $options);
$twig->addExtension(new Cviebrock\Twig\NaturalJoinExtension());
If you are using Laravel and rcrowe/twigbridge, then enable the extension by adding an entry to the enabled array in app/config/packages/rcrowe/twigbridge/extensions.php:, (*6)
'enabled' => [
...
'Cviebrock\Twig\NaturalJoinExtension',
],
Usage
Pass the normal seperator and final seperator to the filter:, (*7)
{{ names|naturaljoin(", ", " and ") }} // John, Bill, Bob and Mary
Optionally pass true as a third argument to turn on "Oxford" mode, which will add a normal seperator before the final seperator:, (*8)
{{ names|naturaljoin(", ", " and ", true) }} // John, Bill, Bob, and Mary
Bugs, Suggestions and Contributions
Please use Github for bugs, comments, suggestions., (*9)
- Fork the project.
- Create your bugfix/feature branch and write your (well-commented) code.
- Commit your changes and push to your repository.
- Create a new pull request against this project's
master branch.
Copyright and License
twig-natural-join was written by Colin Viebrock and released under the MIT License. See the LICENSE file for details., (*10)
Copyright 2014 Colin Viebrock, (*11)