Download the PHP package wol-soft/twig-include-dir without Composer
On this page you can find all versions of the php package wol-soft/twig-include-dir. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wol-soft/twig-include-dir
More information about wol-soft/twig-include-dir
Files in wol-soft/twig-include-dir
Package twig-include-dir
Short Description Include all twig templates within a directory
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 twig-include-dir
twig-include-dir
Include all twig templates within a directory
Features
- Provide a directory with multiple .twig templates and all templates will be included
- Add recursive keyword to include all templates within a directory recursive
- known variable handling as known from include using the keywords only and with
Requirements
- Requires Twig >= 2.7
- Requires PHP >= 7.2
Installation
The recommended way to install twig-include-dir is through Composer:
Why?
An example use case could be: you set up a site using bootstrap with many modals. Now you don't need to throw all your modals together in a file or include each modal manually but instead you can separate your modals by using one file for each modal. Throw all modals in a modal-directory and simply include the whole directory. Adding a new modal? No problem, just create a new template file in your modal-directory.
Getting started
To use twig-include-dir you need to add the include-dir token parser to your Twig Environment first:
Afterwards you can start using the added token includeDir in your templates:
The files in the directory will be included alphabetically.
Recursive usage
To include all files within a given directory recursive simply add the keyword recursive to your include statement:
Now also the modals from the directories /modals/user and /modals/system etc. will be included.
Caution: The templates will be included alphabetically as well, including the directories. Thus the template /modals/footer.twig will be included before the templates from the directory /modals/system followed by /modals/user followed by a possible /modals/zebraHeader.twig. It is recommended to use twig-include-dir only for templates which do not require a specific order.
Variables
As known from the Twig Core include you can control the available variables with the keywords with and only (compare: include)
