stnvh/silverstripe-infoboxes

Conditional CMS info boxes.

Silverstripe Info Boxes

, _(*1)

Conditional CMS info boxes., _(*2)

, _(*3)

By Stan Hutcheon - Bigfork Ltd, _(*4)

Installation:

Composer:

composer require stnvh/silverstripe-infoboxes ~1

Download:

Clone this repo into a folder called infoboxes in your silverstripe installation folder., _(*5)

Usage:

It currently has 5 built in checks:, _(*6)

• Dev mode
• Favicon existance
• Google analytics code
• Default password
• if www is used

To add a check, create a file in /mysite/code/ called InfoBox_[your_check_name].php with the following functions:, _(*7)

example:, _(*8)

<?php

class InfoBox_example implements InfoBox {

    public function show() {
        return Director::isLive(); // Our conditional code, this can be anything as long as it returns true or false
    }

    public function message() {
        return 'Live Mode'; // Message to be displayed
    }

    public function severity() {
        return 2; // 0 = severe, 1 = warning, 2 = info
    }

    public function link() {
        // Can be any internal or external URL, or false if none
        return 'http://doc.silverstripe.org/framework/en/topics/debugging/#environment-types';
    }

}

You can now programmatically disable specific checks via the config API. Either via config.yml:, _(*9)

InfoBoxes:
  disabled:
    - example
    - dev
    - www

or via _config.php:, _(*10)

<?php

InfoBoxes::set_disabled('example');
// or
InfoBoxes::set_disabled(array('www', 'dev'));

You can either use the concatenated classname (e.g InfoBox_www -> www) or the full class name., _(*11)

After installing via composer, or after adding a new InfoBox, you must /dev/build, _(*12)