belayout_fileprovider
belayout_fileprovider copied to clipboard
A File provider for Backend Layouts
TYPO3 extension "belayout_fileprovider"#
This extension makes it possible to use files for the backend layout configuration.
Requirements
- TYPO3 CMS 6.2
- Some basic code for the
ext_localconf.php
file, see below
How to use
1. Add the files
First of all you need to install the extension. Then you need to register your files. Choose one of the following options
By directory
If you define a directory, all files with the file type "ts", "ts1" or "txt" within this directory are used.
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['BackendLayoutFileProvider']['dir'][]
= 'EXT:belayout_fileprovider/Resources/Private/Examples/BackendLayouts/';
By extension key
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['BackendLayoutFileProvider']['ext'][]
= $_EXTKEY;
Basically it is the same as "by directory" but you don't need to add the path as this is always EXT:<extkey>/Resources/Private/BackendLayouts/
.
By single file
You can also add a single file.
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['BackendLayoutFileProvider']['file'][]
= 'EXT:belayout_fileprovider/Home.ts';
2. Adapt the TypoScript
To be able to use the layout, adapt your TypoScript to look like the example below.
The layout file got the name Home.ts
, therefore the identifier for the cObj TEXT is file__Home
.
10 = FLUIDTEMPLATE
10 {
file.stdWrap.cObject = TEXT
file.stdWrap.cObject {
data = levelfield:-2,backend_layout_next_level,slide
override.field = backend_layout
split {
token = file__
1.current = 1
1.wrap = |
}
wrap = EXT:modernpackage/Resources/Private/Templates/|.html
}
layoutRootPath = EXT:modernpackage/Resources/Private/Templates/Layouts/
variables {
}
}
Additional options
Translations
An optional locallang.xml or locallang.xlf file in this same directory can hold a translation of the layout. The identifier in the translation file is the file name without the file extension.
Icon
An optional can be defined by using the same file name and an extension of the type png, gif or jpg. However be sure that the file is callable as there might be a rule in the .htaccess file restricting access to content on directories called Private.
To avoid any troubles, save the icon in Resources/Public/BackendLayouts/
with the same name.