Obtener AcelleMail — $80

Construya cualquier cosa. Sin bifurcar el core.

AcelleMail es una plataforma de email marketing en Laravel 11+ con una superficie de extensibilidad que va mucho más allá de los callbacks. Drivers de envío, pasarelas de pago, agentes de IA, páginas de administración a medida, slots de UI a nivel de página, endpoints REST, listeners de ciclo de vida: cada uno de ellos se entrega como un plugin autónomo bajo su propio namespace. Esta es la referencia completa: once análisis a fondo, fundamentados en el código contra las rutas canónicas en storage/app/plugins/, App\Library\HookManager y app/Model/Plugin.php.

Empiece por los fundamentos ↓ Hello World en 5 min
Puntos de extensión
14
Patrones de hook
4
Páginas de análisis a fondo
11
Tiempo de lectura
~3h
Fundamentado en código
100%

Cómo usar esta documentación

Lea en orden si está empezando desde cero: cada página se apoya en la anterior. Caiga en una sola página desde un buscador si ya sabe lo que necesita: cada análisis a fondo se sostiene por sí solo, con su propio breadcrumb, tabla de contenidos sticky y navegación prev/next.

Cada afirmación en cada página se rastrea hasta un archivo fuente bajo el árbol de docs de plugins de la plataforma (docs/plugin/, docs/sending-server-polymorphism/, docs/payment-order-plan-subscription-saas/) o la implementación viva en storage/app/plugins/Aurius/. Si una afirmación no se puede citar, se elimina, no se parafrasea.

Tiempo de lectura, de principio a fin: ~3 horas. Para entregar un plugin real, planifique una sola tarde: la muestra Hello World tarda cinco minutos en hacer el scaffold, y el ejemplo trabajado más largo (un driver de envío con Postal MTA) ronda la hora desde plugin:init hasta un test de integración exitoso.

01 — FUNDAMENTOS

Primero el modelo mental.

Tres páginas que le llevan de «Composer, ServiceProvider, ¿qué?» a escribir su primer Hook::add(...) con confianza. Léalas en orden. El resto de las docs asume el flujo de carga y la taxonomía de hook de cuatro patrones.

getting-started En vivo

Primeros pasos

Requisitos previos, php artisan plugin:init, los ocho archivos que escribe el scaffolder, el contrato del composer.json, el ciclo de vida de la activación y los siete errores más comunes del primer día: validador de nombres, desajuste de namespace, autoload.psr-4 ausente, la trampa de register() vs. boot().

16 min de lectura Leer →
plugin-architecture En vivo

Arquitectura de plugins

El flujo de carga en el arranque: AppServiceProvider::boot → Plugin::autoloadWithoutDbQuery → storage/app/plugins/index.json. Tiempos de register() vs. boot(). Por qué los plugins inactivos siguen siendo autocargados, los cuatro estados del ciclo de vida y las dos capas de inyección.

18 min de lectura Leer →
hook-system En vivo

El sistema de Hooks — cuatro patrones

REGISTRY (add/collect), EVENT (on/fire), BEHAVIOR (set/perform), FILTER (modify/filter): mecánica, call-sites reales en el core, semántica de conflictos, convención de la bolsa de args, seis antipatrones y un árbol de decisión de cuatro preguntas.

21 min de lectura Leer →
02 — CONSTRUCCIÓN

Entregue una funcionalidad real.

Ejemplos trabajados para los cuatro patrones más preguntados: un nuevo driver de envío (Postal MTA), una pasarela de pago regional (Paddle), una superficie de UI de administración a medida (el chatbox de Aurius) y tablas de base de datos aisladas del plugin.

sending-drivers En vivo

Drivers de envío — patrón completo de plugin

Entregue un backend MTA nuevo sin bifurcar el core. El contrato register_sending_server_driver, la clase del driver + 9 marcadores de capability, el pipeline de validación, la blade de conexión, el controlador de webhook, la identidad/warmup. Trabajado de principio a fin contra la revisión estática del plugin de Postal MTA.

19 min de lectura Leer →
payment-gateways En vivo

Pasarelas de pago — contratos de Cashier

Modelo pull, sin webhook. El registro BillingManager, cuatro interfaces de capability, Paddle como ejemplo trabajado, la máquina de estados PaymentIntent y cinco reglas de disciplina de frontera con el proveedor de la lección del valor por defecto de moneda de TBANK.

17 min de lectura Leer →
ui-injection En vivo

Inyección de UI — layouts, barra lateral, slots de página

Tres hooks REGISTRY de layout (layout.head.assets, layout.body.before_close, admin.sidebar.groups) más el contrato page.{controller}.{action}.{slot}. El patrón de la burbuja del chatbox de Aurius de principio a fin, la variante FILTER para redirecciones y seis antipatrones.

16 min de lectura Leer →
database-models En vivo

Base de datos y modelos — aislados por plugin

Migraciones bajo <plugin>/database/migrations/, nombres de tabla prefijados por vendor, el ciclo de activate-ejecuta / delete-revierte, claves foráneas a tablas del core, el flag $keepData y la muestra de catorce migraciones de Aurius.

