Construa qualquer coisa. Sem dar fork no core.

O AcelleMail é uma plataforma de email marketing Laravel 11+ com uma superfície de extensibilidade que vai bem além de callbacks. Drivers de envio, gateways de pagamento, agents de AI, páginas admin customizadas, slots de UI nível-página, endpoints REST, listeners de ciclo de vida — cada um deles entregue como plugin autocontido sob seu próprio namespace. Esta é a referência completa: onze deep-dives, source-grounded contra os code paths canônicos em storage/app/plugins/, App\Library\HookManager e app/Model/Plugin.php.

Comece pela foundation ↓ Hello World em 5 min
Superfícies de extensão
14
Padrões de hook
4
Páginas deep-dive
11
Tempo de leitura
~3h
Source-grounded
100%

Como usar esta documentação

Leia em ordem se está começando do zero — cada página se apoia na anterior. Caia numa única página da busca se você já sabe o que precisa: cada deep-dive se sustenta sozinho com seu próprio breadcrumb, sticky table of contents e navegação prev/next.

Toda afirmação em toda página é rastreada de volta a um arquivo-fonte sob a árvore de docs de plugin da plataforma (docs/plugin/, docs/sending-server-polymorphism/, docs/payment-order-plan-subscription-saas/) ou a implementação ao vivo em storage/app/plugins/Aurius/. Se uma afirmação não pode ser citada, é descartada — não parafraseada.

Tempo de leitura, ponta a ponta: ~3 horas. Para entregar um plugin real, planeje uma única tarde — o sample Hello World leva cinco minutos para fazer scaffold, e o exemplo trabalhado mais longo (um sending driver com Postal MTA) é cerca de uma hora de plugin:init até um teste de integração passando.

01 — FOUNDATION

Modelo mental primeiro.

Três páginas que levam você de "Composer, ServiceProvider, what?" para escrever seu primeiro Hook::add(...) com confiança. Leia na ordem. O resto dos docs assume o fluxo de load e a taxonomia de quatro padrões de hook.

getting-started Live

Começar

Pré-requisitos, php artisan plugin:init, os oito arquivos que o scaffolder escreve, o contrato composer.json, o ciclo de vida de activate, e os sete erros mais comuns do primeiro dia — validator de nomenclatura, namespace mismatch, autoload.psr-4 faltando, a armadilha register() vs boot().

16 min de leitura Ler →
plugin-architecture Live

Arquitetura de plugin

O fluxo de load em tempo de boot: AppServiceProvider::boot → Plugin::autoloadWithoutDbQuery → storage/app/plugins/index.json. Timing de register() vs boot(). Por que plugins inativos ainda fazem autoload, os quatro estados de ciclo de vida e as duas camadas de injeção.

18 min de leitura Ler →
hook-system Live

O sistema de Hook — quatro padrões

REGISTRY (add/collect), EVENT (on/fire), BEHAVIOR (set/perform), FILTER (modify/filter) — mecânicas, call-sites reais no core, semântica de conflito, convenção do args-bag, seis anti-padrões e uma árvore de decisão de quatro perguntas.

21 min de leitura Ler →
02 — BUILDING

Entregue uma feature real.

Exemplos trabalhados para os quatro padrões mais perguntados: um novo sending driver (Postal MTA), um gateway de pagamento regional (Paddle), uma superfície de UI admin customizada (o chatbox Aurius) e tabelas de banco isoladas por plugin.

sending-drivers Live

Drivers de envio — padrão completo de plugin

Entregue um novo backend MTA sem dar fork no core. O contrato register_sending_server_driver, a classe do driver + 9 capability markers, pipeline de validação, blade de conexão, controller de webhook, identity/warmup. Trabalhado de ponta a ponta contra a revisão estática do plugin Postal MTA.

19 min de leitura Ler →
payment-gateways Live

Gateways de pagamento — contratos Cashier

Pull model, sem webhook. O registry BillingManager, quatro capability interfaces, Paddle como exemplo trabalhado, a state machine PaymentIntent e cinco regras de disciplina de fronteira-com-vendor da lição de currency-default do TBANK.

17 min de leitura Ler →
ui-injection Live

Injeção de UI — layouts, sidebar, slots de página

Três hooks REGISTRY de layout (layout.head.assets, layout.body.before_close, admin.sidebar.groups) mais o contrato page.{controller}.{action}.{slot}. O padrão do bubble de chatbox do Aurius de ponta a ponta, a variante FILTER para redirects e seis anti-padrões.

16 min de leitura Ler →
database-models Live

Banco & models — isolados por plugin

