Plesk

Cette page vous guidera dans l'installation de ClientXCMS Next Gen pour les versions autohébergées sur plesk. Les offres Cloud sont installées automatiquement sur les serveurs de CLIENTXCMS. L'installation est disponible ici.

Mise en place de l'abonnement et du domaine

1. Créez un nom de domaine correspondant à votre licence.
2. Si vous avez déjà un espace client, enregistrez le fichier .env dans la racine de votre site (pour une migration) et sauvegardez tous les fichiers de ClientXCMS ou de WHMCS.
   attention

   Ne supprimez ni ne modifiez la base de données de l'ancien espace client si vous souhaitez réimporter les données de vos clients, factures, services, configurations des produits, etc.

3. Si vous avez un accès Administrateur Plesk, dans le menu latéral, cliquez sur "Extensions" sous "Gestion des serveurs".
4. Recherchez et installez l'extension "Laravel Toolkit" si ce n'est pas déjà fait.
5. Générez un certificat SSL gratuitement via Let's Encrypt.
6. Dans le tableau de bord de votre domaine, cliquez sur "PHP" sous les outils de développement. Utilisez la version 8.3 de PHP pour une compatibilité optimale.

Installation de l'environnement Laravel

1. Revenez à la gestion de votre domaine. Sous le menu "Démarrer", sélectionnez "Laravel".
2. Cliquez sur "Installer l'application", choisissez "Installer depuis un dépot distant" mettez dans le champs l'URL : https://github.com/ClientXCMS/ClientXCMS et confirmez
3. Attendez la fin du déploiement de CLIENTXCMS.

Configuration de la base de données

1. Créez une base de données dans le tableau de bord de gestion du domaine, sous "Fichiers et bases de données" → "Bases de données".

   

2. Utilisez un mot de passe robuste pour des raisons de sécurité et notez bien les informations de connexion avant de confirmer.

3. Dans le gestionnaire de fichiers de Plesk, allez dans la racine du projet Laravel (par défaut "httpdocs").

4. Renommez le fichier .env.example en .env ou ouvrez le fichier.

5. Cliquez sur le fichier .env et modifiez les valeurs :

   • APP_ENV=production → APP_ENV=dev
   • APP_URL=http://localhost → APP_URL=https://votre.domaine.com (mettez bien le domaine de votre espace client)
   • DB_DATABASE=laravel → Nom de votre base de données
   • DB_USERNAME=root → Nom d'utilisateur de la base de données
   • DB_PASSWORD="" → Mot de passe de l'utilisateur de la base de données (entre "guillemets" afin d'éviter les erreurs de syntaxe)

Commandes d'initialisation de l'environnement

1. Revenez dans l'onglet "Démarrer" puis cliquez sur "Laravel".
2. Cliquez sur la section "Artisan".
3. Exécutez les commandes suivantes dans cet ordre :
   • key:generate
   • db:seed --force
   • migrate --force
   • storage:link
4. Cliquez sur la section "Node.js".
5. Sélectionnez la version de NodeJS la plus récente installée sur votre serveur Plesk (ex : NodeJS 21).
6. Exécutez les commandes suivantes dans cet ordre :
   • install
   • run build

Configuration de ClientXCMS

1. Rendez-vous sur l'adresse de votre espace client. Vous devriez voir une page d'installation similaire à celle-ci :

2. Remplacez "CLIENTXCMS" par votre nom commercial d'hébergeur.

3. Pour trouver l'ID client et le Secret client, allez sur l'espace client ClientXCMS : https://clientxcms.com/client/services/, dans la gestion de la licence NextGen concernée. Les identifiants "OAuth Client ID" et "OAuth Secret" sont nécessaires pour connecter la licence ClientXCMS à votre site. Cliquez ensuite sur le bouton "Se connecter" sur votre instance.

Configuration des taches cron

1. Dans le tableau de bord de gestion du domaine, cliquez sur "Tâches planifiées" sous "Outils et paramètres".
2. Cliquez sur "Ajouter une tâche planifiée".
3. Configurez les tâches cron suivantes