symbiote/silverstripe-multisites

Allows for multiple websites to be managed through a single site tree.

Wednesday, May 16, 2018
by symbiote
Repository
3 Watchers
12 Stars
3,705 Installations

PHP
4 Dependents
0 Suggesters
22 Forks
2 Open issues
44 Versions
21 % Grown

The README.md

SilverStripe Multisites

, _(*1)

Overview

Allows for multiple websites to be managed through a single site tree., _(*2)

This is an alternative module to the Subsites module; it avoids any session tracking of the 'current' website, and doesn't perform any query modification at runtime to change the 'site' context of queries you execute, _(*3)

Compatible with SilverStripe 4.0.x, _(*4)

Please see 4.0.x for 3.5 compatibility
Please see the 1.2.x version for 3.1 compatibility

Upgrading to SS4

The following important changes have happened, _(*5)

Themes must now be explicitly configured in your project config. Set Site.available_themes in yml config. This must be a map of themename: Label
Site specific Assets folders are not currently supported due to the fundamental change to asset management. This will be reviewed over time

Requirements

SilverStripe 4.*
MultivalueField

Installation

Add the module and the multivaluefield module
Run dev/build

Setting up sites (and additional sites)

In the CMS go to the Pages section and click on the Website
Enter in the full path to the site in the 'Host' field, without the http:// lead - eg mysitedomain.com or localhost/sub/folder for a development site
Hit save
To add a new site, click the Pages section; you should have an 'Add site' button
Enter details about the new site, the Host field being the most important

Configuration

Site:
  available_themes:
    name: Label

To support cascading themes, provide a comma-separated list of themes for 'name' in configuration., _(*6)

Assets management

NOTE: This is currently NOT working in SS4 due to the change to the asset management layer. Once clearer, this will be re-enabled., _(*7)

You can optionally manage each site's assets in it's own subfolder of the root assets/ directory. Add the following extensions in your mysite/config.yml file and run ?flush=1. When editing a Site in the CMS, you now have the option to select a subfolder of assets/ to contain all assets for that site. This folder will be automatically created upon a) saving the site or b) visiting a page in the cms that has an upload field., _(*8)

FileField:
  extensions:
    - MultisitesFileFieldExtension

HtmlEditorField_Toolbar:
  extensions:
    - MultisitesHtmlEditorField_ToolbarExtension

Files uploaded through the HTMLEditor will now be uploaded into assets/yoursite/Uploads. If you have custom upload fields in the cms however, you will need to add the following configuration to them explicitly., _(*9)

$fields->fieldByName('Root.Main.Image')->setFolderName('images/page-images')->useMultisitesFolder();

The above call to useMultisitesFolder() will change the folder name from ' images/page-images' to 'currentsitesubfolder/images/page-images', _(*10)

Known issues

When linking to a page that belongs to a different site, SiteTree::Link() will return a bad link as it prepends the base URL. Currently the best way to work around this is to implement the following in your Page.php (model class)., _(*11)

/**
 * Overrides SiteTree->Link. Adds a check for cases where we are linking to a
   page on a
 * different site in this multisites instance.
 * @return String
 **/
public function Link($action = null) {
    if($this->SiteID && $this->SiteID == Multisites::inst()->getCurrentSiteId()) {
        return parent::Link($action);
    } else {
        return $this->RelativeLink($action);
    }
}

See GitHub

The Versions

16/05 2018

dev-master

9999999-dev http://github.com/symbiote/silverstripe-multisites

Allows for multiple websites to be managed through a single site tree.

silverstripe-vendormodule silverstripe-multisites

Allows for multiple websites to be managed through a single site tree.

symbiote/silverstripe-multisites

The README.md

SilverStripe Multisites

Overview

Upgrading to SS4

Requirements

Installation

Setting up sites (and additional sites)

Configuration

Assets management

Known issues

The Versions

dev-master

The Requires

The Development Requires

by Marcus Nyeholt

5.0.3

The Requires

The Development Requires

by Marcus Nyeholt

5.0.2

The Requires

The Development Requires

by Marcus Nyeholt

5.0.1

The Requires

The Development Requires

by Marcus Nyeholt

4.0.x-dev

The Requires

by Marcus Nyeholt

4.3.0

The Requires

by Marcus Nyeholt

5.0.0

The Requires

The Development Requires

by Marcus Nyeholt

dev-feature-ss4-upgrade

The Requires

The Development Requires

by Marcus Nyeholt

4.2.0

The Requires

by Marcus Nyeholt

4.1.1

The Requires

by Marcus Nyeholt

4.1.0

The Requires

by Marcus Nyeholt

4.0.4

The Requires

by Marcus Nyeholt

4.0.3

The Requires

by Marcus Nyeholt

4.0.2

The Requires

by Marcus Nyeholt

4.0.1

The Requires

by Marcus Nyeholt

4.0.0

The Requires

by Marcus Nyeholt

3.0.1

The Requires

by Marcus Nyeholt

3.0.0

The Requires

by Marcus Nyeholt

2.0.x-dev

The Requires

by Marcus Nyeholt

2.0.4

The Requires

by Marcus Nyeholt