silverware/admin

SilverWare Admin Module.

SilverWare Admin Module

, _(*1)

Allows an admin style for SilverStripe Admin v4 to be defined via configuration., _(*2)

Contents

• Background
• Requirements
• Installation
• Configuration
• Issues
• Contribution
• Maintainers
• License

Background

Spiritual successor to SilverStripe Moderno Admin, for SS4., _(*3)

Requirements

• SilverStripe Admin v4

Installation

Installation is via Composer:, _(*4)

$ composer require silverware/admin

Configuration

As with all SilverStripe modules, configuration is via YAML. Extensions to LeftAndMain are applied via config.yml., _(*5)

Admin Style

You can customise the admin appearance via YAML by defining an admin_style array in your configuration. This needs to be applied to LeftAndMain. For example:, _(*6)

SilverStripe\Admin\LeftAndMain:
  admin_style:
    ColorBackgroundMenuHeader: '#005b94'
    ColorBackgroundHoverMenuHeader: '#207bb4'
    ColorForegroundSiteName: '#fff'
    ColorForegroundProfile: '#fff'
    ColorIconLogo: '#fff'
    ColorIconProfile: '#fff'
    ColorIconLogout: '#fff'
    ColorBorderBottomSiteName: '#106ba4'
    ColorBackgroundMenu: '#20282c'
    ColorBackgroundMenuItem: '#20282c'
    ColorForegroundMenuItem: '#bfc0c0'
    ColorBackgroundHoverMenuItem: 'rgba(255, 255, 255, 0.1)'
    ColorForegroundHoverMenuItem: '#fff'
    ColorBackgroundCurrentMenuItem: '#139fda'
    ColorForegroundCurrentMenuItem: '#fff'
    ColorBorderRightMenuHide: false
    ColorBorderRightMenu: '#20282c'
    ColorIconMenuItem: '#bfc0c0'
    ColorIconHoverMenuItem: '#fff'
    ColorIconCurrentMenuItem: '#fff'
    ColorMenuItemAfterText: '#fff'
    ColorBackgroundToggle: '#20282c'
    ColorBorderTopToggle: '#20282c'
    ColorToggleStatus: '#fff'
    ColorToggleCollapse: '#fff'
    ColorBorderFocusField: '#139fda'

Each variable should be self-explanatory, with the exception of ColorBorderRightMenuHide. If set to true, the thin line on the right-hand side of the admin menu will be hidden, and ColorBorderRightMenu will be ignored., _(*7)

Disabling Admin Style

If you need to disable the admin style, so that the standard SS4 admin style is used, simply set admin_style_disabled to true for LeftAndMain:, _(*8)

SilverStripe\Admin\LeftAndMain:
  admin_style_disabled: true

Issues

Please use the GitHub issue tracker for bug reports and feature requests., _(*9)

Contribution

Your contributions are gladly welcomed to help make this project better. Please see contributing for more information., _(*10)

Maintainers

Colin Tucker	Praxis Interactive

License

BSD-3-Clause © Praxis Interactive, _(*11)