# mageplaza/magento-2-smtp architecture

> Architecture diagram of the GitHub repository mageplaza/magento-2-smtp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mageplaza/magento-2-smtp
- Repository: https://github.com/mageplaza/magento-2-smtp

## Overview

Mageplaza SMTP is a Magento 2 extension for configuring SMTP delivery, testing and debugging email, and integrating store events with AVADA Email Marketing and abandoned-cart recovery. The main flow is Magento email generation through the extension’s transport to an SMTP service, with email records available for admin review and resend. Marketing and cart-recovery features form distinct branches. Several connections are documented in the README or SOURCE INDEX; unsampled controllers and event wiring are not assumed to call one another.

Main entry points: [`Helper/EmailMarketing.php`](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/EmailMarketing.php) (Marketing integration), [`Mail/Transport.php`](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Transport.php) (SMTP transport), [`Mail/Rse/Mail.php`](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Rse/Mail.php) (SMTP mail), [`Model/AbandonedCartToken.php`](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/AbandonedCartToken.php) (Recovery token)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["SMTP delivery"]
  node_transport_builder["Mail builder"]
  node_smtp_mail["SMTP mail<br/>[Mail.php]"]
  node_smtp_transport["SMTP transport<br/>[Transport.php]"]
  node_smtp_config["SMTP configuration<br/>[Data.php]"]
end

subgraph group_admin["Admin operations"]
  node_test_connection["Connection test<br/>[TestConnection.php]"]
  node_email_logs["Email log management"]
  node_log_model[("Email log records<br/>[Log.php]")]
  node_log_storage[("Log resource<br/>[Log.php]")]
  node_log_cleanup["Scheduled cleanup<br/>[ClearLog.php]"]
end

subgraph group_marketing["Email marketing"]
  node_marketing_helper["Marketing integration<br/>[EmailMarketing.php]"]
  node_marketing_events["Store event handlers"]
  node_subscriber_handler["Subscriber welcome"]
  node_customer_handler["Customer lifecycle"]
  node_order_handler["Order lifecycle<br/>[OrderComplete.php]"]
  node_quote_handler["Quote sync<br/>[SyncQuote.php]"]
  node_proxy["Marketing proxy<br/>[Index.php]"]
end

subgraph group_recovery["Cart recovery"]
  node_cart_events["Cart event handlers"]
  node_cart_helper["Cart email logic<br/>[EmailMarketing.php]"]
  node_cart_token["Recovery token"]
  node_cart_recovery["Recovery endpoint<br/>[Recover.php]"]
  node_cart_admin["Cart admin tools<br/>[View.php]"]
  node_checkout_api["Checkout management"]
end

node_magento(("Magento store"))
node_smtp_service["SMTP server"]
node_admin(("Store administrator"))
node_avada["AVADA service"]

node_magento -.->|"generates email"| node_transport_builder
node_transport_builder -->|"sets sender"| node_smtp_mail
node_smtp_mail -->|"creates transport"| node_smtp_transport
node_smtp_transport -->|"delivers email"| node_smtp_service
node_smtp_config -->|"supplies settings"| node_smtp_mail
node_admin -->|"configures delivery"| node_smtp_config
node_admin -->|"tests settings"| node_test_connection
node_admin -->|"reviews or resends"| node_email_logs
node_smtp_transport -.->|"records email"| node_log_model
node_log_model -->|"persists records"| node_log_storage
node_log_cleanup -->|"cleans expired logs"| node_log_storage
node_marketing_events -.->|"invokes integration"| node_marketing_helper
node_subscriber_handler -->|"handles subscriber"| node_marketing_helper
node_customer_handler -->|"handles customer"| node_marketing_helper
node_order_handler -->|"handles order"| node_marketing_helper
node_quote_handler -->|"syncs quote"| node_marketing_helper
node_proxy -->|"sends proxy request"| node_marketing_helper
node_marketing_helper -->|"sends marketing requests"| node_avada
node_cart_events -.->|"handles cart changes"| node_cart_helper
node_cart_helper -.->|"uses recovery token"| node_cart_token
node_cart_recovery -->|"builds recovery flow"| node_cart_helper
node_cart_recovery -->|"validates token"| node_cart_token
node_cart_admin -->|"uses cart token"| node_cart_token
node_checkout_api -.->|"supports checkout"| node_cart_helper

