Agence digitale — depuis 2015 2026 / 11 / 19
Click & Mortar
L'agence Offre TMA L'atelier Blog Contact
●  CUBE MAGENTO — GUIDE D'UTILISATION · FIRMWARE 1.0

Mettre en service et utiliser le cube.

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.

01

Ce qu'il faut

  • BoutiqueMagento Open Source 2.4.6 ou plus récent, avec un accès Composer et à la ligne de commande bin/magento, joignable depuis le Wi-Fi du cube (HTTPS conseillé).
  • Wi-FiUn réseau en 2,4 GHz (le cube ne voit pas le 5 GHz), avec mot de passe WPA2 ou ouvert. Les Wi-Fi d'entreprise avec identifiant (WPA2-Entreprise) et les portails « invités » ne sont pas pris en charge.
  • AlimentationUn chargeur USB-C d'au moins 1 A et son câble. Le cube reste branché en permanence : il n'a pas de batterie.
  • TéléphoneN'importe quel smartphone qui lit les QR codes (ou un ordinateur portable avec Wi-Fi).
02

Installer le module Magento

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 ↗.

03

Créer le jeton du cube

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.

Créer le jeton depuis le back-office plutôt qu'en ligne de commande
  1. System › Extensions › Integrations › Add New Integration, nom « Cube Magento ».
  2. Onglet API : Resource Access « Custom », cocher Click&Mortar Cube et rien d'autre.
  3. Enregistrer, puis « Activate » et « Allow » : copier l'Access Token.
04

Régler le module

Stores › Configuration › Click&Mortar › Cube. Tout fonctionne avec les valeurs par défaut ; les plus utiles :

Daily revenue goalObjectif 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.
TimezoneFuseau qui définit « aujourd'hui » (Europe/Paris par défaut).
Store views countedVues de magasin prises en compte (vide = toutes).
Excluded order statesStatuts ignorés (commandes annulées par défaut).
Enable cube APICoupe l'API d'un clic : le cube affiche alors « API du cube désactivée ».
05

Connecter le cube

  1. 01 Branchez le cube. Tant qu'il n'est pas configuré, il crée son propre Wi-Fi, Cube-XXXX, et affiche un QR code.
  2. 02 Scannez le QR code avec le téléphone : il rejoint ce Wi-Fi (sans mot de passe). Le QR code change alors pour ouvrir la page de réglage.
  3. 03 La page de réglage s'ouvre d'elle-même sur la plupart des téléphones. Sinon, scannez le second QR code ou allez sur http://192.168.4.1.
  4. 04 Remplissez le réseau Wi-Fi (la liste propose ceux que le cube capte), son mot de passe, l'URL de la boutique (https://…, sans /admin ni /rest) et le jeton de l'étape 3.
  5. 05 Enregistrez. Le cube redémarre, rejoint votre Wi-Fi et affiche les chiffres du jour en quelques secondes. Les commandes passées avant sa mise en route ne sont pas rejouées.
Écran de configuration du cube : QR code pour rejoindre le Wi-Fi Cube-3A70
Écran du cube, étape 1
Page de réglage sur le téléphone : réseau Wi-Fi, mot de passe, URL de la boutique, jeton d'intégration, bouton Enregistrer et redémarrer
Page de réglage, étape 4

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.

06

Au quotidien

Tourner la moletteÉcran suivant ou précédent.
Appuyer sur la moletteRejoue l'animation de la dernière commande.
ToucheOuvre le menu. Dans le menu, revient en arrière.
Écran Aujourd'hui

Aujourd'hui

Chiffre d'affaires depuis minuit, écart avec hier à la même heure, commandes, panier moyen, barres des 7 derniers jours.

Écran Vs hier

Vs hier

CA, commandes et panier moyen face à hier à la même heure, avec la variation en %.

Écran 7 jours

7 jours

Total et moyenne par jour ; la ligne pointillée marque le record de chiffre d'affaires.

Écran Dernière commande

Dernière commande

Montant, numéro, ville, nombre d'articles et depuis combien de temps.

Écran Objectif

Objectif

Avancement vers l'objectif du jour réglé dans Magento, et ce qu'il reste à faire.

Les sons et animations

  • Nouvelle commande : animation de 6,5 s et carillon, en moins de dix secondes après la commande. Toucher la molette ou la touche abrège l'animation.
  • Première commande du jour : titre et mélodie dédiés.
  • Record battu : la commande qui fait dépasser le meilleur chiffre d'affaires des 365 derniers jours passe en doré.
  • Plusieurs commandes d'un coup : elles s'enchaînent, la plus ancienne d'abord.
08

Messages et dépannage

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 requisePas de Wi-Fi, d'URL ou de jeton enregistrés : voir l'étape 5.
Wi-Fi injoignableRéseau hors de portée, en 5 GHz seulement, ou mauvais mot de passe. Nouvel essai toutes les 10 s.
Boutique injoignableURL 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 illisibleLa 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.
L'écran reste noir ou le cube redémarre en boucle

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.

Les chiffres ne correspondent pas au back-office

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).

09

Mise à 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.