13 min de lectura Leer →
03 — CALIDAD

Hágalo de grado producción.

Traducciones por la vía indirecta (archivo maestro → volcado de runtime). Ciclo de vida por estado para register, activate, disable y delete. Tests Pest registrados a través del phpunit.xml del core con un ciclo fresco de activate→test→delete por cada ejecución de CI.

translations En vivo

Traducciones

Archivo maestro → volcado de runtime bajo storage/app/data/plugins/... → editable por el admin. El hook REGISTRY add_translation_file, la trampa de la doble carga, la convención de los dieciocho locales y el merge no destructivo de translation:upgrade.

13 min de lectura Leer →
lifecycle En vivo

Ciclo de vida del plugin

Recorrido por estado: register (5 pasos), activate (4 pasos), disable (solo cambio de estado: autoload + hooks sobreviven), delete (rollback + limpieza del archivo maestro). El diagrama de estados, la recuperación de un estado roto y la superficie de consola plugin:*.

13 min de lectura Leer →
testing En vivo

Testing

Registro del testsuite del plugin en el phpunit.xml del host, la clase base PluginTestCase con sembrado de fila activa + reseteo de caché de gate por petición, patrones de hooks bajo test para REGISTRY / EVENT / BEHAVIOR / FILTER, la receta de integración del ciclo de vida activate-test-delete y una matriz de CI por plugin.

13 min de lectura Leer →
04 — REFERENCIA

Lea código real de producción.

El aprendizaje más profundo ocurre contra un plugin real, no un Hello World. Aurius es el plugin complejo canónico: ocho modelos, doce migraciones, dieciocho locales. Use la muestra para mapear cada concepto de arriba sobre un único código fuente de envío.

showcase En vivo

Muestra de plugin — Aurius

El plugin complejo canónico recorrido de principio a fin: ocho modelos, catorce migraciones, dieciocho locales, todas las superficies de hook (seis contribuciones REGISTRY + dos listeners EVENT + una sobrescritura BEHAVIOR), la UI del chatbox, la infraestructura de tests y una receta de aprendizaje en cuatro pasos.

14 min de lectura Leer →
/api En vivo

Referencia de la REST API

Autenticación por token, los ocho recursos (Listas, Suscriptores, Campañas, Automatizaciones, Servidores de envío, Clientes, Suscripciones, Planes), los seis eventos webhook del ciclo de vida, los tres pings de seguimiento por destinatario y los formatos de error: la misma API que usan los plugins es la que usan los clientes externos.

Catálogo de endpoints Leer →
/kb En vivo

Base de conocimiento

Referencia del lado de operaciones: requisitos del servidor, configuración de supervisor, queue workers, ajuste de entregabilidad, configuración de DKIM/SPF/DMARC, playbooks de migración. Léala cuando la pregunta sea «cómo ejecuto AcelleMail», no «cómo lo extiendo».

Hub de operaciones Abrir →

Filosofía de diseño

El core declara puntos de extensión. Los plugins reaccionan.
El core nunca sabe que su plugin existe.

Inversión de dependencias

El código del core nunca lo importa un plugin, y un plugin nunca lo importa el core. El sistema de Hooks se sitúa entre ambos como único contrato. Actualice el core y su plugin sigue funcionando, siempre que el nombre y la firma del hook se mantengan estables, cosa que marcamos con versión.

Cuatro patrones, no más

REGISTRY, EVENT, BEHAVIOR, FILTER: los únicos verbos que habla el sistema de Hooks. La semántica de conflictos es explícita por patrón: REGISTRY fusiona, EVENT dispara a todos, FILTER encadena y BEHAVIOR es exclusivo (dos llamantes lanzan excepción de inmediato, sin sobrescritura silenciosa).

Su namespace, para siempre

Los plugins viven bajo MyVendor\MyPlugin\, completamente aislados del namespace de la plataforma core. Compóngalos, véndalos, póngalos en marca blanca, bifúrquelos: su plugin es suyo. La Licencia Extendida concede la redistribución comercial.

Fuente de verdad: el código

Cada página en este árbol de docs enlaza la ruta de archivo canónica de la que se rastreó. Si una doc no coincide con el código, gana el código: abra un issue y actualizamos la doc, no al revés. Sin copia-pega legacy, sin APIs aspiracionales.

Abra el código fuente. Extienda la plataforma.

PHP completo y sin cifrar. Actualizaciones de por vida. El sistema de Hooks. Plugins reales en producción de los que aprender. Licencia de pago único: sin suscripciones, sin tarifas por suscriptor, sin secuestro de namespaces.

Comprar Licencia Extendida — $199 Volver a la landing para desarrolladores

Ejecute su email marketing en su propio servidor, en sus propios términos

Únase a miles de empresas que tomaron el control de su email marketing con código fuente completo, sin tarifas recurrentes y envíos ilimitados. Licencia de pago único de $80, actualizaciones de por vida.

Obtener AcelleMail — $80 pago único

Get the AcelleMail newsletter

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