webcoast / file-backend-layouts
为 TYPO3 CMS 提供基于文件的后端布局提供者
dev-master / 1.x-dev
2023-06-15 13:20 UTC
Requires
- typo3/cms-backend: ^v9.5 || ^v10.4 || ^v11.5 || ^v12.4
- typo3/cms-core: ^v9.5 || ^v10.4 || ^v11.5 || ^v12.4
This package is auto-updated.
Last update: 2024-09-15 15:53:24 UTC
README
以文件的形式提供后端布局定义,例如与您的网站包或主题扩展一起分发。
安装
使用 composer 安装扩展
composer req webcoast/file-backend-layouts
或从 TER 安装。
用法
注册后端布局
您可以使用 API 从您的网站包或主题扩展注册后端布局。
在您的扩展中使用 ext_tables.php
并包含
WEBcoast\FileBackendLayouts\Utility\ConfigurationUtility::registerBackendLayouts('your_site_package');
将您的后端布局 ts 配置文件放置在 EXT:your_site_package/Configuration/BackendLayouts
。页面属性选择器中布局的翻译语言文件为 EXT:your_site_package/Resources/Private/Language/locallang_backend.xlf
。标签前缀为 backendLayouts.
,因此如果您有一个布局文件 homepage.tsconfig
,语言文件中的标签将是 backendLayouts.homepage
。
更改路径
如果您想更改后端布局文件或语言文件的路径,请作为第二个或第三个参数提供它们。
WEBcoast\FileBackendLayouts\Utility\ConfigurationUtility::registerBackendLayouts('your_site_package', 'Resources/Private/BackendLayouts', 'Resources/Private/Language/backendLayouts.xlf');
您还可以将第一个参数设置为 null
,如果您不希望更改 ts 配置文件的路径。
WEBcoast\FileBackendLayouts\Utility\ConfigurationUtility::registerBackendLayouts('your_site_package', null, 'Resources/Private/Language/backendLayouts.xlf');
TypoScript
该扩展提供了一个 TypoScript 模板包含,其中包含 lib.backendLayout = TEXT
,它将页面属性中选择的布局(包括下一级继承)转换为布局值。
如果您的 ts 配置文件名为 homepage.tsconfig
,则 lib.backendLayout
的结果将是 homepage
。这可以用作页面流体模板中的模板名称。
page {
20 = FLUIDTEMPLATE
20 {
templateName < lib.backendLayout
templateRootPaths {
10 = EXT:your_site_package/Resources/Private/Template/Page
}
}
}
# or alternatively as variable `layout`
page {
20 = FLUIDTEMPLATE
20 {
file = ...
variables {
layout < lib.backendLayout
}
}
}