Ottieni AcelleMail — $80

Costruisci qualsiasi cosa. Senza forkare il core.

AcelleMail è una piattaforma di email marketing Laravel 11+ con una superficie di estensibilità che va ben oltre i semplici callback. Sending driver, gateway di pagamento, agenti AI, pagine admin personalizzate, slot UI a livello di pagina, REST endpoint, listener di lifecycle — ognuno di essi viene distribuito come plugin autocontenuto sotto il tuo namespace. Questo è il riferimento completo: undici approfondimenti, basati sul codice sorgente canonico in storage/app/plugins/, App\Library\HookManager e app/Model/Plugin.php.

Parti dalle fondamenta ↓ Hello World in 5 min
Superfici di estensione
14
Pattern Hook
4
Pagine di approfondimento
11
Tempo di lettura
~3h
Basato sul sorgente
100%

Come usare questa documentazione

Leggi in ordine se stai partendo da zero — ogni pagina si costruisce su quella precedente. Atterra su una singola pagina dalla ricerca se sai già cosa ti serve: ogni approfondimento è autonomo, con il suo breadcrumb, l'indice sticky e la navigazione precedente/successivo.

Ogni affermazione su ogni pagina è tracciata fino a un file sorgente sotto l'albero dei docs del plugin della piattaforma (docs/plugin/, docs/sending-server-polymorphism/, docs/payment-order-plan-subscription-saas/) o all'implementazione live storage/app/plugins/Aurius/. Se un'affermazione non può essere citata, viene scartata — non parafrasata.

Tempo di lettura, da capo a fondo: ~3 ore. Per shippare un plugin reale, conta un pomeriggio — l'esempio Hello World si scaffold in cinque minuti, e l'esempio più lungo (un sending driver con Postal MTA) è circa un'ora da plugin:init fino a un integration test che passa.

01 — FONDAMENTA

Prima il modello mentale.

Tre pagine che ti portano da "Composer, ServiceProvider, cosa?" a scrivere il tuo primo Hook::add(...) con sicurezza. Leggile in ordine. Il resto dei docs assume il flusso di load e la tassonomia a quattro pattern degli hook.

getting-started Live

Per iniziare

Prerequisiti, php artisan plugin:init, gli otto file che lo scaffolder scrive, il contratto di composer.json, il lifecycle di activate, e i sette errori più comuni del primo giorno — naming validator, namespace mismatch, autoload.psr-4 mancante, il tranello register() vs boot().

16 min di lettura Leggi →
plugin-architecture Live

Architettura del plugin

Il flusso di load al boot: AppServiceProvider::boot → Plugin::autoloadWithoutDbQuery → storage/app/plugins/index.json. Timing di register() vs boot(). Perché i plugin inattivi sono comunque autoloadati, i quattro stati del lifecycle, e i due layer di injection.

18 min di lettura Leggi →
hook-system Live

Il sistema Hook — quattro pattern

REGISTRY (add/collect), EVENT (on/fire), BEHAVIOR (set/perform), FILTER (modify/filter) — meccanica, callsite reali nel core, semantica dei conflitti, convenzione args-bag, sei anti-pattern e un decision tree a quattro domande.

21 min di lettura Leggi →
02 — COSTRUIRE

Shippa una feature reale.

Esempi pratici per i quattro pattern più richiesti: un nuovo sending driver (Postal MTA), un gateway di pagamento regionale (Paddle), una superficie UI admin personalizzata (la chatbox Aurius) e tabelle database isolate per plugin.

sending-drivers Live

Sending driver — pattern plugin completo

Shippa un nuovo backend MTA senza forkare il core. Il contratto register_sending_server_driver, la classe driver + 9 capability marker, validation pipeline, blade di connessione, controller webhook, identità/warmup. Esempio end-to-end basato sulla static review del plugin Postal MTA.

19 min di lettura Leggi →
payment-gateways Live

Gateway di pagamento — contratti Cashier

Modello pull, niente webhook. Il registry BillingManager, quattro interface di capability, Paddle come esempio pratico, la state machine di PaymentIntent, e cinque regole di disciplina vendor-boundary dalla lezione del default currency di TBANK.

17 min di lettura Leggi →
ui-injection Live

UI injection — layout, sidebar, slot di pagina

Tre hook REGISTRY di layout (layout.head.assets, layout.body.before_close, admin.sidebar.groups) più il contratto page.{controller}.{action}.{slot}. Il pattern chatbox-bubble di Aurius end-to-end, la variante FILTER per i redirect, e sei anti-pattern.

16 min di lettura Leggi →
database-models Live

Database & modelli — isolati per plugin

Migration sotto <plugin>/database/migrations/, table name con prefisso vendor, lifecycle activate-runs / delete-rolls-back, foreign key alle tabelle core, il flag $keepData, e lo showcase a quattordici migration di Aurius.

