adrexia / brand
为 silverstripe 提供品牌和基本网站主题管理
Requires
- heyday/silverstripe-colorpalette: dev-update-ss4
- littlegiant/silverstripe-singleobjectadmin: ^2.0
- ryanpotter/silverstripe-color-field: dev-master
- silverstripe/framework: ^4.0
This package is auto-updated.
Last update: 2024-09-06 16:20:50 UTC
README
一个模块,帮助网站的基本品牌建设。允许在 Silverstripe 管理员中设置品牌颜色和字体。
要求
SilverStripe 4 或更高版本。查看 3.0 分支以获取 SilverStripe 3 支持
安装
composer require adrexia/brand
设置
您可以选择仅包含 Favicon,并手动应用颜色方案:<% include Adrexia/Brand/Favicons %>
或者,将品牌模板包含在页面模板的头部以获取两者
<% include Adrexia/Brand/Brand %>
默认情况下,这包括字体、字体颜色和 Favicon。菜单颜色留给您实现或根据网站需求禁用。调色板颜色用于其他页面类型或自定义主题。例如,可以使用它们向页面添加受限的调色板(借助颜色调色板模块)
$brand = Brand::get()->First();
if($brand) {
$fields->insertAfter(
ColorPaletteField::create(
"Color", "Color", $brand->getFullPalette()
), "Intro"
);
}
包含一个名为 'BrandDataObjectExtension' 的扩展用于此目的,它添加了品牌颜色、对比颜色和图像。要启用它,将以下内容添加到您的 _config.yml 文件中
Page:
extensions:
- Adrexia\Brand\BrandDataObjectExtension
其他提供的变量可以在模板中通过以下方式调用
$Brand.Logo
$Brand.BodyBackgroundColour
要从模板中的调色板获取颜色值的十六进制值,您可以进行如下操作
<% if $Colour %>$Brand.getHex($Colour)<% else %>$Brand.getHex($Level(1).Colour)<% end_if %>
子站支持
注意:子站支持在 silverstripe 4 中尚未完成
此模块可以与 adrexia/subsite-modeladmins(特别是 onBeforeWrite 和 augmentSQL 函数)的 SubsiteModelExtension 一起使用。您可以通过 composer require 安装它,或者仅取您需要的部分
composer require adrexia/subsite-modeladmins
设置
在您的 yml 配置中
Adrexia\Brand\Brand:
extensions:
- SubsiteModelExtension
Adrexia\Brand\BrandAdmin
extensions:
- SubsiteMenuExtension
品牌扩展由子站模型管理员模块提供。品牌管理员扩展直接来自子站模块,并启用 CMS 菜单中的菜单项。