Skip to content

Commit

Permalink
Merge branch '2.3'
Browse files Browse the repository at this point in the history
  • Loading branch information
robbieaverill committed Sep 25, 2019
2 parents e73d622 + 5d015c7 commit b32499e
Show file tree
Hide file tree
Showing 7 changed files with 311 additions and 32 deletions.
50 changes: 49 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,55 @@ In some Browsers the SubsiteID is visible if you hover over the "Edit" link in t

### Subsite-specific themes

Download a second theme from http://www.silverstripe.com/themes/ and put it in your themes folder. Open admin/subsites?flush=1 and select one of your subsites from the menu on the bottom-left. You should see a Theme dropdown in the subsite details, and it should list both your original theme and the new theme. Select the new theme in the dropdown. Now, this subsite will use a different theme from the main site.
Download a second theme from http://www.silverstripe.com/themes/ and put it in your themes folder. Open
admin/subsites?flush=1 and select one of your subsites from the menu on the bottom-left. You should see a
Theme dropdown in the subsite details, and it should list both your original theme and the new theme. Select the new
theme in the dropdown. Now, this subsite will use a different theme from the main site.

#### Cascading themes

In SilverStripe 4 themes will resolve theme files by looking through a list of themes (see the documentation on
[creating your own theme](https://docs.silverstripe.org/en/4/developer_guides/templates/themes/#developing-your-own-theme)).
Subsites will inherit this configuration for the order of themes. Choosing a theme for a Subsite will set the list of
themes to that chosen theme, and all themes that are defined below the chosen theme in priority. For example, with a
theme configuration as follows:

```yaml
SilverStripe\View\SSViewer:
themes:
- '$public'
- 'my-theme'
- 'watea'
- 'starter'
- '$default'
```
Choosing `watea` in your Subsite will create a cascading config as follows:

```yaml
themes:
- 'watea'
- '$public'
- 'starter'
- '$default'
```

You may also completely define your own cascading theme lists for CMS users to choose as theme options for their
subsite:

```yaml
SilverStripe\Subsites\Service\ThemeResolver:
theme_options:
normal:
- '$public'
- 'watea'
- 'starter'
- '$default'
special:
- 'my-theme'
- 'starter'
- '$default'
```

### Limit available themes for a subsite

Expand Down
4 changes: 3 additions & 1 deletion src/Extensions/SiteTreeSubsites.php
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@
use SilverStripe\Security\Security;
use SilverStripe\SiteConfig\SiteConfig;
use SilverStripe\Subsites\Model\Subsite;
use SilverStripe\Subsites\Service\ThemeResolver;
use SilverStripe\Subsites\State\SubsiteState;
use SilverStripe\View\SSViewer;

Expand Down Expand Up @@ -390,10 +391,11 @@ public function canPublish($member = null)
*/
public static function contentcontrollerInit($controller)
{
/** @var Subsite $subsite */
$subsite = Subsite::currentSubsite();

if ($subsite && $subsite->Theme) {
SSViewer::add_themes([$subsite->Theme]);
SSViewer::set_themes(ThemeResolver::singleton()->getThemeList($subsite));
}

if ($subsite && i18n::getData()->validate($subsite->Language)) {
Expand Down
6 changes: 3 additions & 3 deletions src/Model/Subsite.php
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
use SilverStripe\Security\Member;
use SilverStripe\Security\Permission;
use SilverStripe\Security\Security;
use SilverStripe\Subsites\Service\ThemeResolver;
use SilverStripe\Subsites\State\SubsiteState;
use SilverStripe\Versioned\Versioned;
use UnexpectedValueException;
Expand Down Expand Up @@ -183,7 +184,6 @@ public static function set_allowed_themes($themes)
/**
* Gets the subsite currently set in the session.
*
* @uses ControllerSubsites->controllerAugmentInit()
* @return DataObject The current Subsite
*/
public static function currentSubsite()
Expand Down Expand Up @@ -788,7 +788,7 @@ public function fieldLabels($includerelations = true)
*/
public function allowedThemes()
{
if ($themes = self::$allowed_themes) {
if (($themes = self::$allowed_themes) || ($themes = ThemeResolver::singleton()->getCustomThemeOptions())) {
return ArrayLib::valuekey($themes);
}

Expand Down Expand Up @@ -875,7 +875,7 @@ public function domain()
}

// If there are no objects, default to the current hostname
return $_SERVER['HTTP_HOST'];
return Director::host();
}

/**
Expand Down
2 changes: 1 addition & 1 deletion src/Model/SubsiteDomain.php
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ public function getFullProtocol()
*/
public function getSubstitutedDomain()
{
$currentHost = $_SERVER['HTTP_HOST'];
$currentHost = Director::host();

// If there are wildcards in the primary domain (not recommended), make some
// educated guesses about what to replace them with:
Expand Down
99 changes: 99 additions & 0 deletions src/Service/ThemeResolver.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
<?php

namespace SilverStripe\Subsites\Service;

use SilverStripe\Core\Config\Configurable;
use SilverStripe\Core\Injector\Injectable;
use SilverStripe\Subsites\Model\Subsite;
use SilverStripe\View\SSViewer;

class ThemeResolver
{
use Injectable;
use Configurable;

/**
* Cascading definitions for themes, keyed by the name they should appear under in the CMS. For example:
*
* [
* 'theme-1' => [
* '$public',
* 'starter',
* '$default',
* ],
* 'theme-2' => [
* 'custom',
* 'watea',
* 'starter',
* '$public',
* '$default',
* ]
* ]
*
* @config
* @var null|array[]
*/
private static $theme_options;

/**
* Get the list of themes for the given sub site that can be given to SSViewer::set_themes
*
* @param Subsite $site
* @return array
*/
public function getThemeList(Subsite $site)
{
$themes = array_values(SSViewer::get_themes());
$siteTheme = $site->Theme;

if (!$siteTheme) {
return $themes;
}

$customOptions = $this->config()->get('theme_options');
if ($customOptions && isset($customOptions[$siteTheme])) {
return $customOptions[$siteTheme];
}

// Ensure themes don't cascade "up" the list
$index = array_search($siteTheme, $themes);

if ($index > 0) {
// 4.0 didn't have support for themes in the public webroot
$constant = SSViewer::class . '::PUBLIC_THEME';
$publicConstantDefined = defined($constant);

// Check if the default is public themes
$publicDefault = $publicConstantDefined && $themes[0] === SSViewer::PUBLIC_THEME;

// Take only those that appear after theme chosen (non-inclusive)
$themes = array_slice($themes, $index + 1);

// Add back in public
if ($publicDefault) {
array_unshift($themes, SSViewer::PUBLIC_THEME);
}
}

// Add our theme
array_unshift($themes, $siteTheme);

return $themes;
}

/**
* Get a list of custom cascading theme definitions if available
*
* @return null|array
*/
public function getCustomThemeOptions()
{
$config = $this->config()->get('theme_options');

if (!$config) {
return null;
}

return array_keys($config);
}
}
143 changes: 143 additions & 0 deletions tests/php/Service/ThemeResolverTest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
<?php

namespace SilverStripe\Subsites\Tests\Service;

use SilverStripe\Core\Config\Config;
use SilverStripe\Dev\SapphireTest;
use SilverStripe\Subsites\Model\Subsite;
use SilverStripe\Subsites\Service\ThemeResolver;
use SilverStripe\View\SSViewer;

class ThemeResolverTest extends SapphireTest
{
protected $themeList = [
'$public',
'custom',
'main',
'backup',
SSViewer::DEFAULT_THEME,
];

protected function setUp()
{
parent::setUp();

// Setup known theme config
Config::modify()->set(SSViewer::class, 'themes', $this->themeList);
}

public function testSubsiteWithoutThemeReturnsDefaultThemeList()
{
$subsite = new Subsite();
$resolver = new ThemeResolver();

$this->assertSame($this->themeList, $resolver->getThemeList($subsite));
}

public function testSubsiteWithCustomThemePrependsToList()
{
$subsite = new Subsite();
$subsite->Theme = 'subsite';

$resolver = new ThemeResolver();

$expected = array_merge(['subsite'], $this->themeList);

$this->assertSame($expected, $resolver->getThemeList($subsite));
}

public function testSubsiteWithCustomThemeDoesNotCascadeUpTheList()
{
$subsite = new Subsite();
$subsite->Theme = 'main';

$resolver = new ThemeResolver();

$expected = [
'main', // 'main' is moved to the top
'$public', // $public is preserved
// Anything above 'main' is removed
'backup',
SSViewer::DEFAULT_THEME,
];

$this->assertSame($expected, $resolver->getThemeList($subsite));
}

/**
* @dataProvider customThemeDefinitionsAreRespectedProvider
*/
public function testCustomThemeDefinitionsAreRespected($themeOptions, $siteTheme, $expected)
{
Config::modify()->set(ThemeResolver::class, 'theme_options', $themeOptions);

$subsite = new Subsite();
$subsite->Theme = $siteTheme;

$resolver = new ThemeResolver();

$this->assertSame($expected, $resolver->getThemeList($subsite));
}

public function customThemeDefinitionsAreRespectedProvider()
{
return [
// Simple
[
['test' => $expected = [
'subsite',
'backup',
'$public',
SSViewer::DEFAULT_THEME,
]],
'test',
$expected
],
// Many options
[
[
'aye' => [
'aye',
'thing',
SSViewer::DEFAULT_THEME,
],
'bee' => $expected = [
'subsite',
'backup',
'$public',
SSViewer::DEFAULT_THEME,
],
'sea' => [
'mer',
'ocean',
SSViewer::DEFAULT_THEME,
],
],
'bee',
$expected
],
// Conflicting with root definitions
[
['main' => $expected = [
'subsite',
'backup',
'$public',
SSViewer::DEFAULT_THEME,
]],
'main',
$expected
],
// Declaring a theme specifically should still work
[
['test' => [
'subsite',
'backup',
'$public',
SSViewer::DEFAULT_THEME,
]],
'other',
array_merge(['other'], $this->themeList)
],
];
}
}
Loading

0 comments on commit b32499e

Please sign in to comment.