click node_transport_builder "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Template/TransportBuilder.php"
click node_smtp_mail "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Rse/Mail.php"
click node_smtp_transport "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Transport.php"
click node_smtp_config "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/Data.php"
click node_test_connection "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/Adminhtml/Smtp/TestConnection.php"
click node_email_logs "https://github.com/mageplaza/magento-2-smtp/tree/2.4/Controller/Adminhtml/Smtp"
click node_log_model "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/Log.php"
click node_log_storage "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/ResourceModel/Log.php"
click node_log_cleanup "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Cron/ClearLog.php"
click node_marketing_helper "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/EmailMarketing.php"
click node_marketing_events "https://github.com/mageplaza/magento-2-smtp/tree/2.4/Observer"
click node_subscriber_handler "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Customer/SubscriberSaveCommitAfter.php"
click node_customer_handler "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Customer/CustomerSaveCommitAfter.php"
click node_order_handler "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Order/OrderComplete.php"
click node_quote_handler "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Quote/SyncQuote.php"
click node_proxy "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/Proxy/Index.php"
click node_cart_events "https://github.com/mageplaza/magento-2-smtp/tree/2.4/Observer/Quote"
click node_cart_helper "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/EmailMarketing.php"
click node_cart_token "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/AbandonedCartToken.php"
click node_cart_recovery "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/AbandonedCart/Recover.php"
click node_cart_admin "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/Adminhtml/Smtp/AbandonedCart/View.php"
click node_checkout_api "https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/CheckoutManagement.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_transport_builder,node_smtp_mail,node_smtp_transport,node_smtp_config toneBlue
class node_test_connection,node_email_logs,node_log_model,node_log_storage,node_log_cleanup toneAmber
class node_marketing_helper,node_marketing_events,node_subscriber_handler,node_customer_handler,node_order_handler,node_quote_handler,node_proxy,node_smtp_service toneMint
class node_cart_events,node_cart_helper,node_cart_token,node_cart_recovery,node_cart_admin,node_checkout_api toneRose
class node_magento,node_admin,node_avada toneIndigo
```

## Components

### SMTP delivery

- [Mail builder](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Template/TransportBuilder.php): `Mail/Template/TransportBuilder.php`
- [SMTP mail](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Rse/Mail.php): `Mail/Rse/Mail.php`
- [SMTP transport](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Mail/Transport.php): `Mail/Transport.php`
- [SMTP configuration](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/Data.php): `Helper/Data.php`

### Admin operations

- [Connection test](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/Adminhtml/Smtp/TestConnection.php): `Controller/Adminhtml/Smtp/TestConnection.php`
- [Email log management](https://github.com/mageplaza/magento-2-smtp/tree/2.4/Controller/Adminhtml/Smtp): `Controller/Adminhtml/Smtp`
- [Email log records](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/Log.php): `Model/Log.php`
- [Log resource](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/ResourceModel/Log.php): `Model/ResourceModel/Log.php`
- [Scheduled cleanup](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Cron/ClearLog.php): `Cron/ClearLog.php`

### Email marketing

- [Marketing integration](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/EmailMarketing.php): `Helper/EmailMarketing.php`
- [Store event handlers](https://github.com/mageplaza/magento-2-smtp/tree/2.4/Observer): `Observer`
- [Subscriber welcome](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Customer/SubscriberSaveCommitAfter.php): `Observer/Customer/SubscriberSaveCommitAfter.php`
- [Customer lifecycle](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Customer/CustomerSaveCommitAfter.php): `Observer/Customer/CustomerSaveCommitAfter.php`
- [Order lifecycle](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Order/OrderComplete.php): `Observer/Order/OrderComplete.php`
- [Quote sync](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Observer/Quote/SyncQuote.php): `Observer/Quote/SyncQuote.php`
- [Marketing proxy](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/Proxy/Index.php): `Controller/Proxy/Index.php`

### Cart recovery

- [Cart event handlers](https://github.com/mageplaza/magento-2-smtp/tree/2.4/Observer/Quote): `Observer/Quote`
- [Cart email logic](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Helper/EmailMarketing.php): `Helper/EmailMarketing.php`
- [Recovery token](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/AbandonedCartToken.php): `Model/AbandonedCartToken.php`
- [Recovery endpoint](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/AbandonedCart/Recover.php): `Controller/AbandonedCart/Recover.php`
- [Cart admin tools](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Controller/Adminhtml/Smtp/AbandonedCart/View.php): `Controller/Adminhtml/Smtp/AbandonedCart/View.php`
- [Checkout management](https://github.com/mageplaza/magento-2-smtp/blob/2.4/Model/CheckoutManagement.php): `Model/CheckoutManagement.php`

### Other components

- **Magento store**
- **SMTP server**
- **Store administrator**
- **AVADA service**

## Connections

- Magento store → Mail builder: generates email
- Mail builder → SMTP mail: sets sender (evidence: `Mail/Template/TransportBuilder.php`)
- SMTP mail → SMTP transport: creates transport (evidence: `Mail/Rse/Mail.php`)
- SMTP transport → SMTP server: delivers email
- SMTP configuration → SMTP mail: supplies settings (evidence: `Mail/Rse/Mail.php`)
- Store administrator → SMTP configuration: configures delivery
- Store administrator → Connection test: tests settings
- Store administrator → Email log management: reviews or resends
- SMTP transport → Email log records: records email (evidence: `Mail/Transport.php`)
- Email log records → Log resource: persists records (evidence: `Model/Log.php`)
- Scheduled cleanup → Log resource: cleans expired logs (evidence: `Cron/ClearLog.php`)
- Store event handlers → Marketing integration: invokes integration (evidence: `Observer/Order/OrderComplete.php`)
- Subscriber welcome → Marketing integration: handles subscriber (evidence: `Observer/Customer/SubscriberSaveCommitAfter.php`)
- Customer lifecycle → Marketing integration: handles customer
- Order lifecycle → Marketing integration: handles order (evidence: `Observer/Order/OrderComplete.php`)
- Quote sync → Marketing integration: syncs quote (evidence: `Observer/Quote/SyncQuote.php`)
- Marketing proxy → Marketing integration: sends proxy request (evidence: `Controller/Proxy/Index.php`)
- Marketing integration → AVADA service: sends marketing requests (evidence: `Helper/EmailMarketing.php`)
- Cart event handlers → Cart email logic: handles cart changes (evidence: `Observer/Quote/SyncQuote.php`)
- Cart email logic → Recovery token: uses recovery token
- Recovery endpoint → Cart email logic: builds recovery flow (evidence: `Controller/AbandonedCart/Recover.php`)
- Recovery endpoint → Recovery token: validates token (evidence: `Controller/AbandonedCart/Recover.php`)
- Cart admin tools → Recovery token: uses cart token (evidence: `Controller/Adminhtml/Smtp/AbandonedCart/View.php`)
- Checkout management → Cart email logic: supports checkout
