This upgrade includes CMS and Framework version 3.6.1 which includes bugfixes and some minor feature and API enhancements.

Upgrade to Recipe 1.7.0 is optional, but is recommended for all CWP sites.

This upgrade can be carried out by any development team familiar with SilverStripe CMS, but if you would like SilverStripe's assistance, please let us know.

Upgrading Instructions

In order to update an existing site to use the new basic recipe the following changes to your composer.json can be made:

"require": {
    "cwp/cwp-recipe-basic": "~1.7.0@stable",
    "cwp/cwp-recipe-blog": "~1.7.0@stable",
    "cwp/starter-theme": "~1.1.0@stable"
"prefer-stable": true

Accepted failing tests

In recipe 1.7.0 these module unit tests cause external errors, but do not represent legitimate issues.


  • UploadFieldTest.testAllowedExtensions — Behaviour intentionally altered by the MimeValidator module
  • UploadFieldTest.testSelect — Behaviour altered by SelectUploadField intentionally
  • UploadTest.testUploadTarGzFileTwiceAppendsNumber — This test is now expected to fail as the new MimeValidator module will no longer allow random content to be uploaded with a mismatched mime and file extension. The original test is attempting to upload a bunch of text as a gzip file.


  • QueuedJobsTest.testImmediateQueuedJob - Test self-aborts when detecting lack of available system resources (inconclusive).
  • QueuedJobsTest.testStartJob - Test self-aborts when detecting lack of available system resources (inconclusive).



  • UserDefinedFormControllerTest.testValidation - Test failure affected by global state (starter theme template overrides).
  • UserDefinedFormControllerTest.testRenderingIntoFormTemplate - Test failure affected by global state.
  • UserDefinedFormControllerTest.testRenderingIntoTemplateWithSubstringReplacement - Test failure affected by global state.

Change Log


Features and Enhancements

  • 2017-09-08 3e847a4 Only show header search form if one exists to use (Robbie Averill)
  • 2017-07-16 a626d0a Update GridField creation to be injectable (Franco Springveldt)
  • 2017-07-12 0f841cd Use a paragraph instead of a label for literal field titles (Robbie Averill)
  • 2017-07-11 1b472cd removed needless list from CheckboxGroupField and RadioField (Franco Springveldt)
  • 2017-06-29 eb89925 update PHP version constraint to >=5.6 (Franco Springveldt)
  • 2017-06-17 5ad7767 Display and export the submitter email (Cam Findlay)
  • 2017-05-15 8107cff Add TaxonomyType to group taxonomy terms by different types (Robbie Averill)


  • 2017-09-26 8e684de BlogArchiveWidget for PostgreSQL compatibility (Robbie Averill)
  • 2017-09-22 27044d8 Display individual years in blog archive widget when set to "Yearly" (Robbie Averill)
  • 2017-09-21 df04582 visibility for excludeSiteTreeClassNames changed and doc update (Franco Springveldt)
  • 2017-09-19 dd99980 only exclude SiteTree subclasses if they are set (Franco Springveldt)
  • 2017-09-01 2631175 Encode URLSegment to support multibyte member profile URLs (Robbie Averill)
  • 2017-08-28 277db10 gridfieldextensions updated to ^2.0 (Franco Springveldt)
  • 2017-08-28 e65d91a updated versionedfiles version constraint (Franco Springveldt)
  • 2017-08-28 11e8cc5 updated queuedjobs version constraint (Franco Springveldt)
  • 2017-08-28 357366d updated multivaluefield version constraint (Franco Springveldt)
  • 2017-08-28 722f9d3 updated gridfieldextensions constraint (Franco Springveldt)
  • 2017-08-28 03ae4cc gridfieldextensions updated to 2.0.x-dev (Franco Springveldt)
  • 2017-08-28 0ded303 versionedfiles vendor updated to symbiote (Franco Springveldt)
  • 2017-08-28 34c3ffa bumped advancedworkflow version constraint as 4.0.x-dev (Franco Springveldt)
  • 2017-08-28 da1b715 bumped advancedworkflow version constraint (Franco Springveldt)
  • 2017-08-27 19bb05b referenced symbiote as a vendor (Franco Springveldt)
  • 2017-08-25 e2d01ba loosened core version constraints (Franco Springveldt)
  • 2017-08-24 1bbef96 lumberjack version updated (Franco Springveldt)
  • 2017-08-24 0d56304 - prepended silverstripe to symbiote module names (Franco Springveldt)
  • 2017-08-22 19897e0 Fixes #59 Minor changes wr/t typos. (Russell Michell)
  • 2017-08-21 afa4e75 HTML or plain text toggle works across PJAX requests (Robbie Averill)
  • 2017-08-16 fac99f7 Alias object context in closure for PHP 5.3 compat, add test to cover it (Robbie Averill)
  • 2017-08-08 236bf6d added date formatting (Franco Springveldt)
  • 2017-08-03 06269e8 Return a non-zero exit code when Solr_Configure has an exception (Robbie Averill)
  • 2017-08-02 1697cf4 Remove title from userforms checkbox holder (Sacha Judd)
  • 2017-07-26 3a18b9f If BlogPost has date field, return it in getDate (Daniel Hensby)
  • 2017-07-19 c29438f Dont generate urlsegments if we dont need to (Daniel Hensby)
  • 2017-07-13 c98fa0b fieldset without a legend shouldn't be a fieldset (Franco Springveldt)
  • 2017-07-09 8f2aaf5 ed link formats in performance guide docs (Ingo Schommer)
  • 2017-07-07 3e7f021 Compatibility with userforms 3/4 getCMSFields, remove deprecated getSettings use etc (Robbie Averill)
  • 2017-07-06 a8860d9 formatting errors (Glen Peek)
  • 2017-07-06 3572328 getBaseStyles examples (Glen Peek)
  • 2017-06-30 c1afb3a Remove css fields animation on add :wrench: (Sacha Judd)
  • 2017-06-26 1e1b596 use the correct method for CSV exports and include the full file path (Franco Springveldt)
  • 2017-06-22 dbe2315 Remove duplicate title attribute content (Robbie Averill)
  • 2017-06-22 b5da9f9 add btn btn-link class for firefox focus (Sacha Judd)
  • 2017-06-21 899aa2c add class btn to navbar-touch-caret for focus visible in firefox (Sacha Judd)
  • 2017-06-21 683ee14 Preview recipient email link for SS 3.6 (Robbie Averill)
  • 2017-06-20 d88ce28 Pass submissions GridFieldConfig to GridField constructor to avoid error in state (Robbie Averill)
  • 2017-06-17 0d6b44a mysql >= 5.7 sql_mode=only_full_group_by error (Franco Springveldt)
  • 2017-06-15 9378147 add outline-focus status for buttons (Sacha Judd)
  • 2017-06-15 12198e2 Remove specific page edit URL from tests to ensure multi SS version compatibility (Robbie Averill)
  • 2017-06-14 b33a16a ADFS docs to account for DR instances (John)
  • 2017-06-14 7774cff Bump comments constraint to ^2.0 (Robbie Averill)
  • 2017-06-14 1073eca2f Complex (curly) syntax (Marcz Hermo)
  • 2017-06-14 fd57bd910 Update help link from 3.5 to 3.6 (Robbie Averill)
  • 2017-06-12 c02d851 Remove providePermissions tests (Robbie Averill)
  • 2017-06-12 f0c00bfb7 ing language typo in docs (3Dgoo)
  • 2017-06-08 e965942 Selector for HTML/plain email content toggle. Show preview button for both. (Robbie Averill)
  • 2017-06-08 bf20e19 Ensure HTML email preview content is parsed as HTML including shortcodes (Robbie Averill)
  • 2017-06-08 c02181e Use configuration nesting wrapper around themed preview logic (Robbie Averill)
  • 2017-06-08 6e69972 default values for EditableMultipleOptionField subclasses (Florian Thoma)
  • 2017-06-05 182cab0 Override Bootstrap .hide definition for userforms formfields (Robbie Averill)
  • 2017-06-05 15f5b83 Update userforms holder ID to match default templates (Robbie Averill)
  • 2017-06-05 51890f6 Remove "hide" class from form inputs, leave it on the field holder - fixes display rules issue (Robbie Averill)
  • 2017-06-02 a52ed03b4 Upgrade old style constructors that were missed (Daniel Hensby)
  • 2017-06-01 c08bd67 Escape search term in page title (Robbie Averill)
  • 2017-05-29 b4368196d Use plural name for ModelAdmin tab name (Robbie Averill)
  • 2017-05-24 ec2b012 incorrect calculation of MAX_FILE_SIZE (#600) (Reece Alexander)
  • 2017-05-02 0d97864 Viewer Groups not loading, unable to select fixes #55 (Shea)
  • 2017-04-12 2cd7db9 Add translation to some areas of BlogMemberExtension that were missing them (Rastislav Brandobur)
  • 2017-04-10 6b76bc6 Ensure field GridField has a 100% relative width rather than fixed (Robbie Averill)
  • 2017-03-16 dd3efa1 typo in template variable (Michal Kleiner)
  • 2017-01-31 262cbf7 jquery validate attempting to validate ul as input (Igor Nadj)
  • 2016-12-19 99e7e34 ed a bug in the generatePDF function where the wkhtmltopdf_binary config option was being ignored. (Mitchell Bennett)

Was this article helpful?