Documentation du plugin Multisite et mappage de domaine

Fonctionnalités

• Personnalisez les URLs avec le Domain Mapping (en définissant un sous-domaine (ou domaine) par pays).
• Permet d'utiliser l'application principale avec plusieurs sous-domaines ou domaines.
• Optimisez le SEO de votre site par sous-domaine (ou par domaine).
• Partage de session entre les sous-domaines du domaine de l'URL principale (APP_URL du fichier /.env).

REMARQUE : Ce plugin ne prend pas en charge les sous-domaines de sous-domaines. Le plugin ne peut pas non plus partager les sessions entre deux domaines distincts (comme foo.com et bar.com).

Compatibilité

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

Installation

Pour installer ce plugin :

• Décompressez le package du plugin
• Renommez le répertoire décompressé en « domainmapping »
• Déplacez le répertoire « domainmapping » dans le répertoire /extras/plugins/ du script comme ceci : /extras/plugins/domainmapping/
• Allez dans votre Panneau d'administration → Add-ons (et cliquez sur « Installer ») pour l'installer. Vous aurez besoin de votre code d'achat que vous pouvez trouver en suivant ce lien.

Mise à jour

• Remplacez tous les fichiers du plugin dans le répertoire /extras/plugins/domainmapping/ de l'application.
• Et réinstallez le plugin (REMARQUE : Vous perdrez la configuration actuelle du plugin).

Utilisation

• Pour gérer le mapping des domaines de votre site, allez dans votre Panneau d'administration → Domaines. REMARQUE : Vous ne pouvez ajouter qu'un seul sous-domaine (ou domaine) par pays. Et avant d'ajouter un domaine (ou sous-domaine), assurez-vous d'avoir créé un enregistrement A (IPv4) ou AAAA (IPv6) pour le nom de domaine, en utilisant le panneau client (Zones DNS) de votre fournisseur de domaine.
• Assurez-vous d'avoir ajouté le domaine (ou sous-domaine) depuis le panneau de contrôle de l'hébergement, et d'avoir créé un alias de domaine sur le panneau de contrôle de l'hébergement (ou cPanel) qui pointe vers le répertoire racine de votre site (public_html par exemple).
• Allez dans votre Panneau d'administration → Paramètres → Domain Mapping pour activer/désactiver le partage de session entre les sous-domaines.

INFO : Un enregistrement A, ou enregistrement AAAA, est utilisé pour pointer un nom d'hôte vers une adresse IP. Ce type d'enregistrement peut être utilisé pour pointer votre nom de domaine vers votre hébergeur ou pour créer des sous-domaines qui pointent directement vers une adresse IP.

• Si vous avez activé le partage de session entre les sous-domaines, le panneau d'administration sera accessible via l'URL globale, automatiquement définie dans le fichier /.env suivie de /admin (APP_URL/admin).
• Si vous avez désactivé le partage de session, le panneau d'administration sera accessible pour chaque domaine ou sous-domaine (ex. : us.domain.com/admin, fr.domain.com/admin, ...).

• Ce plugin vous permet de définir la page de liste des pays comme page d'accueil. Pour ce faire, vous devez définir la variable DM_COUNTRIES_LIST_AS_HOMEPAGE= dans le fichier /.env à true. Si cette variable n'existe pas dans votre fichier /.env, vous devez l'ajouter. REMARQUE : Vous devez définir un domaine (ou sous-domaine) par pays (ex. : example.de, fr.example.com, ...) pour tous les pays afin que le domaine principal (celui disponible dans la variable APP_URL de votre fichier /.env, ex. : example.com) affiche la page de liste des pays comme page d'accueil.

Traduction

Pour traduire ce plugin dans votre langue :

• Allez dans le répertoire des langues du plugin dans /extras/plugins/domainmapping/lang/
• Dupliquez le dossier /extras/plugins/domainmapping/lang/en/ vers /extras/plugins/domainmapping/lang/<code>/ REMARQUE : N'oubliez pas de remplacer <code> par le code de votre langue (ex. : « de » pour la langue allemande).
• Ouvrez le fichier /extras/plugins/domainmapping/lang/<code>/messages.php et traduisez-le. REMARQUE : Pour traduire le fichier, vous devez modifier les valeurs et non les clés du tableau PHP.

Désinstallation

Pour désinstaller ce plugin :

• Allez dans votre Panneau d'administration → Add-ons (et cliquez sur « Désinstaller ») pour le désinstaller.

Suppression du plugin

Pour supprimer ce plugin :

• Désinstallez-le
• Allez dans le répertoire /extras/plugins/ de l'application et supprimez le répertoire domainmapping/ (avec son contenu).