sympress / mailer

v0.1.3 2026-10-03 15:18 UTC

Requires

• php: ^8.5
• ext-json: *
• ext-openssl: *
• symfony/http-client: ^8.1
• symfony/mailer: ^8.1
• symfony/mime: ^8.1
• sympress/assets: ^1.2.1
• sympress/kernel: ^1.1.1

Requires (Dev)

• brain/monkey: ^2
• friendsofphp/php-cs-fixer: ^3.94
• johnpbloch/wordpress: ^7.1
• mockery/mockery: ^1.6
• php-stubs/wordpress-stubs: >=7.0@stable
• symfony/var-dumper: ^8.1
• sympress/qa: ^0.1.2

Suggests

• symfony/amazon-mailer: Adds Amazon SES API and SMTP DSN support.
• symfony/brevo-mailer: Adds Brevo API and SMTP DSN support.
• symfony/google-mailer: Adds Gmail SMTP DSN support for development and small sites.
• symfony/mailer-send-mailer: Adds MailerSend API and SMTP DSN support.
• symfony/mailgun-mailer: Adds Mailgun API and SMTP DSN support.
• symfony/mailjet-mailer: Adds Mailjet API and SMTP DSN support.
• symfony/mailtrap-mailer: Adds Mailtrap live and sandbox DSN support.
• symfony/microsoft-graph-mailer: Adds Microsoft Graph DSN support for Outlook and Microsoft 365.
• symfony/postmark-mailer: Adds Postmark API and SMTP DSN support.
• symfony/resend-mailer: Adds Resend API and SMTP DSN support.
• symfony/sendgrid-mailer: Adds SendGrid API and SMTP DSN support.

GPL-2.0-or-later

• Brian Schäffner

Published on Packagist.org on 2026-10-03 15:20 UTC

README

Core Symfony Mailer powered WordPress plugin for the SymPress kernel.

Installation

Install the package through Composer in a SymPress WordPress project:

composer require sympress/mailer

The SymPress kernel discovers the SymPress\Mailer\MailerBundle bundle from composer.json and loads mailer/mailer.php as the WordPress plugin entry.

Feature Surface

• Replaces wp_mail() through the WordPress pre_wp_mail filter.
• Uses symfony/mailer transports and DSNs, including SMTP, sendmail, native mail, failover DSNs and optional Symfony provider bridges.
• Supports one primary connection, From email/name policy, return-path handling, TLS settings and test email delivery.
• Stores settings in the shared sympress_mailer_settings option so extension packages can add their own feature state.
• Exposes SymPress\Mailer\Application\MailerInterface and SymPress\Mailer\Message\EmailBodyProcessorInterface as extension points.

Pro Extension

sympress/mailer-pro lives in packages/mailer-pro and builds on this package like a premium extension. The Pro package replaces MailerInterface with a logging/routing/queue-aware implementation and replaces the body processor with open/click tracking.

Provider Strategy

The core package depends on symfony/mailer and accepts any valid Symfony Mailer DSN. Dedicated providers such as SendGrid, Mailgun, Postmark, Brevo, Amazon SES, Gmail, Microsoft Graph, Mailjet, MailerSend, Mailtrap and Resend are enabled by installing the matching Symfony bridge listed in composer.json suggestions.

Assets

Admin assets are built with Symfony Webpack Encore:

npm ci
npm run build

The PHP asset provider loads assets/entrypoints.json when it exists and falls back to the legacy assets/admin.css and assets/admin.js files until a build is available.

Documentation

• Documentation index
• Configuration
• Development

Quality Checks

composer test
composer static-analysis
composer cs
npm run typecheck