Côté boutique, un module à installer et un jeton à créer. Côté cube, un QR code à scanner. Comptez un quart d'heure, déploiement du module compris.
bin/magento, joignable depuis le Wi-Fi du cube (HTTPS conseillé).
Le module ClickAndMortar_Cube est publié sur Packagist : il s'installe comme n'importe quel module,
depuis la racine de la boutique :
composer require clickandmortar/magento2-module-cube:^1.0
bin/magento module:enable ClickAndMortar_Cube
bin/magento setup:upgrade
# en mode production :
bin/magento setup:di:compile && bin/magento setup:static-content:deploy -f
Le module ne modifie aucune table et ne touche ni au front, ni au paiement : il ajoute deux routes REST en lecture et une page de configuration. Détails et compatibilité : documentation du module ↗.
Le cube s'identifie avec un jeton d'intégration qui n'a qu'un seul droit : lire les statistiques du cube. Une commande le crée, l'active et l'affiche :
# crée l'intégration « Cube Magento » et affiche le jeton bin/magento cm-cube:integration:create # plus tard, pour en générer un nouveau (l'ancien cesse de fonctionner) bin/magento cm-cube:integration:create --replace
Il faut aussi autoriser Magento à accepter ce jeton seul, en en-tête Authorization: Bearer
(option désactivée par défaut depuis Magento 2.4.4) :
bin/magento config:set oauth/consumer/enable_integration_as_bearer 1
Ou dans le back-office : Stores › Configuration › Services › OAuth › Consumer Settings › « Allow OAuth Access Tokens to be used as standalone Bearer tokens » = Yes.
Stores › Configuration › Click&Mortar › Cube. Tout fonctionne avec les valeurs par défaut ; les plus utiles :
| Daily revenue goal | Objectif de chiffre d'affaires du jour, dans la devise de base. À 0, l'écran « Objectif » disparaît. |
|---|---|
| Enabled screens | Écrans proposés au cube : Aujourd'hui, Vs hier, 7 jours, Dernière commande, Objectif. |
| Timezone | Fuseau qui définit « aujourd'hui » (Europe/Paris par défaut). |
| Store views counted | Vues de magasin prises en compte (vide = toutes). |
| Excluded order states | Statuts ignorés (commandes annulées par défaut). |
| Enable cube API | Coupe l'API d'un clic : le cube affiche alors « API du cube désactivée ». |
http://192.168.4.1.
https://…, sans /admin ni /rest) et le jeton de l'étape 3.
Changer de Wi-Fi ou de boutique plus tard : Menu › Connexion › Reconfigurer. Sur la page de réglage, un champ secret laissé vide garde la valeur enregistrée.
| Tourner la molette | Écran suivant ou précédent. |
|---|---|
| Appuyer sur la molette | Rejoue l'animation de la dernière commande. |
| Touche | Ouvre le menu. Dans le menu, revient en arrière. |
Chiffre d'affaires depuis minuit, écart avec hier à la même heure, commandes, panier moyen, barres des 7 derniers jours.
CA, commandes et panier moyen face à hier à la même heure, avec la variation en %.
Total et moyenne par jour ; la ligne pointillée marque le record de chiffre d'affaires.
Montant, numéro, ville, nombre d'articles et depuis combien de temps.
Avancement vers l'objectif du jour réglé dans Magento, et ce qu'il reste à faire.
Avant les premiers chiffres, le cube affiche son état au centre de l'écran. Ensuite, un problème de connexion se signale par un point rouge sur l'icône Wi-Fi en haut à droite ; le détail est dans Menu › Connexion. Le cube réessaie tout seul, il n'y a jamais besoin de le redémarrer.
| Configuration requise | Pas de Wi-Fi, d'URL ou de jeton enregistrés : voir l'étape 5. |
|---|---|
| Wi-Fi injoignable | Réseau hors de portée, en 5 GHz seulement, ou mauvais mot de passe. Nouvel essai toutes les 10 s. |
| Boutique injoignable | URL erronée, DNS, certificat, ou boutique en panne. Vérifiez l'URL depuis un navigateur sur le même réseau. |
| Jeton refusé (401) | Jeton mal copié ou régénéré depuis, ou option « Bearer » non activée (étape 3). |
| API du cube désactivée (403) | « Enable cube API » est à No dans la configuration du module. |
| Erreur HTTP … | Code renvoyé par le serveur (500, 502…) : regardez les journaux de la boutique. |
| Réponse illisible | La boutique a répondu autre chose que du JSON (page de maintenance, pare-feu, redirection). |
| Mode « API native (repli) » | Le module n'est pas installé (404) : le cube se contente du chiffre du jour, sans comparaison ni historique. Installez le module. |
C'est presque toujours l'alimentation : un port USB d'ordinateur ou un petit chargeur ne suffit pas quand le son joue. Utilisez un chargeur d'au moins 1 A et un câble USB-C en bon état.
Le cube compte en devise de base, sur le fuseau réglé dans le module, hors statuts exclus (annulées par défaut), sur les vues de magasin choisies. Une commande d'un jour passé annulée après coup n'est prise en compte que le lendemain (l'historique est recalculé une fois par jour).
Le module se met à jour comme les autres : composer update clickandmortar/magento2-module-cube,
puis bin/magento setup:upgrade.
Le firmware se met à jour par le câble USB-C ou sans fil, depuis le même réseau : le cube s'annonce sous le nom
cube-magento.local et affiche une barre de progression. Ne le débranchez pas pendant l'opération.
La version installée est indiquée dans Menu › Connexion et en bas de la page de réglage.