WP Manifestindependent plugin directory
manifest / email / eg-mail

EG Mail

Middleware d'interception transparente de wp_mail(), régulation SMTP multi-niveaux et gestion de lots d'e-mails.

by Etienne Gagnon · github.com/trollinou/eg-mail · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/trollinou/eg-mail/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/trollinou/eg-mail ↗

EG Mail — Régulation SMTP & Gestion de Lots pour WordPress

EG Mail est une extension WordPress conçue pour agir comme un middleware d'interception transparent de la fonction native wp_mail(). Elle assure la régulation de flux SMTP multi-niveaux, l'ordonnancement par priorités (avec routage nocturne) et offre une interface d'administration par lots permettant d'interrompre ou d'annuler instantanément des campagnes en cours de diffusion.

Fonctionnalités Principales

  1. Interception Transparente (wp_mail) :

    • Fonctionne sans modification du code des plugins tiers appelants.
    • Capture de l'ensemble du contexte WordPress (content_type, charset, from_email, from_name).
    • Mode bypass immédiat pour les messages critiques (2FA, réinitialisation de mot de passe).

  2. Régulation de Flux Multi-Niveaux (Rate Limiting) :

    • Quota par minute différencié Jour / Nuit.
    • Quota glissant optionnel par heure (sur les 60 dernières minutes).
    • Marge de sécurité dédiée aux e-mails critiques.

  3. Ordonnancement & Plage Nocturne :

    • Gestion de 4 priorités (Bypass, Critique, Normale, Basse/Nuit).
    • Report automatique des envois de masse sur la fenêtre nocturne configurée (ex: 22h00 – 06h00).
    • Coupe-circuit de débordement au lever du jour si les quotas horaires bloquent la file.

  4. Gestion de Campagnes & Annulation en Direct (batch_id) :

    • Regroupement automatique des envois massifs par campagne.
    • Boutons d'action immédiate : Pause, Reprise, Reprogrammation (date/heure et priorité), Annuler et purger.
    • Coupe-circuit intra-boucle dans le Worker pour stopper net un lot à la seconde près.

  5. Déduplication des Pièces Jointes & Résilience (PRA) :

    • Spool sécurisé avec déduplication par empreinte MD5.
    • Snapshot miroir JSON sur disque (queue-snapshot.json) pour restauration automatique.
    • Déclaration native auprès de l'extension EG Backup & Restore.

Prérequis Techniques

  • PHP : 8.4 minimum (declare(strict_types=1); requis).
  • WordPress : 7.1 minimum.
  • Node.js : 24 LTS (uniquement pour l'outillage de build et les tests frontend).
  • Composer : 2.x (outillage d'assurance qualité en développement).

Commandes de Développement & Assurance Qualité (QA)

Toute modification doit être validée sans aucune erreur ni avertissement :

# 1. Analyse statique stricte (PHPStan Level 8)
composer phpstan

# 2. Correction automatique du style de code
composer phpcbf

# 3. Validation des standards de code WordPress (WPCS)
composer phpcs

# 4. Vérification du typage TypeScript
npm run typecheck

# 5. Linting JavaScript / TypeScript (ESLint 9)
npm run lint

# 6. Tests unitaires (PHPUnit 11)
composer test

# 7. Compilation des assets frontend
npm run build

# 8. Synchronisation et montée de version SemVer (ex: 1.1.0)
npm run version:sync -- 1.1.0

# 9. Création de l'archive ZIP autonome de production (avec validation QA intégrée)
npm run package

Documentation

  • USING.md : Guide utilisateur pour les administrateurs (interface back-office, réglages de quotas, plage nocturne, suivi des campagnes et plan de reprise d'activité).
  • DEVELOPER.md : Guide complet pour les développeurs (headers X-Queue-*, niveaux de priorité, bypass immédiat, capture de contexte et exemples de code).
  • CHANGELOG.md : Historique des versions et évolutions.

Licence

Ce projet est distribué sous licence GNU General Public License v2 ou supérieure.