Journal d’événements durable pour WordPress

1. Téléchargez l’archive depuis Espace client › Mes produits et licences, puis vérifiez son empreinte SHA-256 avec celle affichée (sous Linux ou macOS : sha256sum durable-web-event-outbox-0.6.3.zip).
2. Dans WordPress, ouvrez Extensions › Ajouter › Téléverser une extension, sélectionnez l’archive et cliquez sur Installer.
3. Activez l’extension. Les tables nécessaires sont créées à l’activation ; un message d’erreur apparaît dans l’administration si la base de données refuse leur création.
4. Affectez la licence au site dans votre espace client (Réaffecter ce droit) : c’est ce qui ouvre le support et les mises à jour pour ce site.

Une seule table est créée : {prefix}web_event_identities, qui porte les clés d’idempotence. Les événements eux-mêmes sont enregistrés comme contenus privés d’un type interne, dans les tables de contenus de WordPress.

wp_web_events_emit('order.paid', ['order_id' => 42, 'total' => '42.00'], 'order-42-paid');

• Le premier argument est le nom, le deuxième la charge utile, le troisième une clé d’idempotence facultative : la même clé, pour le même nom d’événement, renvoie l’événement déjà enregistré ; un contenu différent sous ce même couple est refusé. Deux noms différents portant la même clé restent deux événements.
• Le nom est normalisé avant enregistrement : mis en minuscules et réduit aux lettres non accentuées, chiffres, points, tirets et tirets bas, les autres caractères étant supprimés sans erreur. Il est refusé s’il est vide après normalisation ou s’il dépasse 100 octets.
• La fonction renvoie l’identifiant de l’événement, ou une erreur WordPress : nom invalide, émission suspendue par une politique, charge utile refusée, conflit d’idempotence, ressource occupée, écriture impossible. Testez systématiquement le retour.
• La charge utile est contrôlée avant tout enregistrement. L’émission est refusée au-delà de 32 768 octets une fois encodée en JSON, au-delà de huit niveaux d’imbrication, au-delà de 256 éléments tous niveaux confondus, pour une chaîne de plus de 4 096 octets ou un nom de clé de plus de 100 octets, et pour toute valeur qui n’est ni une chaîne, ni un entier, ni un booléen, ni un nombre décimal fini, ni une valeur absente, ni un tableau de ces types. La clé d’idempotence est bornée à 512 octets.
• Le refus des données sensibles porte sur le nom de la clé et sur la forme des valeurs, et il est volontairement large. Sont refusées les clés key et toutes celles qui se terminent par _key, ainsi que celles dont un mot est email, e_mail, phone, telephone, mobile, message, token, nonce, password, secret, authorization, credential, cookie, session, document, medical, health, address, name, first_name, last_name, full_name, iban, card, ssn, nir ou birth. Les clés courantes name, message, document et order_key sont donc refusées : nommez product_label plutôt que product_name. Côté valeurs sont refusées une adresse électronique, un numéro de téléphone français, un paramètre token, nonce, key ou password dans une chaîne de requête, un en-tête d’autorisation porteur et un jeton web JSON.
• Le webhook reçoit un JSON {id, name, occurred_at, attempt, payload} et les en-têtes X-Web-Event-Id, X-Web-Event-Name, X-Web-Event-Timestamp, X-Web-Event-Signature.
• Livraison : quelques secondes après l’émission, puis toutes les cinq minutes ; en cas d’échec, nouvelle tentative avec temporisation exponentielle plafonnée à six heures, jusqu’à dix tentatives, puis état « Échoué » relançable.
• Le tableau de bord de Réglages › Événements web montre les compteurs par état, l’événement en attente le plus ancien, le prochain cycle, les 25 derniers événements avec leur dernier résultat, et propose « Livrer maintenant les événements en attente » et « Réessayer maintenant ».
• WP-CLI, facultatif : wp web-events status affiche tous les compteurs, dont celui des événements en attente faute de destination ; wp web-events dispatch lance un cycle, éventuellement restreint à des identifiants ; wp web-events retry <id> relance un événement en échec.

• Le journal garantit la conservation et la relivraison ; il ne garantit pas l’ordre strict entre événements différents.
• Un événement livré à plusieurs puits n’est marqué livré que si tous ont réussi ; un puits défaillant provoque la relivraison à tous.
• Le secret est conservé en clair dans la table des options WordPress ; restreignez l’accès administrateur en conséquence.
• La purge s’exécute une fois par jour et retire au plus 200 événements par passage, uniquement parmi ceux qui sont livrés ou en échec ; elle supprime en même temps leur ligne d’identité.

Désinstaller depuis Extensions › Supprimer retire les événements, la table d’identités, les réglages et les tâches planifiées. Désactiver sans supprimer conserve les événements, la table d’identités et les réglages ; les deux tâches planifiées sont retirées à la désactivation et recréées à la réactivation.