Frumbik SMTP

=== Frumbik SMTP ===
Contributors: frumbik
Tags: smtp, email, mailer, email log, sendgrid, mailgun, postmark, brevo, sparkpost
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Professional SMTP mailer for WordPress with email logging, multiple provider support, multi-connection routing, email queue, and a modern React admin interface.

== Description ==

Frumbik SMTP replaces the default WordPress wp_mail() function with a properly authenticated SMTP or API-based connection, ensuring reliable email delivery through your preferred provider. Unlike other mailer plugins, Frumbik SMTP ships with enterprise-grade features like multi-connection failover, intelligent routing rules, an asynchronous email queue, and a security scoring dashboard — all wrapped in a beautiful React-powered admin interface.

= Supported Providers =

Frumbik SMTP works with every major email provider out of the box:

  • Custom SMTP — Connect to any SMTP server with full TLS/SSL support
  • Gmail / Google Workspace — Use your Gmail or Workspace account via SMTP
  • Microsoft Outlook / Office 365 — Native SMTP support for Outlook accounts
  • Amazon SES — High-volume sending via the Amazon Simple Email Service
  • SendGrid — Transactional email delivery through the SendGrid API
  • Mailgun — Reliable delivery via the Mailgun API
  • Postmark — Lightning-fast transactional email through Postmark
  • Brevo (formerly Sendinblue) — Full API integration with Brevo
  • SparkPost — Enterprise-grade delivery through SparkPost

= Core Features =

  • SMTP & API Delivery — Send emails via SMTP or native API integrations depending on the provider
  • AES-256-CBC Encryption — All stored credentials are encrypted at rest using WordPress security keys
  • Comprehensive Email Logging — Every outgoing email is logged with status, headers, timestamps, and optional body storage
  • Log Search & Filtering — Search logs by recipient, subject, status, date range, or source plugin
  • Email Resend — Resend any logged email with one click directly from the log viewer
  • Source Detection — Automatically identifies which plugin or theme triggered each email
  • One-Click Test Email — Verify your configuration works before relying on it
  • Setup Wizard — Guided first-run wizard that walks you through configuration step by step
  • wp-config.php Constants — Define credentials in wp-config.php for enhanced security in version-controlled environments

= Multi-Connection & Routing =

  • Multiple Connections — Configure several mail providers simultaneously
  • Automatic Failover — If one provider fails, Frumbik SMTP automatically tries the next configured connection
  • Routing Rules — Route emails to different providers based on recipient address, domain, subject, or sending plugin
  • Connection Health Monitoring — Track the health and success rate of each connection

= Email Queue =

  • Asynchronous Sending — Queue emails for background delivery via WP-Cron instead of sending synchronously during page loads
  • Retry with Exponential Backoff — Failed emails are automatically retried with configurable retry strategies
  • Queue Dashboard — Monitor queued, processing, completed, and failed emails in real time
  • Batch Processing — Process queued emails in configurable batch sizes to stay within server limits

= Notifications =

  • Failure Alerts — Get notified immediately when emails fail to send
  • Multiple Channels — Receive alerts via Email, Slack, Discord, or Telegram
  • Notification History — Review past notifications and their delivery status

= Import / Export =

  • Configuration Export — Export your complete settings, connections, and routing rules as a JSON file
  • Configuration Import — Import a previously exported configuration to replicate your setup on another site
  • Multisite Ready — Import and export work across multisite network sites

= Security =

  • Security Score Dashboard — A real-time security posture score with actionable recommendations
  • Rate Limiting — Built-in rate limiting on all REST API endpoints to prevent abuse
  • Fine-Grained Capabilities — Six custom WordPress capabilities for granular role-based access control
  • Input Sanitization — Every user input is sanitized and validated before processing
  • Audit Logging — Track configuration changes with a full audit trail

= Modern Admin Interface =

  • React-Powered SPA — A fast, responsive single-page application for all plugin management
  • Real-Time Dashboard — Email statistics, delivery charts, and system health at a glance
  • Responsive Design — Works beautifully on desktop, tablet, and mobile screens
  • Accessible — Built with WordPress accessibility standards in mind

= Multisite Compatible =

  • Network-Wide or Per-Site — Use a shared network configuration or let each site manage its own settings
  • Network Admin Panel — Manage multisite settings from the network admin area

= Developer Friendly =

  • Hooks & Filters — Extensive action and filter hooks for customization
  • IoC Container — Service-provider architecture with a fully featured dependency injection container
  • PSR-4 Autoloading — Clean, namespaced codebase loaded via Composer
  • Extensible Providers — Add custom mail providers by implementing a single interface
  • REST API — Full REST API for headless or programmatic management

== Installation ==

= Automatic Installation =

  1. Go to Plugins > Add New in your WordPress admin.
  2. Search for Frumbik SMTP.
  3. Click Install Now and then Activate.
  4. Follow the setup wizard to configure your mail provider.

