symbiote / silverstripe-multisites
Allows for multiple websites to be managed through a single site tree.
Installs: 13 585
Dependents: 4
Suggesters: 2
Security: 0
Stars: 13
Watchers: 5
Forks: 30
Open Issues: 2
Type:silverstripe-vendormodule
Requires
- silverstripe/admin: ^1.3
- silverstripe/cms: ~4.0
- symbiote/silverstripe-multivaluefield: ~5.0
Requires (Dev)
- phpunit/phpunit: ^5.7
Replaces
- dev-master / 5.2.x-dev
- 5.2.6
- 5.2.5
- 5.2.4
- 5.2.3
- 5.2.2
- 5.2.1
- 5.2.0
- 5.1.2
- 5.1.1
- 5.1.0
- 5.0.3
- 5.0.2
- 5.0.1
- 5.0.0
- 4.3.0
- 4.2.0
- 4.1.1
- 4.1.0
- 4.0.x-dev
- 4.0.4
- 4.0.3
- 4.0.2
- 4.0.1
- 4.0.0
- 3.0.1
- 3.0.0
- 2.0.x-dev
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.2.x-dev
- 1.2.5
- 1.2.4
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.x-dev
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.x-dev
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- dev-feature-cascading-themes
- dev-fix-composer
- dev-feature-ss4-upgrade
- dev-aware
- dev-aucwp
This package is auto-updated.
Last update: 2024-09-28 07:11:27 UTC
README
Overview
Allows for multiple websites to be managed through a single site tree.
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
Compatible with SilverStripe 4.0.x
- 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
- 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 - egmysitedomain.com
orlocalhost/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.
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.
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.
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.
$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'
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).
/** * 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