Version 6 pre-stable
This version of Silverstripe CMS has not yet been given a stable release. See the release roadmap for more information. Go to documentation for the most recent stable version.

SiteConfig

The silverstripe/siteconfig module provides a generic interface for managing site-wide settings or functionality which is used throughout the site. Out of the box, this includes setting the site name and site-wide access.

Accessing variables

SiteConfig options can be accessed from any template by using the $SiteConfig variable.

$SiteConfig.Title
$SiteConfig.Tagline

<% with $SiteConfig %>
    $Title $AnotherField
<% end_with %>

To access variables in the PHP:

use Silverstripe\SiteConfig\SiteConfig;

$config = SiteConfig::current_site_config();

// prints "Website Name"
echo $config->Title;

Extending SiteConfig

To extend the options available in the panel, define your own fields via an Extension.

// app/src/Extension/CustomSiteConfig.php
namespace App\Extension;

use SilverStripe\Core\Extension;
use SilverStripe\Forms\FieldList;
use SilverStripe\Forms\HTMLEditor\HTMLEditorField;

class CustomSiteConfig extends Extension
{
    private static $db = [
        'FooterContent' => 'HTMLText',
    ];

    protected function updateCMSFields(FieldList $fields)
    {
        $fields->addFieldToTab('Root.Main', HTMLEditorField::create('FooterContent', 'Footer Content'));
    }
}

Then apply the extension.

# app/_config/extensions.yml
Silverstripe\SiteConfig\SiteConfig:
  extensions:
    - App\Extension\CustomSiteConfig

After adding the class and the YAML change, make sure to rebuild your database and flush the cache by running sake db:build --flush.

You can define as many extensions for SiteConfig as you need. For example, if you're developing a module and want to provide the users a place to configure site-wide settings then the SiteConfig panel is the place to go it.

API documentation

Edit on Github