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
        }
    }
}