1,918
edits
No edit summary Tag: 2017 source edit |
No edit summary Tag: 2017 source edit |
||
| Line 20: | Line 20: | ||
|Auteur||Philippe Grand — Atoo-Net | |Auteur||Philippe Grand — Atoo-Net | ||
|- | |- | ||
|Version||24.0. | |Version||24.0.1 | ||
|- | |- | ||
|Licence||GNU GPL v3+ | |Licence||GNU GPL v3+ | ||
| Line 77: | Line 77: | ||
Le module ne déclare aucun droit propre : les pages d'administration sont réservées aux administrateurs Dolibarr, et les pages de la boutique utilisent leur propre session client. | Le module ne déclare aucun droit propre : les pages d'administration sont réservées aux administrateurs Dolibarr, et les pages de la boutique utilisent leur propre session client. | ||
===Domaine et hôte virtuel=== | |||
La boutique doit être servie par '''son propre domaine''' (par exemple <code>https://shop.example.com</code>), au moyen d'un hôte virtuel du serveur web (Apache, Nginx…). L'adresse d'aperçu de Dolibarr, <code>…/public/website/index.php?website=…</code>, ne sert qu'aux tests : sans domaine, la boutique ne fonctionne pas entièrement. | |||
*Le panier et les téléchargements appellent <code>/_service_page_ajax.php</code> et <code>/_service_download.php</code> à la racine du domaine. Sans hôte virtuel, ces appels aboutissent à une erreur 404 et le panier ne se met plus à jour. | |||
*En aperçu, Dolibarr imprime un commentaire HTML avant la page. Si <code>output_buffering</code> est désactivé dans PHP, la session de l'acheteur ne démarre pas (« session expirée » à la connexion). | |||
*Le <code>sitemap.xml</code> et le <code>robots.txt</code> sont construits à partir de l'hôte virtuel déclaré sur le site : s'il n'est pas renseigné, ils ne sont pas générés, et les liens de désinscription des e-mailings pointent vers Dolibarr au lieu de la boutique. | |||
Mise en place : | |||
#Créez un hôte virtuel dont la racine (<code>DocumentRoot</code>) est le répertoire du site : <code><documents>/website/<ref></code> (<code><documents>/<entité>/website/<ref></code> pour une entité autre que la première). <code><documents></code> est le répertoire des documents de Dolibarr, et <code><ref></code> la référence du site créé à l'activation (<code>ultimatemarketplace</code> par défaut, voir le paramètre « Site Web à utiliser pour la place de marché »). | |||
#PHP doit y être actif. L'utilisateur du serveur web doit pouvoir lire les fichiers de Dolibarr (<code>htdocs</code>) et écrire dans <code><documents>/website</code> et <code><documents>/medias</code> ; si <code>open_basedir</code> est utilisé, il doit inclure ces répertoires. Autorisez les liens symboliques sur le répertoire du site : son dossier <code>medias</code> est un lien vers <code><documents>/medias</code>. | |||
#Activez HTTPS sur ce domaine : les passerelles de paiement l'exigent. | |||
#Dans Dolibarr, menu '''Sites web''', ouvrez les '''Propriétés du site web''' et saisissez le domaine complet, <code>https://</code> compris, dans le champ '''Hôte virtuel ou nom de domaine'''. | |||
Exemple pour Apache, à adapter (chemins d'un paquet Debian ou Ubuntu) : | |||
<pre> | |||
<VirtualHost *:443> | |||
ServerName shop.example.com | |||
DocumentRoot "/var/lib/dolibarr/documents/website/ultimatemarketplace" | |||
<Directory "/var/lib/dolibarr/documents/website/ultimatemarketplace"> | |||
AllowOverride FileInfo Options | |||
Options -Indexes -MultiViews +FollowSymLinks -ExecCGI | |||
Require all granted | |||
</Directory> | |||
<Directory "/var/lib/dolibarr/documents/medias"> | |||
Options -Indexes -MultiViews -FollowSymLinks -ExecCGI | |||
Require all granted | |||
</Directory> | |||
SSLEngine on | |||
SSLCertificateFile /etc/letsencrypt/live/shop.example.com/fullchain.pem | |||
SSLCertificateKeyFile /etc/letsencrypt/live/shop.example.com/privkey.pem | |||
</VirtualHost> | |||
</pre> | |||
==Configuration== | ==Configuration== | ||
| Line 308: | Line 343: | ||
<code>robots.txt</code>, <code>sitemap.xml</code> et <code>llms.txt</code> sont régénérés automatiquement à l'activation, à l'ouverture de l'onglet Paramètres et après une réinitialisation du modèle. Une fois les URLs simplifiées activées, les anciennes URLs restent valides pendant la transition. | <code>robots.txt</code>, <code>sitemap.xml</code> et <code>llms.txt</code> sont régénérés automatiquement à l'activation, à l'ouverture de l'onglet Paramètres et après une réinitialisation du modèle. Une fois les URLs simplifiées activées, les anciennes URLs restent valides pendant la transition. | ||
==Nouveautés de la version 24.0.1== | |||
*'''Documentation''' : le guide utilisateur et cette page expliquent comment servir la boutique sur son propre domaine, par un hôte virtuel dont la racine est le répertoire du site (voir [[#Domaine et hôte virtuel|Domaine et hôte virtuel]]). Le code du module est inchangé. | |||
==Nouveautés de la version 24.0.0== | ==Nouveautés de la version 24.0.0== | ||
| Line 330: | Line 369: | ||
==FAQ== | ==FAQ== | ||