Multisite & Domain Mapping plugin Documentation

Features

• Customize URLs with Domain Mapping (by setting a subdomain (or domain) per country).
• Allow you to use the core app with multiple subdomains or domains.
• Optimize your website SEO per sub-domain (or per domain).
• Share session between subdomains of the domain of the main URL (APP_URL from the /.env file).

NOTE: This plugin doesn't support subdomains of subdomains. The plugin cannot also share session between to distinct domains (like foo.com and bar.com).

Compatibility

• v5.1.0 => LaraClassifier v15.0.0+ and JobClass v14.0.0+
• v5.0.2 => LaraClassifier v14.2.0 and JobClass v13.2.0
• v5.0.1 => LaraClassifier (v14.0.2 to v14.1.0) and JobClass (v13.0.2 to v13.1.0)
• v5.0.0 => LaraClassifier (v14.0.0 to v14.0.1) and JobClass (13.0.0 to 13.0.1)
• v4.3 => LaraClassifier v13.0.0 and JobClass v12.0.0
• v4.2 => LaraClassifier (v12.1.0 to v12.2.4) and JobClass (v11.1.0 to v11.2.4)
• v4.1 => LaraClassifier (v12.1.0 to v12.2.4) and JobClass (v11.1.0 to v11.2.4)
• v4.0 => LaraClassifier (v12.0.0 to v12.0.2) and JobClass (v11.0.0 to v11.0.2)
• v3.9 => LaraClassifier (v11.0.2 to v11.0.4) and JobClass (v10.0.2 to v10.0.4)
• v3.8 => LaraClassifier (v11.0.0 to v11.0.1) and JobClass (v10.0.0 to v10.0.1)
• v3.7 => LaraClassifier (v10.2.1 to v11.0.1) and JobClass (v9.2.1 to v10.0.1)
• v3.6 => LaraClassifier (v10.2.0 to v10.2.6) and JobClass (v9.2.0 to v9.2.6)
• v3.5 => LaraClassifier v10.1.4 and JobClass v9.1.5
• v3.4 => LaraClassifier (v10.1.2 to v10.1.3) and JobClass (v9.1.3 to v9.1.4)
• v3.3 => LaraClassifier (v10.1.0 to v10.1.1) and JobClass (v9.1.0 to v9.1.2)
• v3.2 => LaraClassifier (v10.0.1 to v10.0.2) and JobClass (v9.0.1 to v9.0.3)
• v3.1 => LaraClassifier v10.0.1 and JobClass v9.0.1
• v3.0 => LaraClassifier v10.0.0 and JobClass v9.0.0
• v2.9 => LaraClassifier v9.0.1 and JobClass v8.0.1
• v2.8 => LaraClassifier v9.0.0 and JobClass v8.0.0
• v2.7 => LaraClassifier (v8.0.0 to v8.0.6) and JobClass (v7.0.0 to v7.0.6)
• v2.6 => LaraClassifier (v7.3.6 to v7.3.8) and JobClass (v6.1.6 to v6.1.8)
• v2.5 => LaraClassifier (v7.3.2 to v7.3.5) and JobClass (v6.1.2 to v6.1.5)
• v2.4 => LaraClassifier (v7.3.0 to v7.3.2) and JobClass (v6.1.0 to v6.1.2)
• v2.3 => LaraClassifier (v7.2.3 to v7.2.4) and JobClass (v6.0.3 to v6.0.4)
• v2.2 => LaraClassifier (v7.2.1 to v7.2.2) and JobClass (v6.0.1 to v6.0.2)
• v2.1 => LaraClassifier v7.2.0 and JobClass v6.0.0
• v2.0 => LaraClassifier (v7.1.0 to v7.1.1) and JobClass (v5.9.0 to v5.9.1)
• v1.9 => LaraClassifier v7.0.4 and JobClass v5.8.4
• v1.8 => LaraClassifier (v6.9 to v7.0.3) and JobClass (v5.7 to v5.8.3)
• v1.7 => LaraClassifier v6.8 and JobClass v5.6
• v1.6 => LaraClassifier (v6.6 to v6.7) and JobClass (v5.4 to v5.5)
• v1.5 => LaraClassifier v6.5 and JobClass v5.3
• v1.4 => LaraClassifier (v6.2 to v6.4) and JobClass (v5.0 to v5.2)
• v1.3 => LaraClassifier (v5.9 to v6.1) and JobClass (v4.7 to v4.9)
• v1.2 => LaraClassifier (v5.7 to v5.8) and JobClass (v4.5 to v4.6)
• v1.1 => LaraClassifier (v5.2 to v5.6) and JobClass (v4.0 to v4.4)
• v1.0 => LaraClassifier v5.1 and JobClass v3.9

Installation

To install this plugin:

• Unzip the plugin package
• Rename the unziped directory to "domainmapping"
• Move the "domainmapping" directory to the script's /extras/plugins/ directory like this: /extras/plugins/domainmapping/
• Go to your Admin panel → Add-ons (and click on "Install") to install it. You will need your Purchase Code that you can find by following this link.

Upgrade

• Replace all the plugin's files in the core app's /extras/plugins/domainmapping/ directory.
• And reinstall the plugin (NOTE: You will lose the current plugin configuration).

Usage

• To manage your website domains mapping, go to your website Admin panel → Domains. NOTE: You can add only one subdomain (or domain) per country. And before adding a domain (or sub-domain), make sure you have created a A (IPv4) or AAAA (IPv6) Records for the Domain Name, using the Client Panel (DNS Zones) of your domain provider.
• Make sure you have added the domain (or subdomain) from the host control panel, and that you have created a domain aliases on the host control panel (or Cpanel) that points to your website root directory (publuc_html for example).
• Go to your website Admin panel → Settings → Domain Mapping to enable/disable session sharing between sub-domains.

INFO: An A Record, or AAAA Record, is used to point a hostname at an IP address. This record type can be used to point your domain name at your web host or for creating subdomains which point directly to an IP address.

• If you have enabled the session sharing between subdomains, the Admin panel will be accessible through the global URL, automatically set in the /.env file followed by /admin (APP_URL/admin).
• If you have disabled the session sharing, the Admin panel will be accessible for each domain or sub-domain (eg. us.domain.com/admin, fr.domain.com/admin, ...).

• This plugin allow you to set the countries list page as homepage. To do that you have to set the DM_COUNTRIES_LIST_AS_HOMEPAGE= variable in the /.env file to true. If this variable doesn't exist in your /.env file you have to add it. NOTE: You have to set a domain (or subdomain) per country (eg. example.de, fr.example.com, ...) for all countries to let the main domain (the one available in the APP_URL variable of your /.env file, eg. example.com) to show the countries list page as homepage.

Translation

To translate this plugin into your language:

• Go to the plugin languages directory in the core app's /extras/plugins/domainmapping/lang/
• Duplicate the folder /extras/plugins/domainmapping/lang/en/ to /extras/plugins/domainmapping/lang/<code>/ NOTE: Don't forget replace <code> by your language code (e.g. "de" for German language).
• Open the file /extras/plugins/domainmapping/lang/<code>/messages.php and translate it. NOTE: To translate the file, you must change the values and not the keys of PHP array.

Uninstallation

To uninstall this plugin

• Go to your website Admin panel → Add-ons (and click on "Uninstall") to uninstall it.

Removing the plugin

To remove this plugin:

• Uninstall it
• Go to the core app's /extras/plugins/ directory and remove the domainmapping/ directory (with its content).