Skip to main content

Préparer un site Dolibarr Website

🛠️ Chapitre 17 — Préparer un site Dolibarr Website

Avant de pouvoir éditer un site via InfraSStudio, ce site doit exister côté Dolibarr Website. Ce chapitre est destiné au développeur qui repart d'une feuille blanche : créer le site, le câbler proprement, et préparer le terrain pour le Studio.

🎬 Étape 1 — Créer le site dans Dolibarr Website

  1. Connectez-vous à Dolibarr en admin.
  2. Allez dans Accueil → Sites web.
  3. Cliquez sur « Nouveau site ».
  4. Renseignez :
    • Référence — slug court sans espace : monsite, keaticweb. C'est l'identifiant interne, utilisé partout (URLs des wrappers, dossiers data, …).
    • Description — libellé optionnel.
    • Virtualhost principal — URL publique : https://monsite.com.
    • Langue principale — locale ISO : fr_FR, en_US, etc.
    • Autres langues — CSV : en_US,de_DE,es_ES.
  5. Enregistrez.

💡 Convention référence — Préférez un slug court et stable. Cette ref apparaîtra dans les chemins fichiers, les URLs internes et les constantes de configuration. La changer plus tard demande un peu de chirurgie.

🌐 Étape 2 — Configurer le virtualhost Apache

Dolibarr Website ne configure pas Apache pour vous. Vous devez créer un VirtualHost qui pointe sur le docroot du site.

Layout filesystem standard

/var/www/monsite/                           # docroot Apache du site
├── index.php                                # wrapper page d'accueil
├── <alias>.php                              # autres wrappers générés
├── master.inc.php                           # bootstrap (inclut DOL_DOCUMENT_ROOT)
├── medias  -> symlink vers DOL_DATA_ROOT/<entity>/medias/
└── ...

DOL_DATA_ROOT/<entity>/website/monsite/      # dossier data du site
├── page1.tpl.php                            # templates des pages
├── page2.tpl.php
├── ...
└── htmlheader.html                          # head commun éventuel

Exemple de VirtualHost minimal

<VirtualHost *:443>
    ServerName monsite.com
    DocumentRoot /var/www/monsite

    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/monsite.com/fullchain.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/monsite.com/privkey.pem

    <Directory /var/www/monsite>
        Options FollowSymLinks
        AllowOverride None
        Require all granted
    </Directory>

    # PHP-FPM dédié recommandé
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.2-fpm.monsite.sock|fcgi://localhost"
    </FilesMatch>
</VirtualHost>

ℹ️ PHP-FPM dédié — Recommandé pour isoler les performances et les variables d'environnement par site. Le pool peut tourner sous un user spécifique (www-data-monsite) pour les permissions.

🔗 Étape 3 — Le symlink medias

Pour que les images uploadées soient servies directement par Apache (mode média « native »), il faut un symlink :

cd /var/www/monsite
ln -sfn /mnt/data/dolibarr/<entity>/medias medias
ls -la medias  # doit pointer sur le dossier data Dolibarr

💡 Si vous ne pouvez pas créer ce symlink — Basculez le site en mode média « module » dans la configuration InfraSStudio. Les images seront servies via document.php avec un coût de performance modéré.

🐛 Étape 4 — Le master.inc.php multicompany

Si vous tournez en multicompany Dolibarr, le master.inc.php du site doit définir DOLENTITY avant de bootstrapper :

<?php
// /var/www/monsite/master.inc.php
define('DOLENTITY', 2);   // l'entity du client
require_once '/var/www/dolibarr/htdocs/master.inc.php';

⚠️ Sans DOLENTITY — Sur une instance multicompany, le site retournera 503 ou affichera les données de la mauvaise entity. C'est l'erreur la plus fréquente lors de la mise en route.

📄 Étape 5 — Créer la page d'accueil

Toujours dans le module Website Dolibarr :

  1. Sélectionnez votre site.
  2. Cliquez sur « Nouvelle page ».
  3. Renseignez :
    • Page URL — home, index, ou similaire.
    • Title — Accueil.
    • Type container — page.
    • Lang — fr_FR.
    • Status — Brouillon (vous le passerez à Publié plus tard).
  4. Enregistrez.
  5. Dolibarr crée automatiquement /var/www/monsite/home.php et page<N>.tpl.php.

🔌 Étape 6 — Activer le site dans InfraSStudio

Procédure expliquée au Chapitre 7. Résumé :

  1. Outils → InfraSStudio → Configuration.
  2. Cochez votre site dans la liste.
  3. Choisissez le mode média (native recommandé).
  4. Enregistrez.

📋 Étape 7 — Annoter les premières pages avec des slots

C'est le sujet du Chapitre 18. Mais en deux mots : éditez le fichier page<N>.tpl.php pour ajouter des tokens {{slot:nom|...}} aux endroits que vous voulez rendre éditables.

🩺 Étape 8 — Vérifier avec la page Diagnostic

Avant de livrer le site au client, lancez le diagnostic (Outils → InfraSStudio → Diagnostic) :

  • ✅ Tout vert dans Environnement, Schéma SQL, Stockage, Intégration Dolibarr.
  • ✅ Le site managé apparaît dans la section Sites avec docroot résolu, mode média OK, dossier data inscriptible.

📋 Récapitulatif

✅ Votre site est prêt si :

  • Le site est créé dans Dolibarr Website (référence + virtualhost + langues).
  • Le VirtualHost Apache pointe sur le bon docroot.
  • Le symlink medias est en place (mode native) ou la constante INFRASSTUDIO_SITE_<id>_MEDIA_MODE=module est définie.
  • Le master.inc.php définit DOLENTITY en multicompany.
  • Au moins une page existe (l'accueil).
  • Le site est coché dans la configuration InfraSStudio.
  • La page Diagnostic est entièrement verte.

Au prochain chapitre, on entre dans le vif : annoter le HTML avec des slots.

Back to top