webcoast/file-backend-layouts

为 TYPO3 CMS 提供基于文件的后端布局提供者

安装: 870

依赖者: 0

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 0

开放问题: 0

类型:typo3-cms-extension

dev-master / 1.x-dev 2023-06-15 13:20 UTC

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