Get AcelleMail — $80

Construisez n'importe quoi. Sans forker le cœur.

AcelleMail est une plateforme d'email marketing Laravel 11+ avec une surface d'extensibilité qui va bien au-delà des callbacks. Drivers d'envoi, passerelles de paiement, agents IA, pages admin personnalisées, slots UI au niveau page, endpoints REST, listeners de cycle de vie — chacun d'eux est livré comme un plugin auto-contenu sous votre propre namespace. Ceci est la référence complète : onze deep-dives, ancrés sur le code source par rapport aux chemins canoniques dans storage/app/plugins/, App\Library\HookManager et app/Model/Plugin.php.

Commencez par la fondation ↓ Hello World en 5 min
Surfaces d'extension
14
Patterns de hooks
4
Pages deep-dive
11
Temps de lecture
~3 h
Ancré sur le code
100 %

Comment utiliser cette documentation

Lisez dans l'ordre si vous débutez — chaque page se construit sur la précédente. Atterrissez sur une seule page depuis la recherche si vous savez déjà ce dont vous avez besoin : chaque deep-dive se suffit à lui-même avec son propre fil d'Ariane, sa table des matières collante et sa navigation précédent/suivant.

Chaque affirmation sur chaque page est retracée jusqu'à un fichier source sous l'arborescence de docs plugin de la plateforme (docs/plugin/, docs/sending-server-polymorphism/, docs/payment-order-plan-subscription-saas/) ou l'implémentation live storage/app/plugins/Aurius/. Si une affirmation ne peut pas être citée, elle est abandonnée — non paraphrasée.

