SMTP
v1.2.0
SMTP
- Mises à jour et support inclus pendant 12 mois
- Clé de licence livrée immédiatement par email
- Garantie satisfait ou remboursé 30 jours
- Documentation complète incluse
- Installation prête pour Composer
SMTP
Remplacez le transport mail natif de Magento par une couche SMTP configurable, compatible avec tous les fournisseurs courants, qui journalise chaque email sortant et protège vos environnements de staging des envois accidentels.
Wimakeit_Smtp intercepte chaque email sortant via un plugin sur TransportInterfaceFactory, le route via le serveur SMTP ou le provider API configuré, conserve un log structuré de ce qui a été envoyé (et de ce qui a échoué), et permet de tout rediriger vers une boîte de debug pendant les tests.
À qui ça s'adresse
- Marchands dont l'hébergement interdit le
sendmaillocal (la plupart des hébergements Magento managés) - Boutiques utilisant un provider transactionnel (Gmail, Office 365, SendGrid, Mailgun, Brevo, Postmark, SES, Mailtrap, OVH, etc.)
- Agences avec plusieurs environnements de preprod qui ne doivent jamais envoyer d'email à de vrais clients par accident
- Équipes compliance qui ont besoin d'un log de chaque email envoyé par Magento, avec corps, destinataires et statut
Bénéfices clés
- Presets de provider en un clic — un dropdown Preset auto-remplit host, port, encryption et authentication pour 13 fournisseurs (Gmail, Google Workspace, Office 365, iCloud, Yahoo, Zoho, OVH, SendGrid, Mailgun, Brevo, Postmark, Amazon SES, Mailtrap). Vous ne saisissez que les identifiants.
- Multi-provider, multi-store — Generic SMTP plus des transports dédiés pour SendGrid, Mailgun, Amazon SES, Brevo, Postmark et Mailtrap. Chaque réglage est par store view.
- Secrets chiffrés — passwords et clés API stockés chiffrés via le backend model
Encryptedde Magento, déchiffrés à la volée à l'envoi. - Debug redirect — un seul switch et tous les emails sortants sont redirigés vers une liste d'adresses de test, avec le destinataire original injecté dans le sujet. Indispensable en staging.
- Email log complet — chaque envoi (succès ou échec) atterrit dans
wimakeit_smtp_email_logavec destinataires, expéditeur, sujet, provider, statut et message d'erreur. Capture optionnelle du corps (HTML + texte, 64 Ko max) derrière un toggle pour la conformité RGPD. - Grille admin + détail + renvoi — listez, filtrez, exportez en CSV/XML, visualisez le HTML d'origine dans un iframe sandboxé, et renvoyez les messages en échec en masse ou un par un.
- Test depuis le backend ou en CLI — bouton "Send Test Email" dans la page de configuration, plus
bin/magento wimakeit:smtp:test --to=<email>côté serveur. - Rétention automatique — un cron quotidien purge les entrées au-delà de la rétention configurée (30 jours par défaut).
Compatibilité
- Magento 2.4.6+ / équivalent Mage-OS
- PHP 8.1, 8.2, 8.3
- Nécessite
wimakeit/module-core^3.0 - Nécessite
laminas/laminas-mail^2.25 (récupéré automatiquement ; requis sur Magento 2.4.7+ où il n'est plus transitive) - Traductions livrées pour l'anglais (en_US), le français (fr_FR), le néerlandais (nl_NL)
Installez ce module via Composer. Assurez-vous que votre auth.json est configuré avec vos identifiants Wimakeit.
$ 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
- Version
- v1.2.0
- Licence
- Abonnement annuel
- Support
- 12 mois
- Dernière mise à jour
- 5 juin 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ä
- Non compatible
- Package
-
wimakeit/module-smtp
Vérifier la compatibilité
Indiquez votre stack pour vérifier la compatibilité du module.
Compatibilité 4
Tarification & licence 4
vendor/wimakeit/ après composer require, donc vous pouvez le lire, l'auditer, et le patcher localement pour votre propre installation Magento. Vous ne pouvez PAS le redistribuer, le sous-licencier, le publier sur un registre Composer public, ou le revendre. 1 licence = 1 domaine production + 1 domaine staging/dev (voir les Conditions Générales pour l'EULA complet). Les modules Wimakeit ne sont PAS sur le packagist.org public — ils sont distribués exclusivement via le registre Composer privé packages.wimakeit.be. Installation & mises à jour 6
composer require wimakeit/module-smtp:^1.1.0, puis bin/magento setup:upgrade, bin/magento setup:di:compile, et enfin bin/magento cache:flush. L'onglet « Installation » de cette page liste chaque étape de configuration (ACLs, crons, valeurs par défaut) — un déploiement prend quelques minutes, pas des heures. Besoin d'aide ? Wimakeit propose des prestations d'installation Magento depuis notre bureau wallon (Presles, entre Charleroi et Namur). auth.json : {"http-basic": {"packages.wimakeit.be": {"username": "VOTRE-EMAIL", "password": "VOTRE-TOKEN"}}}. Étape 3 : enregistrez le repo : composer config repositories.wimakeit composer https://packages.wimakeit.be. Étape 4 : composer require wimakeit/module-smtp:^1.1.0. Dans les pipelines CI/CD, injectez COMPOSER_AUTH en variable d'environnement JSON pour éviter de commiter auth.json. composer require, même code module, même schéma de base — pas de fork à maintenir, pas de changement de licence. composer update reste sûr à l'intérieur d'une version majeure. app/design/frontend/{VotreVendor}/{theme}/Wimakeit_{Module}/templates/ en respectant le même chemin relatif. Blocks, ViewModels et Helpers s'override via DI preference dans votre propre module custom — déclarez <preference for="Wimakeit\…\OriginalClass" type="VotreVendor\Override\Class" /> dans etc/di.xml. Le XML layout s'étend (préféré) ou s'override de manière standard Magento. Les modules Wimakeit n'utilisent jamais le keyword final sur les classes que vous pourriez raisonnablement vouloir override — surcharger est un scénario de premier ordre, pas un hack. Support & sécurité 3
contact@wimakeit.com avec le nom du module, sa version, votre version Magento/Mage-OS et les étapes pour reproduire. Les correctifs sont livrés dans le prochain patch. Le support Wimakeit répond en français, anglais et néerlandais en jours ouvrables (horaires CET). contact@wimakeit.com avec le préfixe [SECURITY] dans l'objet — précisez le module, la version et les étapes de reproduction. Accusé de réception en jours ouvrables, mention dans le Changelog sur souhait du déclarant. Wimakeit est une SRL belge (société à responsabilité limitée) soumise au droit belge et européen sur la vie privée et la divulgation responsable. À propos de Wimakeit 1
Quelque chose n'est pas couvert par la FAQ ?
Signalez un bug ou posez une question — le formulaire est pré-rempli avec ce 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).
Vous avez trouvé un bug ? Faites-nous-en part.
Un court formulaire s'ouvre dans un nouvel onglet — le nom du module et votre langue sont déjà pré-remplis. Décrivez ce que vous avez tenté, ce qui n'a pas fonctionné, et nous vous répondrons sous un jour ouvré.
Signaler un bug pour SMTPBesoin d'aide ?
Notre équipe est disponible pour vous accompagner dans l'intégration.