Hello, I am Wiego. Please start by reading the whole documentation! If you have any questions, find a bug or experience difficulties getting the plugin to work please use the Support Forum. Only leave a Review if you are happy with the plugin or are still unhappy with the plugin after reaching out to me in the Support Forum. Thank you!

Installation

To install from the Marketplace, click on the "Add to Project" button and then select the project you wish to add it to before updating the project in the backend of your website to pull in the plugin.

To install from the backend, go to Settings -> Updates & Plugins -> Install Plugins and then search for Briddle.Multisite.

Getting started

1. Install Briddle.Multisite
2. Create an alias on your server (cPanel/Plesk) for your existing October CMS website. This can be either a subdomain or a domain or you can use a wildcard.
3. Simply use the default automagic configuration (see below) or overwrite the site configuration by creating a configuration file config.php inside the folder /plugins/briddle/multisite/config.

Example configuration file (optional)

<?php
return [
    'sites' => [
        [
            'host' => 'demo.briddle.nl',
            'theme' => 'briddle-demo'
        ]
    ]
];

Automagic configuration

If the 'sites' array is empty or the configuration file does not exist (as is the default setup), the plugin tries to guess the configuration based on the current host URL.

For example, if the current host URL is "test.mysite.com", and a theme with the name "test-mysite-com" is found, this theme will be used for that host URL without the need to specify it in your plugin's config.php (or anywhere else).

If no theme is found, the normal active theme will be used.

Using the backend

NEW The backend is now restricted to either super users or users that belong to a group which code is identical to the domainname (e.g. test.mysite.com)

You can simply navigate to the October CMS backend from the (sub)domain you want to make changes on. The correct theme will also be selected in the CMS section. All websites share plugins (but you can use permissions to controll access to them) and databases but have their own theme (and thus static content).

For more advanced options (like using different databases for a single installation) please see the October docs about domain driven environments. You do not need to use this or any other plugin for that but it does require you to write some configuration files. This plugin is intended to allow a simple multisite setup with zero configuration or with a configuration at plugin level.

Support

Please use the Support Forum (on the left side of the page for any theme or plugin) or send me a message. I also offer design and development services. You can visit my website for more information. Do not use reviews to ask for support.

IMPORTANT NOTICE! All my activities on October CMS are suspended indefinitely after my second burn-out. I do not offer any support or updates