Premiers pas - v1
L’application e-comBox est une application Web qui permet de lancer et gérer un certain nombre de sites basés sur les applications suivantes :
- Prestashop :
- une instance vierge,
- une instance personnalisée (site Art Concept Stories) ;
- WordPress avec WooCommerce :
- une instance vierge,
- une instance personnalisée (site Art Concept Stories) ;
- WordPress sans WooCommerce, mais avec le add-in H5P ;
- Mautic ;
- Suite CRM ;
- Odoo dans sa version 12 ;
- Kanboard (gestion de projet) ;
- HumHub (réseau social).
<translate> Note:</translate> L'installation de l'e-comBox est documentée pour Windows 10 Pro, Linux et MacOS.
Sommaire
L'interface de l'e-comBox
L'interface de l'e-comBox est composée d'un menu à gauche, un bandeau avec un raccourci vers la page d'aide et une zone principale qui s'adapte en fonction de l'élément de menu sélectionné :
Le tableau de bord permet d'avoir une vue d'ensemble sur :
- le nombre de sites créés ainsi que leur état (démarré ou stoppé) ;
- les ressources utilisées (mémoire, espace de stockage et CPU).
Gestion des sites
Le menu gauche liste l'ensemble des types de sites disponibles : Prestashop, WooCommerce, Blog, Mautic, Suite CRM, Odoo, Kanboard et HumHub. Un clic sur chacun affiche la page de gestion correspondante.
Créer un site
Pour créer un site, il suffit de saisir un complément de nom pour le site puis cliquer sur le bouton créer :
Le nom du site sera de la forme : type de site-complément de nom. Par exemple ici le nom sera blog-01.
Au clic du bouton créer, un message (sous forme de pop-up) indique que la création est lancée et qu'elle peut durer quelques minutes.
Une fois la création terminée, le site est automatiquement démarré et la "carte" correspondante apparaît dans la zone Gérer les sites :
Pour les sites Prestashop et WooCommerce, il est possible de créer 2 types de sites :
- vierge : site par défaut proposé par Prestashop et WooCommerce ;
- Art Concepts Stories : e-boutique opérationnelle (300 références, 150 clients, 130 commandes).
Il est donc nécessaire de cocher un type avant de cliquer sur le bouton créer :
Démarrer/arrêter un site
Un site démarré est affiché de la façon suivante :
Un clic sur ce bouton permet alors d'arrêter le site. Un site stoppé est affiché de la façon suivante :
Un clic sur ce bouton permet de le démarrer.
 Warning: | Le démarrage d'un site peut prendre quelques minutes car une mise à jour est réalisée automatiquement afin de prendre en compte la modification éventuelle de l'environnement d'e-comBox (en cas de changement de réseau par exemple). |