13 min di lettura Leggi →
03 — QUALITÀ

Rendilo production-grade.

Traduzioni alla maniera indiretta (master file → runtime dump). Lifecycle per-state per register, activate, disable, delete. Test Pest registrati attraverso il phpunit.xml del core con un ciclo fresco activate→test→delete per ogni run CI.

translations Live

Traduzioni

Master file → runtime dump sotto storage/app/data/plugins/... → editabile da admin. L'hook REGISTRY add_translation_file, il tranello del double-load, la convenzione a diciotto locale, e il merge non distruttivo translation:upgrade.

13 min di lettura Leggi →
lifecycle Live

Lifecycle del plugin

Walkthrough per-state: register (5 passi), activate (4 passi), disable (solo flip dello status — autoload + hook sopravvivono), delete (rollback + cleanup del master file). Il diagramma degli stati, recovery da stato corrotto, e la superficie console plugin:*.

13 min di lettura Leggi →
testing Live

Testing

Registrazione del testsuite del plugin nel phpunit.xml host, la base class PluginTestCase con seeding di active-row + reset della gate-cache per request, pattern hooks-under-test per REGISTRY / EVENT / BEHAVIOR / FILTER, la ricetta di integration activate-test-delete, e una matrice CI per-plugin.

13 min di lettura Leggi →
04 — RIFERIMENTO

Leggi codice reale di produzione.

L'apprendimento più profondo avviene contro un plugin reale, non un Hello World. Aurius è il plugin complesso canonico — otto modelli, dodici migration, diciotto locale. Usa lo showcase per mappare ogni concetto qui sopra su un singolo codebase shippato.

showcase Live

Showcase plugin — Aurius

Il plugin complesso canonico percorso end-to-end — otto modelli, quattordici migration, diciotto locale, ogni superficie hook (sei contribuzioni REGISTRY + due listener EVENT + un override BEHAVIOR), la UI chatbox, l'infrastruttura di test e una ricetta di apprendimento in quattro passi.

14 min di lettura Leggi →
/api Live

Riferimento REST API

Autenticazione a token, le otto risorse (Lists, Subscribers, Campaigns, Automations, Sending servers, Customers, Subscriptions, Plans), i sei eventi webhook di lifecycle, i tre ping di tracking per-recipient, e le shape degli errori — la stessa API che i plugin usano è la stessa API che i client esterni usano.

Catalogo endpoint Leggi →
/kb Live

Knowledge Base

Riferimento lato operations: requisiti server, configurazione supervisor, queue worker, tuning di deliverability, setup DKIM/SPF/DMARC, playbook di migrazione. Leggi questo quando la domanda è "come gestisco AcelleMail", non "come lo estendo".

Hub operations Apri →

Filosofia di design

Il core dichiara i punti di estensione. I plugin reagiscono.
Il core non sa mai che il tuo plugin esiste.

Inversione di dipendenza

Il codice core non viene mai importato da un plugin, e un plugin non viene mai importato dal core. Il sistema Hook sta tra loro come unico contratto. Aggiorna il core, il tuo plugin continua a funzionare — finché il nome e la signature dell'hook restano stabili, e noi li versioniamo.

Quattro pattern, non di più

REGISTRY, EVENT, BEHAVIOR, FILTER — gli unici verbi che il sistema Hook parla. La semantica dei conflitti è esplicita per pattern: REGISTRY fa merge, EVENT all-fire, FILTER concatena, BEHAVIOR è esclusivo (due caller lanciano immediatamente, niente override silenzioso).

Il tuo namespace, per sempre

I plugin vivono sotto MyVendor\MyPlugin\, completamente isolati dal namespace della piattaforma core. Componi, vendi, fai white-label, forka — il tuo plugin è tuo. La Extended License concede la redistribuzione commerciale.

Source of truth: il codice

Ogni pagina in questo albero docs linka il percorso file canonico da cui è stata tracciata. Se un doc è in disaccordo con il codice, vince il codice — apri una issue e aggiorniamo il doc, non il contrario. Niente copia-incolla legacy, niente API aspirazionali.

Apri il sorgente. Estendi la piattaforma.

PHP completo non cifrato. Aggiornamenti a vita. Il sistema Hook. Plugin reali di produzione da cui imparare. Licenza una tantum — niente abbonamenti, niente fee per-subscriber, niente squatting di namespace.

Acquista Extended License — $199 Torna alla landing developer

Gestisci il tuo email marketing sul tuo server, alle tue condizioni

Unisciti alle migliaia di aziende che hanno preso il controllo del loro email marketing con codice sorgente completo, nessun canone ricorrente e invii illimitati. Licenza una tantum $80, aggiornamenti a vita.

Ottieni AcelleMail — $80 una tantum

Get the AcelleMail newsletter

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