Migrations sob <plugin>/database/migrations/, nomes de tabela vendor-prefixed, o ciclo de vida activate-runs / delete-rolls-back, foreign keys para tabelas do core, a flag $keepData e o showcase de catorze migrations do Aurius.

13 min de leitura Ler →
03 — QUALITY

Faça production-grade.

Traduções pelo jeito indireto (master file → dump runtime). Ciclo de vida per-state para register, activate, disable, delete. Testes Pest registrados pelo phpunit.xml do core com um ciclo fresco activate→test→delete por CI run.

translations Live

Traduções

Master file → dump runtime sob storage/app/data/plugins/... → admin-editável. O hook REGISTRY add_translation_file, a armadilha do double-load, a convenção de dezoito locales e o merge não-destrutivo translation:upgrade.

13 min de leitura Ler →
lifecycle Live

Ciclo de vida do plugin

Walkthrough per-state: register (5 passos), activate (4 passos), disable (só flip de status — autoload + hooks sobrevivem), delete (rollback + limpeza de master-file). O diagrama de estados, recuperação de estado quebrado e a superfície de console plugin:*.

13 min de leitura Ler →
testing Live

Testes

Registro da testsuite do plugin no phpunit.xml do host, a classe base PluginTestCase com seed de linha ativa + reset per-request do gate-cache, padrões de hooks-under-test para REGISTRY / EVENT / BEHAVIOR / FILTER, a receita de integração de ciclo de vida activate-test-delete e uma matriz CI per-plugin.

13 min de leitura Ler →
04 — REFERENCE

Leia código de produção real.

O aprendizado mais profundo acontece contra um plugin real, não um Hello World. Aurius é o plugin complexo canônico — oito models, doze migrations, dezoito locales. Use o showcase para mapear todo conceito acima num único codebase entregue.

showcase Live

Showcase de plugin — Aurius

O plugin complexo canônico percorrido de ponta a ponta — oito models, catorze migrations, dezoito locales, toda superfície de hook (seis contribuições REGISTRY + dois listeners EVENT + um override BEHAVIOR), a UI do chatbox, a infraestrutura de teste e uma receita de aprendizado de quatro passos.

14 min de leitura Ler →
/api Live

Referência da API REST

Autenticação por token, os oito recursos (Lists, Subscribers, Campaigns, Automations, Sending servers, Customers, Subscriptions, Plans), os seis eventos de webhook de ciclo de vida, os três pings de tracking por destinatário e shapes de erro — a mesma API que plugins usam é a mesma API que clients externos usam.

Catálogo de endpoints Ler →
/kb Live

Knowledge Base

Referência operations-side: requisitos de servidor, configuração de supervisor, queue workers, ajuste fino de deliverability, setup de DKIM/SPF/DMARC, playbooks de migração. Leia isso quando a pergunta é "como rodo o AcelleMail", não "como estendo".

Hub de operações Abrir →

Filosofia de design

O core declara extension points. Plugins reagem.
O core nunca sabe que seu plugin existe.

Inversão de dependência

Código do core nunca é importado por um plugin, e um plugin nunca é importado pelo core. O sistema de Hook se senta entre eles como o único contrato. Upgrade o core, seu plugin continua funcionando — enquanto o nome e a assinatura do hook permanecerem estáveis, o que a gente carimba com versão.

Quatro padrões, sem mais

REGISTRY, EVENT, BEHAVIOR, FILTER — os únicos verbos que o sistema de Hook fala. Semântica de conflito é explícita por padrão: REGISTRY merges, EVENT all-fire, FILTER chains, BEHAVIOR é exclusivo (dois callers lançam imediatamente, sem override silencioso).

Seu namespace, para sempre

Plugins vivem sob MyVendor\MyPlugin\, completamente isolados do namespace da plataforma core. Componha, venda, faça marca branca, dê fork — seu plugin é seu. A Licença Extended garante redistribuição comercial.

Fonte da verdade: o código

Toda página nesta árvore de docs linka o caminho de arquivo canônico de onde foi rastreada. Se um doc discorda do código, o código ganha — abra uma issue e a gente atualiza o doc, não o contrário. Sem copy-paste legado, sem APIs aspiracionais.

Abra o código. Estenda a plataforma.

PHP totalmente não encriptado. Updates vitalícios. O sistema de Hook. Plugins de produção reais para aprender. Licença única — sem assinaturas, sem taxa por assinante, sem namespace squatting.

Voltar para a landing de desenvolvedor

Rode seu email marketing no seu próprio servidor, nos seus próprios termos

Junte-se a milhares de empresas que assumiram o controle do seu email marketing com código-fonte completo, sem mensalidades e envios ilimitados. Licença de pagamento único de $80, atualizações vitalícias.

Get the AcelleMail newsletter

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