SMTP
v1.2.0
SMTP
- Updates and support included for 12 months
- License key delivered immediately by email
- 30-day money-back guarantee
- Full documentation included
- Composer-ready installation
SMTP
Vervang het ingebouwde mailtransport van Magento door een configureerbare SMTP-laag die elke gangbare provider ondersteunt, elke uitgaande e-mail logt en uw staging-omgevingen beschermt tegen ongewenste verzending.
Wimakeit_Smtp onderschept elke uitgaande e-mail via een plugin op TransportInterfaceFactory, stuurt hem door de geconfigureerde SMTP-server of API-provider, bewaart een gestructureerd log van wat verzonden is (en van wat faalde), en laat u tijdens het testen alles omleiden naar een debug-inbox.
Voor wie
- Handelaars wiens hosting lokale
sendmailverbiedt (de meeste managed Magento-hosters) - Winkels met een transactionele provider (Gmail, Office 365, SendGrid, Mailgun, Brevo, Postmark, SES, Mailtrap, OVH, ...)
- Bureaus met meerdere preprod-omgevingen die nooit per ongeluk mail naar echte klanten mogen sturen
- Compliance-teams die een log nodig hebben van elke e-mail die Magento heeft verzonden, met body, geadresseerden en status
Belangrijkste voordelen
- Provider-presets in één klik — een Preset-dropdown vult host, port, encryption en authentication automatisch in voor 13 gangbare providers (Gmail, Google Workspace, Office 365, iCloud, Yahoo, Zoho, OVH, SendGrid, Mailgun, Brevo, Postmark, Amazon SES, Mailtrap). U vult enkel username en password in.
- Multi-provider, multi-store — Generic SMTP plus dedicated transporten voor SendGrid, Mailgun, Amazon SES, Brevo, Postmark en Mailtrap. Elke instelling is per store view.
- Versleutelde secrets — passwords en API keys versleuteld opgeslagen via het
Encryptedbackend model van Magento, on-the-fly ontsleuteld bij verzending. - Debug redirect-modus — één switch en alle uitgaande mail wordt omgeleid naar een lijst test-adressen, met de oorspronkelijke geadresseerde in het onderwerp. Onmisbaar op staging.
- Volledig email log — elke verzending (succes of fout) belandt in
wimakeit_smtp_email_logmet geadresseerden, afzender, onderwerp, provider, status en foutmelding. Optionele body-capture (HTML + tekst, 64 KB max) achter een toggle voor GDPR. - Admin grid + detail + opnieuw verzenden — lijst, filter, export naar CSV/XML, originele HTML in sandboxed iframe, en gefaalde berichten opnieuw verzenden in bulk of één per één.
- Test vanuit admin of CLI — "Send Test Email"-knop in de configuratiepagina, plus
bin/magento wimakeit:smtp:test --to=<email>server-side. - Automatische log-retentie — dagelijkse cron-job verwijdert entries voorbij de geconfigureerde retentie (standaard 30 dagen).
Compatibiliteit
- Magento 2.4.6+ / Mage-OS equivalent
- PHP 8.1, 8.2, 8.3
- Vereist
wimakeit/module-core^3.0 - Vereist
laminas/laminas-mail^2.25 (wordt automatisch opgehaald; vereist op Magento 2.4.7+ waar de transitive dep verdwenen is) - Vertalingen meegeleverd voor Engels (en_US), Frans (fr_FR), Nederlands (nl_NL)
Installeer deze module via Composer. Zorg ervoor dat uw auth.json is geconfigureerd met uw Wimakeit-inloggegevens.
$ composer require wimakeit/module-smtp:^1.2.0
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile
Installation notes
The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.
Required dependencies
wimakeit/module-core^3.0laminas/laminas-mail^2.25 (Magento 2.4.7+ dropped this as a transitive dep; this module pulls it back explicitly)
Both are pulled automatically by Composer as long as the Wimakeit registry is declared in your project's composer.json.
ACL permissions
After installation, the following ACL resources are available under System → Permissions → User Roles:
| Resource | Default |
|---|---|
Wimakeit_Smtp::config (edit SMTP configuration) | granted to Administrator role only |
Wimakeit_Smtp::config_test (use Send Test Email button) | granted to Administrator role only |
Wimakeit_Smtp::email_log (parent: System → SMTP → Email Log) | granted to Administrator role only |
Wimakeit_Smtp::email_log_view (view email log entries) | granted to Administrator role only |
Wimakeit_Smtp::email_log_delete (delete email log entries) | granted to Administrator role only |
Wimakeit_Smtp::email_log_resend (resend logged emails) | granted to Administrator role only |
Assign them to your DevOps / support roles as needed.
Configuration
The module is disabled by default — Magento keeps using its native Sendmail transport until you flip the switch. Go to Stores → Configuration → WiMakeIT → SMTP.
General Settings
| Setting | Default |
|---|---|
| Enable SMTP | No — flip to Yes to activate the module |
| Provider | Generic SMTP |
| From Email | (empty) |
| From Name | (empty) |
Available providers: Generic SMTP, SendGrid, Mailgun, Amazon SES, Brevo, Postmark, Mailtrap.
Generic SMTP Settings
| Setting | Default |
|---|---|
| Preset | (none — pick to auto-fill host/port/encryption/auth) |
| Host | (empty) |
| Port | 587 |
| Username | (empty) |
| Password | (empty, stored encrypted) |
| Encryption | TLS (STARTTLS) |
| Authentication | LOGIN |
The Preset dropdown covers 13 providers (Gmail, Google Workspace, Office 365, iCloud, Yahoo, Zoho, OVH, SendGrid SMTP relay, Mailgun SMTP relay, Brevo SMTP, Postmark SMTP, Amazon SES SMTP, Mailtrap). Selecting one auto-fills host, port, encryption and authentication. You still need to enter username and password.
API Provider Settings
Visible only when the matching provider is selected. All keys are stored encrypted.
| Field | Default |
|---|---|
| SendGrid API Key | (empty) |
| Mailgun API Key + Domain | (empty) |
SES Region (e.g. eu-west-1), Access Key ID, Secret Access Key | (empty) |
| Brevo API Key | (empty) |
| Postmark Server Token | (empty) |
| Mailtrap API Token + Inbox ID | (empty) |
Debug Mode
| Setting | Default |
|---|---|
| Enable Debug Redirect | No |
| Redirect To | (empty — one email per line or comma-separated) |
When enabled, all outgoing emails are rerouted to these addresses, with subject prefix [DEBUG redirected from <original>].
Email Logging
| Setting | Default |
|---|---|
| Enable Email Logging | Yes |
| Log Retention (days) | 30 |
| Log Email Body | No — required to enable Resend; disable to limit DB size or for privacy compliance |
Test
A "Send Test Email" button at the bottom of the configuration page sends a live message to the currently logged-in admin user's email address.
Cron jobs (registered automatically)
| Job | Schedule |
|---|---|
wimakeit_smtp_purge_logs (delete log entries past retention) | daily at 03:30 |
No setup needed — just make sure Magento cron is running.
CLI commands
# Send a test email through the current configuration
bin/magento wimakeit:smtp:test --to=you@example.com
# Test against a specific store
bin/magento wimakeit:smtp:test --to=you@example.com --store=1
- Versie
- v1.2.0
- Licentie
- Jaarabonnement
- Ondersteuning
- 12 maanden
- Last updated
- 5 jun. 2026
- Magento
- Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
- PHP
- PHP 8.1 PHP 8.2 PHP 8.3
- Hyvä
- Niet compatibel
- Pakket
-
wimakeit/module-smtp
Compatibility checker
Pick your stack to see if this module fits.
Compatibiliteit 4
Prijs & licentie 4
composer require in vendor/wimakeit/ terecht; u kan ze lezen, auditen en lokaal patchen voor uw eigen Magento-installatie. U mag de code NIET herverspreiden, sublicentiëren, op een publiek Composer-register publiceren of doorverkopen. Eén licentie = één productiedomein + één staging/dev-domein (zie de algemene voorwaarden voor de volledige EULA). Wimakeit-modules staan NIET op het publieke packagist.org — ze worden uitsluitend verspreid via het private Composer-register packages.wimakeit.be. Installatie & updates 6
composer require wimakeit/module-smtp:^1.1.0 uit, daarna bin/magento setup:upgrade, bin/magento setup:di:compile en tot slot bin/magento cache:flush. Het tabblad Installation op deze pagina lijst elke configuratiestap (ACL's, crons, defaultwaarden) — een deploy duurt minuten, geen uren. Hulp nodig? Wimakeit biedt Magento-installatiediensten vanuit ons Waalse kantoor (Presles, tussen Charleroi en Namen). auth.json toe: {"http-basic": {"packages.wimakeit.be": {"username": "UW-E-MAIL", "password": "UW-TOKEN"}}}. Stap 3: registreer het repo: composer config repositories.wimakeit composer https://packages.wimakeit.be. Stap 4: composer require wimakeit/module-smtp:^1.1.0. In CI/CD-pipelines injecteert u COMPOSER_AUTH als JSON-environment-variabele in plaats van auth.json te commit'en. composer require, zelfde modulecode, zelfde databaseschema — geen fork om te onderhouden, geen licentiewijziging. composer update blijft veilig binnen een major. app/design/frontend/{UwVendor}/{theme}/Wimakeit_{Module}/templates/ met hetzelfde relatieve pad. Blocks, ViewModels en Helpers worden overschreven via DI-preference in uw eigen custom module — declareer <preference for="Wimakeit\…\OriginalClass" type="UwVendor\Override\Class" /> in etc/di.xml. Layout-XML wordt uitgebreid (voorkeur) of overschreven op de standaard Magento-manier. Wimakeit-modules gebruiken nooit het keyword final op klassen die u redelijkerwijs zou willen override — overschrijven is een first-class scenario, geen hack. Support & beveiliging 3
contact@wimakeit.com met modulenaam, versie, Magento/Mage-OS-versie en reproduceringsstappen. Fixes verschijnen in de volgende patch. Wimakeit-support antwoordt in het Nederlands, Frans en Engels op werkdagen (CET-uren). contact@wimakeit.com met het voorvoegsel [SECURITY] in het onderwerp — vermeld de module, versie en reproductiestappen. Bevestiging op werkdagen, vermelding in het Changelog op verzoek. Wimakeit is een Belgische BV (besloten vennootschap) onderworpen aan Belgisch en Europees recht inzake privacy en responsible disclosure. Over Wimakeit 1
Iets gevonden dat niet in de FAQ staat?
Meld een bug of stel een vraag — het formulier is voor-ingevuld met deze module.
Changelog
Categories: Security, Feature, Fix, Perf, Admin, Deps.
[1.1.0] - 2026-05-18
Feature
- New Preset dropdown in Generic SMTP Settings auto-fills host, port, encryption and authentication for 13 common providers: Gmail, Google Workspace, Office 365, iCloud, Yahoo, Zoho, OVH, SendGrid, Mailgun, Brevo, Postmark, Amazon SES, Mailtrap. Username and password remain manual since they are tenant-specific.
Admin
- Preset selection is wired through a dedicated
frontend_model(PresetField) so the auto-fill happens in the config form without a page reload.
[1.0.2] - 2026-05
Fix
- SMTP password is now decrypted before being sent to the server. Previously the encrypted blob (
0:3:...) was forwarded verbatim, breaking every authentication with5.7.139 Authentication unsuccessfulon Office 365 (and silent rejection elsewhere). - API keys for SendGrid, Mailgun, Brevo, Postmark and Mailtrap are now decrypted the same way before use.
- The CLI test command no longer falls back to the recipient address as sender when
from_emailis empty — it now falls back to the SMTP authenticated username, matching providers that requireFrom == auth user(Office 365 Basic SMTP, Gmail, etc.).
[1.0.1] - 2026-05
Deps
- Adds explicit dependency on
laminas/laminas-mail^2.25. Magento 2.4.7+ dropped this as a transitive dependency in favour ofsymfony/mailer, which broke the SMTP transport on fresh installs withClass "Laminas\Mail\Message" not found.
[1.0.0] - 2026-05
Feature
- Initial release. SMTP transport override plugging
Magento\Framework\Mail\TransportInterfaceFactoryvia an around plugin, routing all outgoing Magento emails through the configured SMTP server. - Multi-provider support: Generic SMTP, SendGrid, Mailgun, Amazon SES (SMTP relay), Brevo, Postmark, Mailtrap.
- Per-store configuration scope for every setting (enabled, provider, from email/name, SMTP parameters).
- Generic SMTP: host, port, username, password, encryption (TLS/SSL/None), authentication type (LOGIN/PLAIN/CRAM-MD5/None).
- Debug redirect mode that intercepts all outgoing emails and reroutes them to one or more configured addresses, with subject prefix
[DEBUG redirected from <original>]. - Email logging in
wimakeit_smtp_email_log: recipients, sender, subject, provider, status, error message. Body capture optional (HTML + text, truncated to 64 KB). - Admin grid at System → SMTP → Email Log: filters, search, bookmarks, column controls, paging, CSV/XML export, color-coded status, mass delete, mass resend.
- Detail page with metadata and sandboxed
<iframe srcdoc>HTML preview. - Resend rebuilds a raw MIME message from logged body and dispatches via the current transport (requires body logging).
- "Send Test Email" button in admin config sends a live message to the logged-in admin's email.
- CLI command
wimakeit:smtp:test --to=<email> [--store=<id>]for server-side connectivity verification. - Cron
wimakeit_smtp_purge_logsdaily at 03:30 deletes entries past the configured retention period.
Security
- API keys and passwords stored encrypted via
Magento\Config\Model\Config\Backend\Encrypted. - ACL resources:
Wimakeit_Smtp::config,email_log,email_log_view,email_log_delete,email_log_resend,config_test. - HTML preview rendered inside a sandboxed iframe to neutralise any tracking pixels or scripts present in stored bodies.
Admin
- Email template
wimakeit_smtp_test_emailregistered viaemail_templates.xml. - Translations bundled for English (en_US), French (fr_FR), Dutch (nl_NL).
Een bug gevonden? Laat het ons weten.
Een kort formulier opent in een nieuw tabblad — de modulenaam en uw taal zijn al ingevuld. Beschrijf wat u probeerde, wat misging, en wij komen binnen één werkdag bij u terug.
Een bug melden voor SMTPHulp nodig?
Ons team helpt u graag met de integratie.