Temps de lecture, de bout en bout : ~3 heures. Pour livrer un vrai plugin, prévoyez un seul après-midi — l'exemple Hello World prend cinq minutes à scaffolder, et l'exemple détaillé le plus long (un driver d'envoi avec Postal MTA) est d'environ une heure de plugin:init jusqu'à un test d'intégration qui passe.

01 — FONDATION

Le modèle mental d'abord.

Trois pages qui vous emmènent de "Composer, ServiceProvider, c'est quoi ?" à écrire votre premier Hook::add(...) en confiance. Lisez-les dans l'ordre. Le reste de la documentation suppose le flux de chargement et la taxonomie de hooks à quatre patterns.

getting-started Live

Démarrage

Prérequis, php artisan plugin:init, les huit fichiers que le scaffolder écrit, le contrat composer.json, le cycle de vie d'activation, et les sept erreurs les plus courantes du premier jour — validateur de nommage, mismatch de namespace, autoload.psr-4 manquant, le piège register() vs boot().

16 min de lecture Lire →
plugin-architecture Live

Architecture des plugins

Le flux de chargement au boot : AppServiceProvider::boot → Plugin::autoloadWithoutDbQuery → storage/app/plugins/index.json. Timing register() vs boot(). Pourquoi les plugins inactifs s'autoloadent quand même, les quatre états du cycle de vie, et les deux couches d'injection.

18 min de lecture Lire →
hook-system Live

Le système de Hooks — quatre patterns

REGISTRY (add/collect), EVENT (on/fire), BEHAVIOR (set/perform), FILTER (modify/filter) — mécaniques, vrais callsites dans le cœur, sémantique de conflit, convention args-bag, six anti-patterns et un arbre de décision à quatre questions.

21 min de lecture Lire →
02 — CONSTRUCTION

Livrez une vraie fonctionnalité.

Exemples détaillés pour les quatre patterns les plus demandés : un nouveau driver d'envoi (Postal MTA), une passerelle de paiement régionale (Paddle), une surface admin UI personnalisée (le chatbox Aurius) et des tables de base de données isolées par plugin.

sending-drivers Live

Drivers d'envoi — pattern plugin complet

Livrez un nouveau backend MTA sans forker le cœur. Le contrat register_sending_server_driver, la classe driver + 9 marqueurs de capacité, le pipeline de validation, le blade de connexion, le contrôleur webhook, l'identité/warmup. Parcouru de bout en bout contre la revue statique du plugin Postal MTA.

19 min de lecture Lire →
payment-gateways Live

Passerelles de paiement — contrats Cashier

Modèle pull, pas de webhook. Le registry BillingManager, quatre interfaces de capacité, Paddle comme exemple détaillé, la machine à états PaymentIntent, et cinq règles de discipline aux frontières prestataire issues de la leçon sur le défaut de devise TBANK.

17 min de lecture Lire →
ui-injection Live

Injection d'UI — layouts, sidebar, slots de page

Trois hooks REGISTRY de layout (layout.head.assets, layout.body.before_close, admin.sidebar.groups) plus le contrat page.{controller}.{action}.{slot}. Le pattern bulle chatbox de Aurius de bout en bout, la variante FILTER pour les redirections, et six anti-patterns.

16 min de lecture Lire →
database-models Live

Base de données & modèles — isolés par plugin

Migrations sous <plugin>/database/migrations/, noms de tables préfixés par prestataire, cycle de vie activate-exécute / delete-rollback, foreign keys vers les tables cœur, le flag $keepData, et la vitrine Aurius à quatorze migrations.

13 min de lecture Lire →
03 — QUALITÉ

Faites-en du niveau production.

Les traductions par la voie indirecte (fichier master → dump runtime). Cycle de vie par état pour register, activate, disable, delete. Tests Pest enregistrés via le phpunit.xml du cœur avec un cycle activate→test→delete frais par run de CI.

translations Live

Traductions

Fichier master → dump runtime sous storage/app/data/plugins/... → éditable par admin. Le hook REGISTRY add_translation_file, le piège du double-load, la convention dix-huit locales, et le merge non destructif translation:upgrade.

13 min de lecture Lire →
lifecycle Live

Cycle de vie des plugins

Walkthrough par état : register (5 étapes), activate (4 étapes), disable (flip de statut uniquement — autoload + hooks survivent), delete (rollback + nettoyage du master file). Le diagramme d'états, la récupération depuis un état cassé, et la surface console plugin:*.

13 min de lecture Lire →
testing Live

Tests

Enregistrement de la testsuite plugin dans le phpunit.xml hôte, la classe de base PluginTestCase avec seeding de ligne active + reset du cache de gate par requête, patterns hooks-under-test pour REGISTRY / EVENT / BEHAVIOR / FILTER, la recette d'intégration de cycle de vie activate-test-delete, et une matrice CI par plugin.

13 min de lecture Lire →
04 — RÉFÉRENCE

Lisez du vrai code de production.

L'apprentissage le plus profond se fait contre un vrai plugin, pas un Hello World. Aurius est le plugin complexe canonique — huit modèles, douze migrations, dix-huit locales. Utilisez la vitrine pour mapper chaque concept ci-dessus sur une seule base de code livrée.

showcase Live

Vitrine de plugin — Aurius

Le plugin complexe canonique parcouru de bout en bout — huit modèles, quatorze migrations, dix-huit locales, toute la surface des hooks (six contributions REGISTRY + deux listeners EVENT + un override BEHAVIOR), l'UI chatbox, l'infrastructure de tests, et une recette d'apprentissage en quatre étapes.

14 min de lecture Lire →
/api Live

Référence REST API

Authentification par token, les huit ressources (Listes, Abonnés, Campagnes, Automations, Sending servers, Clients, Abonnements, Plans), les six événements webhook de cycle de vie, les trois pings de tracking par destinataire, et les formes d'erreur — la même API que les plugins utilisent est la même API que les clients externes utilisent.

Catalogue d'endpoints Lire →
/kb Live

Base de connaissances

Référence côté opérations : prérequis serveur, configuration supervisor, workers de queue, tuning de délivrabilité, mise en place DKIM/SPF/DMARC, playbooks de migration. Lisez cela quand la question est "comment faire tourner AcelleMail", pas "comment l'étendre".

Hub opérations Ouvrir →

Philosophie de conception

Le cœur déclare les points d'extension. Les plugins réagissent.
Le cœur ne sait jamais que votre plugin existe.

Inversion de dépendance

Le code du cœur n'est jamais importé par un plugin, et un plugin n'est jamais importé par le cœur. Le système de Hooks se tient entre eux comme seul contrat. Mettez à jour le cœur, votre plugin continue de fonctionner — tant que le nom et la signature du hook restent stables, ce que nous estampillons en version.

Quatre patterns, pas plus

REGISTRY, EVENT, BEHAVIOR, FILTER — les seuls verbes que le système de Hooks parle. La sémantique de conflit est explicite par pattern : REGISTRY fusionne, EVENT déclenche tous, FILTER enchaîne, BEHAVIOR est exclusif (deux appelants lèvent immédiatement, pas d'override silencieux).

Votre namespace, pour toujours

Les plugins vivent sous MyVendor\MyPlugin\, complètement isolés du namespace de la plateforme cœur. Composez, vendez, white-label, forkez — votre plugin est à vous. La licence Extended accorde la redistribution commerciale.

Source de vérité : le code

Chaque page de cet arbre de documentation référence le chemin de fichier canonique d'où elle a été tracée. Si une doc est en désaccord avec le code, le code gagne — ouvrez une issue et nous mettrons à jour la doc, pas l'inverse. Pas de copier-coller hérité, pas d'API aspirationnelles.

Ouvrez le source. Étendez la plateforme.

PHP complet non chiffré. Mises à jour à vie. Le système de Hooks. De vrais plugins de production dont apprendre. Licence unique — pas d'abonnements, pas de frais par abonné, pas de squatting de namespace.

Acheter la licence Extended — 199 $ Retour à la landing développeur

Run your email marketing on your own server, your own terms

Join thousands of companies that have taken control of their email marketing with full source code, no recurring fees, and unlimited sending. One-time $80 license, lifetime updates.

Get AcelleMail — $80 one-time

Get the AcelleMail newsletter

Monthly issue with new releases, deliverability tips, and self-hosting playbooks. No spam.