= Manual Installation =

  1. Download the plugin ZIP file from WordPress.org.
  2. Go to Plugins > Add New > Upload Plugin in your WordPress admin.
  3. Select the downloaded ZIP file and click Install Now.
  4. Activate the plugin.
  5. Navigate to Frumbik SMTP in the admin sidebar to begin setup.

= Manual FTP Installation =

  1. Download and extract the plugin ZIP file.
  2. Upload the frumbik-smtp folder to /wp-content/plugins/.
  3. Activate the plugin through the Plugins screen in WordPress.
  4. Go to Frumbik SMTP in the admin menu to configure your settings.

= Configuration via wp-config.php =

For enhanced security, you can define SMTP credentials as constants in your wp-config.php file:

define( 'FRUMBIK_SMTP_HOST', 'smtp.example.com' ); define( 'FRUMBIK_SMTP_PORT', 587 ); define( 'FRUMBIK_SMTP_USERNAME', 'your-username' ); define( 'FRUMBIK_SMTP_PASSWORD', 'your-password' ); define( 'FRUMBIK_SMTP_ENCRYPTION', 'tls' ); define( 'FRUMBIK_SMTP_FROM_EMAIL', 'you@example.com' ); define( 'FRUMBIK_SMTP_FROM_NAME', 'Your Site Name' );

Constants take priority over settings stored in the database.

== Frequently Asked Questions ==

= Does this plugin work with shared hosting? =

Yes. Frumbik SMTP works with any hosting environment that supports PHP 7.4 or higher and allows outbound SMTP or HTTP connections. Most shared hosts meet these requirements.

= Will this plugin override emails sent by other plugins? =

Yes. Frumbik SMTP hooks into the WordPress wp_mail() function, so all emails sent by WordPress core, themes, and plugins are routed through your configured provider. This ensures consistent delivery for contact form submissions, WooCommerce receipts, membership emails, and more.

= How do I know if my emails are being delivered? =

Use the built-in Send Test Email feature to verify your configuration. After that, all outgoing emails are logged in the Email Log section where you can see the delivery status (sent, failed, queued) for every message.

= Are my SMTP credentials stored securely? =

Yes. All sensitive credentials are encrypted using AES-256-CBC encryption before being stored in the database. The encryption keys are derived from your WordPress security keys in wp-config.php. For maximum security, you can also define credentials directly as constants in wp-config.php so they never touch the database.

= Can I use multiple email providers at the same time? =

Yes. Frumbik SMTP supports multiple simultaneous connections. You can configure a primary provider and one or more fallback connections. If the primary provider fails, the plugin automatically tries the next connection in your failover chain.

= How do routing rules work? =

Routing rules let you send different emails through different providers based on conditions like recipient email address, recipient domain, email subject, or the plugin that triggered the email. For example, you could route WooCommerce order emails through SendGrid while sending newsletter-related emails through Mailgun.

= What happens if an email fails to send? =

When an email fails, Frumbik SMTP can automatically retry it using the built-in email queue with exponential backoff. You can also configure failure notifications to be alerted instantly via Email, Slack, Discord, or Telegram. Failed emails are always logged so you can investigate and resend them manually if needed.

= Does the email queue work with WP-Cron? =

Yes. The email queue is powered by WP-Cron. Queued emails are processed in configurable batch sizes at regular intervals. For high-volume sites, we recommend setting up a real server-side cron job that triggers wp-cron.php at your desired frequency.

= Can I export and import my settings? =

Yes. The Import/Export feature lets you export your complete configuration (settings, connections, routing rules) as a JSON file. You can then import this file on another WordPress site to replicate your setup instantly. Sensitive credentials are included in the export, so store the file securely.

= Is this plugin compatible with WordPress Multisite? =

Yes. Frumbik SMTP fully supports WordPress Multisite. You can configure it at the network level for all sites or allow individual sites to manage their own email settings.

= Does this plugin support sending via API instead of SMTP? =

Yes. Providers like SendGrid, Mailgun, Postmark, Brevo, and SparkPost use their native HTTP APIs for sending. This is often faster and more reliable than SMTP because it avoids socket-level connection issues.

= How do I set up Slack or Discord notifications? =

Go to Frumbik SMTP > Notifications in your admin panel. Select the channel you want (Slack, Discord, Telegram, or Email), provide the required webhook URL or credentials, and choose which events should trigger notifications.

= What is the Security Score? =

The Security Score is a real-time assessment of your plugin configuration’s security posture. It checks factors like whether encryption is enabled, if credentials are stored in wp-config.php, whether rate limiting is active, and more. Each recommendation includes a fix action to help you improve your score.

= Where can I get support? =

For support, please visit the WordPress.org support forum or our website at frumbik.com.

