Websource Panier abandonné pour WordPress — référence développeur

Architecture

websource-cartrecovery.php   fichier principal : constantes, chargeur PSR-4, compatibilité HPOS, amorçage
src/Plugin.php               amorçage (inerte sans WooCommerce), planification, routes REST
src/Settings.php             réglages (option wsx_cartrecovery_settings), secret de signature
src/Store.php                tables, requêtes, statistiques
src/Tracker.php              suivi des paniers, capture de l'adresse, attribution des commandes
src/Runner.php               passage planifié : éligibilité, envoi, idempotence
src/Scheduler.php            logique de séquence (pure)
src/Eligibility.php          règles d'éligibilité (pures)
src/MessageBuilder.php       construction d'une relance
src/Mail/                    MailRenderer (5 gabarits), Palette, DefaultTexts, Mailer
src/Voucher.php              code promo automatique
src/TokenSigner.php          jetons HMAC-SHA256
src/Front.php, Restorer.php  liens publics, restauration du panier
src/RestorePlanner.php       plan de restauration (pur)
src/Privacy.php              export et effacement RGPD
src/Admin.php, Cli.php       administration, WP-CLI
src/Block.php                bloc et code court

Espace de noms : Websource\CartRecovery. Préfixes : options wsx_cartrecovery_*, tables wsx_cartrecovery_*, classes CSS wscr-*.

Les commandes sont lues et écrites uniquement par l'API de WooCommerce (wc_get_order, wc_get_orders, métadonnées d'objet) : stockage HPOS et stockage historique sont pris en charge.

Bloc et code court

Rendu serveur : formulaire form.wscr-form (adresse e-mail, case de consentement, bouton). Rien n'est affiché pour un client connecté, ni quand l'extension ou la capture d'adresse est désactivée.

Emplacements automatiques : sur les pages Panier et Commande, assets/front.js détecte le champ e-mail (#billing_email du paiement classique, #email du paiement par blocs) et ajoute la case de consentement input[name="wscr_consent"]. Les fichiers ne sont chargés que sur ces pages, et seulement quand une adresse peut être capturée.

Liens publics

Format du jeton : base64url(JSON) . "." . base64url(HMAC-SHA256). Le JSON ne contient que des identifiants numériques. Limitation de débit par adresse IP : 60 restaurations et 40 désinscriptions par 10 minutes. Réponses en noindex, nofollow, sans cache.

Capture de l'adresse (AJAX WooCommerce) :

POST /?wc-ajax=wsx_cr_capture
nonce=<wsxCartRecovery.nonce>&email=marie@exemple.fr&consent=1&firstname=Marie
→ {"ok":true}

Réponses d'erreur : 403 (jeton de formulaire invalide), 429 (trop de demandes ou capture désactivée), {"ok":false,"error":"consent"} (consentement requis et absent : rien n'est enregistré).

Hooks et filtres

Actions

Filtres

Exemple : ne jamais relancer les adresses d'un domaine.

add_filter('wsx_cartrecovery_skip_reason', function ($reason, array $cart) {
    return substr($cart['email'], -13) === '@exemple.test' ? 'internal_address' : $reason;
}, 10, 2);

Exemple : prévenir un outil externe quand un panier est récupéré.

add_action('wsx_cartrecovery_recovered', function (WC_Order $order, int $cartId, int $logId) {
    error_log(sprintf('Panier %d récupéré : commande %d, %s', $cartId, $order->get_id(), $order->get_total()));
}, 10, 3);

Raisons de refus possibles : no_email, status_<statut>, optout, customer_ordered_since, empty, below_minimum, no_consent, no_optin, not_due, already_claimed.

Routes REST

Espace de noms : websource-cartrecovery/v1.

Paramètres de /run : token (jeton de l'onglet Tâche planifiée et démo), dry_run (booléen : ne fait que compter), limit (0 à 500 e-mails).

GET /wp-json/websource-cartrecovery/v1/run?token=<jeton>&dry_run=1
→ {"sent":0,"captured":0,"failed":0,"skipped":0,"purged":0,"locked":false,"disabled":false,"dry_run":true}

Sans jeton valide : 401.

Paramètre de /stats : days (1 à 365, défaut 30).

GET /wp-json/websource-cartrecovery/v1/stats?days=30
→ {"days":30,"last_run":1791484140,
   "totals":{"tracked":10,"active":3,"recovered":1,"sent":6,"failed":0,"opened":0,"clicked":3,"converted":1,
             "revenue":[{"currency":"EUR","amount":"146.610000","orders":"1"}],"optouts":0},
   "daily":{"2026-10-08":{"sent":6,"recovered":1}}}

WP-CLI

wp websource-cartrecovery run [--dry-run] [--force] [--limit=<nombre>]

--dry-run liste ce qui serait envoyé, --force passe même si l'extension est désactivée, --limit plafonne le nombre d'e-mails.

Variables CSS

Les e-mails n'utilisent pas de variables CSS (styles en ligne) : leurs couleurs viennent de l'onglet Modèles d'e-mail ou de l'option wsx_theme_config de Websource Theme Config.

Fonctions publiques

Données enregistrées

Les dates sont en UTC. La désinstallation supprime les tables, les options, les codes promo WSCR- et la tâche planifiée.

Écarts par rapport au module PrestaShop

• Pas de multiboutique (une installation WordPress = une boutique).
• WooCommerce garde le panier dans la session : l'extension conserve sa propre copie du panier (table carts) au lieu de relire le panier natif. Le panier restauré est reconstruit dans la session du visiteur.
• Textes des relances : une seule version, traduite par Polylang ou WPML ; les textes par défaut suivent la langue du panier. Le module PrestaShop stocke un texte par langue.
• Le « déclenchement opportuniste » n'existe pas comme option : la tâche passe par Action Scheduler (WP-Cron), qui fonctionne déjà sur le trafic.
• « Clients avec compte : optin partenaires » devient « clients qui ont coché la case de consentement » (WooCommerce n'a pas de champ optin).
• Le message de restauration utilise les avis de WooCommerce au lieu d'un toast ; pas de rappel dans le tiroir du panier Websource.
• Les e-mails capturés sont gardés dans la table des relances, pas dans des fichiers.
• L'aperçu des modèles utilise les réglages enregistrés (pas d'aperçu avant enregistrement).
• Bloc et code court « Rappel de panier » ajoutés.