Accéder à un site
Pour accéder à un site, ce dernier doit être démarré.
Un lien cliquable Accéder au site (redirigeant vers l'URL du site dans un nouvel onglet du navigateur) est affiché pour chaque site démarré.
Les URL peuvent être visualisées :
- Au survol du lien Accéder au site :
- Au clic sur le bouton Afficher les URL :
<translate> Note:</translate> Le bouton Afficher les URL n'apparaît qu'à partir du moment où au moins un site est démarré.
Exporter la liste des URL au format PDF
Pour chaque type de site (Prestashop, WooCommerce, Blog, etc.) il est possible d'afficher en un clic la liste des URL pour l'ensemble des sites démarrés. Pour cela, il suffit de cliquer sur le bouton Afficher les URL :
Le bouton Exporter permet de générer et d'ouvrir automatiquement un fichier PDF contenant cette liste :
<translate> Note:</translate> Les URL sur ce fichier PDF sont cliquables.
Supprimer un site
Pour supprimer un site, il faut cliquer sur le bouton en haut à droite de la "carte" correspondante :
| Warning: | La suppression est irréversible et les données associées au site seront supprimées ! |
Par sécurité, une confirmation est demandée : en cliquant sur Valider, après un petit temps de chargement (l'animation Loading est affichée), le site est supprimé.
Ce pop-up vous en averti en s'affichant en haut à droite de la page.
<translate> Note:</translate> La carte associée disparaît de l'e-comBox.
Gestion avancée
La gestion avancée permet :
- d'accéder aux sources des sites Prestashop et Odoo ;
- d'accéder aux bases de données des sites Prestashop, WooCommerce et Blog ;
- d'administrer directement les conteneurs : {{color|red|à utiliser avec prudence}.
Accès SFTP
L'accès SFTP permet d'accéder aux sources des sites Prestashop et Odoo.
Lorsque le SFTP est activé pour un site l'affichage est du type :
<translate> Note:</translate> Une fois le SFTP activé, il est possible d'accéder aux sources à partir d'un outil comme FileZilla afin de faire d'éventuelles modifications (les identifiants de connexion figurent dans le fichier e-comBox_identifiants_acces_applications.pdf (voir ici).
Ce bouton permet de désactiver l'accès SFTP. Lorsque le SFTP est désactivé pour un site l'affichage est du type :
Ce bouton permer de l'activer.
Accès phpMyAdmin
L'activation de l'interface web phpMyAdmin pour un site Prestashop, WooCommerce ou Blog permet l'administration de la base de données associée via le navigateur.
Lorsque phpMyAdmin est activé pour un site l'affichage est du type :
<translate> Note:</translate> Une fois phpMyadmin activé, il sera possible d'accéder via le navigateur à la base de données du site.
Par exemple ici, pour le site prestashop-art-cn phpMyAdmin sera accessible à l'adresse <nowiki>http://10.22.170.101:8700<nowiki>.
Ce bouton permet de le désactiver, l'affichage est alors du type :
Un clic sur ce bouton permettra de l'activer.
Accès admin
Il s'agit d'un lien vers l'interface d'administration de Portainer (les identifiants de connexion figurent dans le fichier e-comBox_identifiants_acces_applications.pdf - Voir ici).
| Warning: | Cette interface doit être utilisée avec une grande prudence car il est possible ici de supprimer les containers et les données d'un site sans aucune demande de confirmation ! L'application e-comBox peut également être supprimée ! |
| Warning: | Sur Linux, si le serveur est accessible à distance, il est nécessaire de modifier le mot de passe admin de Portainer puis de synchroniser ce mot de passe avec l'application e-comBox (voir ici. |
Caractéristiques de chaque type d'application
Les identifiants d'accès
Les identifiants d'accès (ainsi que l'accès administrateur à Portainer) sont dans un fichier qui est installé par le setup et les scripts dans C:\Programmes\e-combox pour Windows, dans le dossier /opt/e-comBox pour Linux et dans le dossier /Applications/e-comBox, là où sont installées toutes les applications sous Mac OS.
| Warning: | Il n'est pas possible sur Windows et sur MacOS de modifier le mot de passe de Portainer sous peine de voir la e-comBox dysfonctionner. C'est par contre fortement conseillé sur un serveur Linux qui sera accessible de l'extérieur (voir le mode opératoire ici, le mot de passe doit être changé classiquement via l'interface graphique mais il est nécessaire ensuite d'exécuter un script de manière à ce que la e-comBox prenne en compte ce changement). |
Généralités sur les différentes applications
| Application | Version | Commentaires |
|---|---|---|
| Prestashop | 1.7.5.1 | versions : une e-boutique opérationnelle Art Concept Stories (300 références, 150 clients, 130 commandes) et une boutique avec la version démo proposée par Prestashop. |
| wooCommerce | 5.2 | 2 versions : une e-boutique opérationnelle Art Concept Stories (300 références, 150 clients) et une boutique "squelette" totalement vierge. |
| Blog | 5.2 | Le module H5p est installé et activé. |
| Mautic | 2.15.1 | Mautic nécessite une configuration : voir ici le mode opératoire avec les éléments nécessaires. |
| Suite CRM | 7.10.11 | Voir ici pour basculer l'interface graphique en français. |
| Odoo | 12 | Voir ici pour basculer l'interface graphique en français. |
| Kanboard | 1.2.10 | Voir ici pour basculer l'interface graphique en français. |
| Humhub | 1.3.12 | Voir ici pour basculer l'interface graphique en français. |
Configuration de Mautic
Mautic doit être configuré avec les éléments suivants :
<translate> Note:</translate> Database Password = mdpMautic
Pour Basculer Mautic en français via l'interface graphique :
- roue dentée/configuration/system setting ;
- puis Apply ou Save & Close ;
- se reconnecter.
<translate> Note:</translate> Il est possible de changer d'autres paramètres comme Default timezone.
Warning: Les paramètres de Mautic AdresseIP:port ne change jamais dans Configuration/paramètres généraux (même en cas de changement d'adresse IP) mais cela n'entraîne pas d'effets de bords et l'application continue de fonctionner normalement.
Basculer Suite CRM en français
Sur l'interface graphique :
- Téléchargement du pack Langue FR : https://crowdin.com/project/suitecrmtranslations/fr
- Aller dans la rubrique Admin/Module Loader, importer le fichier zip précédemment téléchargé.
- Faire upload, et l'activer.
- Pour rafraîchir la configuration : Admin/Repair/Quick Repair and rebuild.
Basculer Suite Kanboard en français
Sur l'interface graphique :
- Application settings
- Sélectionner langue
- Modifier également le fuseau horaire et choisir le format des dates.
Basculer Humhub en français
Sur l'interface graphique :
- Administration / settings
- Sélectionner langue
- Modifier également le fuseau horaire (ne pas faire attention au message d'erreur "Oooops... It looks like you may have taken the wrong turn. An internal server error occurred"
Aide
En cas de besoin les liens suivants sont mis à disposition dans la page Aide :
- documentation en ligne ;
- trousse de premiers secours ;
- FAQ ;
- plateforme de support pour déclarer un incident avec un mode opératoire.
