Skip to content
User-level docs website for the SilverStripe Framework and CMS
Branch: master
Clone or download
Latest commit 7fc0f7e Oct 4, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
app NEW Add silverstripe/mfa userguide to userhelp Aug 5, 2019
.editorconfig Adding .editorconfig Dec 4, 2014
.htaccess FIX Revert PHP 7 introduction, tighten constraint on SS 3.6.x and add… Jun 12, 2018
.platform.yml Indicate PHP 7.3 preference Jul 8, 2019 DOCS Update readme: fix typos, minor adjustments Mar 23, 2017
composer.json Revert temporary fork of toolbar, lock to ~4.2.3 Aug 12, 2019
googlebc8410d1be96e910.html Add Google webmaster tools verification Jun 13, 2018
phpunit.xml.dist Updated phpunit to 3.x compat Jun 10, 2013
robots.txt Clean docs folders of executable files and move repo config to config… Feb 8, 2016

This is the source code powering It primarily consists of the SilverStripe framework and the docsviewer module with minimal configuration.

For adding functionality or editing the style of the documentation see the docsviewer module.

Getting started

To set up a local development environment:

  1. Use a _ss_environment.php file to configure your site.
  2. Clone this repository to a LAMP server.
  3. Install Composer.
  4. Run composer install to install dependancies.
  5. Run BuildTask ./framework/sake dev/tasks/RefreshMarkdownTask flush=1
  6. Make sure to flush the cache for markdown content to show up.

Source Documentation Files

Documentation for each module is stored on the filesystem via a full git clone of the module to the assets/src/ subdirectory. These checkouts are ignored from this repository to allow for easier updating and to keep this project small. For the main documentation, a branch is used for each minor version of SilverStripe CMS.

To update or download the source documentation at any time run the following BuildTask command with sake:

cd /Sites/
sake dev/tasks/RefreshMarkdownTask flush=1

This build task will download / update each module as listed in the app/_config/docs-repositories.yml file. Running sake dev/tasks/RebuildLuceneDocsIndex flush=1 will then create a search index and reindex the documentation to facilitate searching.

Once the build task has executed and downloaded the latest files, those files are registered along with the module version the folder relates to through the app/_config/docsviewer.yml file.

      Path: "assets/src/userhelp_3.2/docs/"
      Title: "User Help"
      Version: "3.2"
      Stable: true
      DefaultEntity: true

Set Stable: true on the set of documentation relating the current stable version of SilverStripe CMS.


To contribute an improvement to the functionality or theme, submit a pull request on GitHub. Any approved pull requests will make their way onto the site in the next release.

The content for is stored in a separate repository: If you wish to edit the documentation content, submit a pull request to that Github project. Updates to the content are synced regularly with via the cron job UpdateDocsCronTask.

Cron job

The cron job UpdateDocsCronTask includes tasks that fetch the latest documentation for each module from git and rebuilds the search indexes.

public function getSchedule() {
    return "0 8 * * *"; // runs process() function every day at 8AM


Deployment is via the SilverStripe Platform deployment tool.

You can’t perform that action at this time.