Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chfoidl/typo3-fluidloader
Automatic fluid template loader for TYPO3 CMS
https://github.com/chfoidl/typo3-fluidloader
composer fluid-templates frontend php typo3 typo3-extension
Last synced: about 3 hours ago
JSON representation
Automatic fluid template loader for TYPO3 CMS
- Host: GitHub
- URL: https://github.com/chfoidl/typo3-fluidloader
- Owner: chfoidl
- License: gpl-3.0
- Created: 2017-04-26T19:46:46.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-06-06T21:12:46.000Z (over 7 years ago)
- Last Synced: 2023-07-15T22:06:58.734Z (over 1 year ago)
- Topics: composer, fluid-templates, frontend, php, typo3, typo3-extension
- Language: PHP
- Homepage:
- Size: 59.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TYPO3 Extension ``fluidloader``
[](https://travis-ci.org/Sethorax/typo3-fluidloader)
[](https://styleci.io/repos/89520397)
[](https://packagist.org/packages/sethorax/typo3-fluidloader)
[](https://packagist.org/packages/sethorax/typo3-fluidloader)
> This extension automatically loads HTML fluid template files from a directory.
### Features
- Automatically loads HTML template files from a directory as soon as they are added
- Available templates can be assigned to a page in the page settings
- Backend layout can directly in the template
This extension makes it very easy to work with different fluid templates for TYPO3 pages.
### Usage
#### Installation
Installation using Composer
It is recommended to install this extension via composer.
To install it just do ``composer require sethorax/typo3-fluidloader``
This extension can also be installed traditionally via the TYPO3 Extension Repository (TER).
#### Setup
1. Include the static TypoScript template of the extension.
2. Set your template, partial and layout root paths in the extension settings.
3. Start adding some HTML fluid templates to the template root path as you wold normally do.
4. Once a template is added, you can select this template in the page settings. Please note that the template must contain a special fluid section for the configuration options.
#### Fluid Template
##### Configuration Section
All templates must contain a special fluid section with the template configuration in XML format.
Example configuration:
```HTML
My awesome template
Full width
50% Width Left
50% Width Right
Some more content
```
The template configuration is located within the "configuration" fluid section.
The configuration is in XML format.
The configuration has one root element `configuration`. Within that element you can specify `general` configuration and the `backendLayout`.
Within `general` you can set the name of the template. This name will be used as the display value of the select field in the page settings.
Whitin `backendLayout` you can configure the backend layout of this template. The example above should be self explanatory. The content of the `column` elements is the label for that section.
Please note that the content of `` must be valid XML!
##### Rest of the template
The rest of the template is just standard fluid. You can specify as many sections as you like and of course set the layout of the template.
It is recommended to use the **FluidTYPO3 VHS** extension to easily render the columns.
The configuration of the current page can be accessed via the `page` fluid variable.
### Sidenotes
The creation of this extension was heavily inspired by FluidTYPO3's [fluidpages](https://github.com/FluidTYPO3/fluidpages) extension.