toastnz/theme-colours

Silverstripe theme colours module

1.1.4 2023-10-30 05:19 UTC

Requires

• php: >=8.1
• composer/installers: *
• heyday/silverstripe-colorpalette: ^2.0
• silverstripe/cms: ^5
• silverstripe/framework: ^5
• symbiote/silverstripe-gridfieldextensions: ^4
• tractorcow/silverstripe-colorpicker: 4.2
• undefinedoffset/sortablegridfield: ^2.0.4

BSD-3-Clause

• Emmanuel Davies
• Priscilla Yap

• modular
• silverstripe
• theme colours

README

Installation

The easiest way is to use composer:

composer require toastnz/theme-colours

Run dev/build afterwards.

Configuration

Add the following to your config.yml (optional) to generate default colours on dev/build Colours with a hex value will be locked and not editable in the CMS Colours with null value will be editable in the CMS

Toast\ThemeColours\Models:
  default_colours:
    - primary: null
    - secondary: null
    - black: '000000'
    - white: 'ffffff'

Usage

Colour functions

getColourCustomID() returns either the ID set in the config.yml, or for additional colours, returns the ID

getColourPaletteID() returns a combination of the getColourCustomID() and the Title, so the data object can be found from the selected colour palette field value.

getColourClassName() returns c- + getColourCustomID() so the css class is unique. c- is there to represent colour and to ensure the class does not start with a number.

getColourBrightness() returns either dark or light based on their luminocity of the colour value.

getColourHexCode() returns the hex value of the colour

getColourClasses() will return a combination of the getColourClassName() and getColourBrightness()

Helper functions

Helper::getThemeColourPalette() to loop through the $themeColours and add the Title and Value to the $array for ColorPaletteField to use.

Helper::getThemeColourFromColourPaletteID to loop through the $themeColours and return the object that matches the $colourPaletteID