== Screenshots ==

  1. Dashboard — Overview of email statistics, delivery success rate, recent activity, and system health at a glance.
  2. SMTP Settings — Configure your mail provider with the guided setup form and presets for all major providers.
  3. Email Log — Browse, search, and filter all outgoing emails with delivery status, timestamps, and source detection.
  4. Email Log Detail — View the full detail of any logged email including headers, body preview, and delivery metadata.
  5. Connections Manager — Manage multiple mail provider connections with health status indicators and failover ordering.
  6. Routing Rules — Create conditional rules to route emails to different providers based on recipient, domain, subject, or source.
  7. Email Queue — Monitor queued emails with real-time status updates, retry controls, and batch processing options.
  8. Notifications — Configure failure alerts via Email, Slack, Discord, or Telegram with per-channel settings.
  9. Import / Export — Export your complete configuration as JSON or import settings from another site.
  10. Security Score — View your security posture score with actionable recommendations to harden your configuration.
  11. Setup Wizard — Step-by-step guided configuration wizard for first-time setup.
  12. Test Email — Send a test email to verify your SMTP configuration is working correctly.

== Changelog ==

= 1.0.0 – 2026-03-30 =

Initial Release

Frumbik SMTP launches with a comprehensive feature set for professional WordPress email delivery.

  • Core SMTP Engine
  • Custom SMTP mailer replacing default wp_mail() via phpmailer_init hook
  • AES-256-CBC encryption for all stored credentials using WordPress security keys
  • Support for TLS and SSL encryption protocols
  • SMTP authentication with username/password
  • Configurable From Email and From Name with force-override options
  • Return-Path header support for bounce handling
  • wp-config.php constant support for credentials and settings
  • Mail Providers
  • Custom SMTP server support (any provider)
  • SendGrid API integration
  • Mailgun API integration
  • Postmark API integration
  • Brevo (Sendinblue) API integration
  • SparkPost API integration
  • Gmail / Google Workspace SMTP presets
  • Outlook / Office 365 SMTP presets
  • Amazon SES SMTP presets
  • Extensible provider architecture via MailProviderInterface
  • Email Logging
  • Comprehensive logging of all outgoing emails
  • Logged fields: to, cc, bcc, subject, body (optional), headers, attachments, status, error message
  • Automatic source detection (identifies the plugin or theme that triggered each email)
  • Advanced search and filtering by status, date range, recipient, and subject
  • One-click email resend from the log viewer
  • Configurable log retention with automatic cleanup via daily cron
  • Bulk delete and export capabilities
  • Setup Wizard
  • Guided first-run configuration wizard
  • Provider selection with pre-filled settings
  • Connection test step with real-time feedback
  • Automatic redirect after plugin activation
  • Dashboard
  • Real-time email statistics (sent, failed, queued counts)
  • Delivery success rate percentage
  • Recent email activity feed
  • System health indicators
  • Failure Notifications
  • Email notification channel
  • Slack webhook integration
  • Discord webhook integration
  • Telegram bot integration
  • Configurable notification triggers and thresholds
  • Notification history with delivery status tracking
  • Multi-Connection Support
  • Multiple simultaneous mail provider connections
  • Automatic failover to backup connections on send failure
  • Connection health monitoring and success rate tracking
  • Per-connection configuration and status management
  • Routing Rules
  • Conditional email routing based on recipient address
  • Routing by recipient domain
  • Routing by email subject pattern
  • Routing by source plugin
  • Rule priority ordering
  • Fallback connection when no rules match
  • Email Queue
  • Asynchronous email delivery via WP-Cron
  • Configurable batch processing size
  • Exponential backoff retry strategy for failed emails
  • Maximum retry limit configuration
  • Queue dashboard with real-time status monitoring
  • Manual queue flush and individual email retry
  • Import / Export
  • Full configuration export as JSON (settings, connections, routing rules)
  • Configuration import with validation
  • Selective import options
  • Multisite-compatible import/export
  • Security
  • Security posture scoring with actionable recommendations
  • REST API rate limiting to prevent abuse
  • Six custom WordPress capabilities for role-based access control
  • Comprehensive input sanitization and validation
  • Audit logging for configuration changes
  • Nonce verification on all admin actions
  • Admin Interface
  • Modern React single-page application
  • Real-time dashboard with statistics and charts
  • Responsive design for all screen sizes
  • Accessible UI following WordPress accessibility guidelines
  • Localized with full i18n support via text domain
  • Multisite
  • Full WordPress Multisite support
  • Network-level or per-site configuration
  • Network admin management panel
  • Developer Features
  • IoC container with service provider architecture
  • Full REST API for all plugin functionality
  • PSR-4 autoloading via Composer
  • Extensive action and filter hooks
  • Database migration system for schema management
  • Singleton pattern for core services

== Upgrade Notice ==

= 1.0.0 =
Initial release of Frumbik SMTP. Install to replace the default WordPress mailer with a professional SMTP solution featuring email logging, multiple providers, and a modern admin interface.

Scroll to Top