Installation - Adobe Commerce Marketplace & package ZIP

Ce guide couvre l'installation d'Ultimate Cart Recovery via le Marketplace Adobe Commerce (Composer) et via un package ZIP manuel, l'activation de la licence, la vérification post-installation et la désinstallation propre.

Prérequis

Magento Open Source / Adobe Commerce 2.4.6 ou 2.4.7+ (la 2.3 n'est pas supportée).
PHP 8.1, 8.2 ou 8.3.
Composer 2.
Cron Magento opérationnel (le module embarque 7 tâches cron).
Accès SSH/CLI à l'instance et droits d'écriture sur app/code (pour l'installation manuelle).
Une clé de licence Visicrea au format VCR-XXXX-XXXX-XXXX-XXXX (le domaine de production n'est pas requis pour les environnements de dev/staging, qui ne consomment pas la licence).

Option A - Installation via Composer (Marketplace Adobe)

Après l'achat sur le Marketplace Adobe, les identifiants d'accès Composer (public_key / private_key) sont disponibles dans votre compte Marketplace → My Profile → Access Keys. S'ils ne sont pas déjà configurés :

composer config --global http-basic.repo.magento.com <public_key> <private_key>

Installez ensuite le module :

composer require visicrea/module-ultimate-cart-recovery
bin/magento module:enable Visicrea_UltimateCartRecovery
bin/magento setup:upgrade
bin/magento setup:di:compile        # mode production uniquement
bin/magento cache:flush

Si vous utilisez un miroir de package privé (distribution directe Visicrea hors Marketplace), pointez Composer dessus avant le composer require.

Option B - Installation via package ZIP manuel

Décompressez l'archive fournie dans : app/code/Visicrea/UltimateCartRecovery (l'arborescence doit contenir registration.php, etc/module.xml, composer.json, etc. directement sous ce dossier).
Lancez la même séquence d'activation :

bin/magento module:enable Visicrea_UltimateCartRecovery
bin/magento setup:upgrade
bin/magento setup:di:compile        # mode production uniquement
bin/magento cache:flush

Activation de la licence

L'activation se fait depuis l'administration (il n'existe pas de commande CLI d'activation en V1) :

Rendez-vous dans Stores → Configuration → Visicrea → Ultimate Cart Recovery → License.
Renseignez :

Champ	Valeur
License server URL	`https://license.ultimatecartrecovery.com/api/v1`
License key	votre clé `VCR-XXXX-XXXX-XXXX-XXXX`

Enregistrez. Le module vérifie la licence une fois toutes les 24 h. En cas d'indisponibilité du serveur, une période de grâce de 7 jours s'applique, suivie d'une bannière de 30 jours, puis la désactivation des envois (lecture et tableau de bord restent disponibles).

Pour les environnements de dev / staging, forcez le client mock (aucune consommation de licence) :

bin/magento config:set visicrea_ucr/license/server_url mock://always-valid

Le module bascule aussi automatiquement sur le mock lorsque Magento tourne en mode developer.

Vérifiez l'état de la licence :

bin/magento ucr:debug:license

Vérification post-installation

bin/magento module:status Visicrea_UltimateCartRecovery   # doit être "enabled"
bin/magento ucr:debug:license                             # confirme le check serveur
bin/magento ucr:detect                                    # force une passe de détection
bin/magento ucr:debug:cart {quote_id}                     # inspecte un panier (tokens masqués)
bin/magento cron:status                                   # confirme que le cron tourne

Après chaque commande, des entrées doivent apparaître dans var/log/visicrea_ucr.log. Activez visicrea_ucr/general/debug_logging = 1 pour le journal détaillé (var/log/visicrea_ucr_debug.log).

Conseil : laissez visicrea_ucr/general/dry_run = 1 tant que vous n'avez pas validé vos templates contre de vrais destinataires. Le pipeline s'exécute intégralement, seul l'envoi réel est sauté.

Désinstallation propre

La désinstallation suit la procédure standard Magento. Pour une installation par Composer, module:uninstall retire le code et exécute la suppression du schéma :

bin/magento module:uninstall Visicrea_UltimateCartRecovery --remove-data
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

L'option --remove-data supprime les tables visicrea_ucr_* du module.

Attention RGPD/légal : la table visicrea_ucr_unsubscribe contient des désinscriptions à conservation légale. Si vous devez conserver cette liste, exportez-la avant la désinstallation avec suppression des données.

Pour une installation manuelle (package ZIP), désactivez d'abord le module puis retirez le dossier :

bin/magento module:disable Visicrea_UltimateCartRecovery
bin/magento setup:upgrade
# puis supprimer app/code/Visicrea/UltimateCartRecovery
bin/magento cache:flush

La suppression des tables se fait alors manuellement si nécessaire (les noms sont listés dans docs/developer-guide/data-model-reference.md).