Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/ubc/apsc-site-settings/archive/refs/heads/main.zipThis plugin adds several APSC-specific theme settings in a new 'APSC Options' tab in Appearance > Theme Options.
APSC Unit Selection
A drop-down field allowing a site administrator to select which unit this site represents. By choosing an appropriate unit and saving the theme options this will automatically change the Colour Palette and Gradients that are available within the editor. This will also automatically adjust any unit-specific colours within block patterns to be the appropriate colour for the chosen unit.
Default Value: APSC
Use Open Sans Font
A checkbox which, when selected, will load the Open Sans font from Google Fonts on the front-end of the site.
Default Value: Unchecked (i.e. not loaded)
Use Lora Font
A checkbox which, when selected, will load the Lora font from Google Fonts on the front-end of the site.
Default Value: Unchecked (i.e. not loaded)
--
Note: If both the Open Sans and Lora font options are selected, then the URL is combined ensuring only one remote hit is made helping improve performance.
Hide CLF Address Bar
A checkbox which, when selected, will add a hide-clf-address-bar class to the body tag. Additionally some inline css is loaded which will then hide both the address bar and 'to top' link container.
Default Value: Unchecked (i.e. footer not hidden)
APSC Design System URL
A text entry field which will be used as the URL to load the APSC Design System. If this is left blank, then the URL from the UBC_APSCBLOCKS_DESIGN_SYSTEM_URL constant will be loaded, and if that is blank, then it will default to https://apsc-design-system.netlify.app/design-system.min.css
Default Value: https://apsc-design-system.netlify.app/design-system.min.css
see get_design_system_url() in APSC Blocks plugin for how this logic is detailed.
Define custom colours
A checkbox and set of colour pickers for primary, secondary, tertiary colours.
The colour pickers update via an AJAX call when the APSC Unit Selection is updated, or when standard CLF colours are selected (UBC CLF tab).
When the checkbox is selected, the values from the colour pickers are preserved and require manual input and saving for changes to apply.
The values for the colours are accessible in the CSS with these CSS variables:
--wp--preset--color--apsc-unit-primary
--wp--preset--color--apsc-unit-secondary
--wp--preset--color--apsc-unit-tertiary
Default Values: Set custom colours: Unchecked (i.e. footer not hidden) Colour pickers: Currently selected unit colour palette