Reply-To for WP_Mail

Plugin banner

Configure different “Reply-To” addresses by email context with validation, modern tabbed UI, and automatic migration.


Plugin icon

Information

Author:

ROBOTSTXT

Download

Price:

€0.00
Get plugin ZIP file

This ZIP installs like any WordPress plugin. To keep it updated automatically, install the Manager (by ROBOTSTXT) plugin on your site and connect it with the API key from your ROBOTSTXT account.


Requirements

Version:

2.1.2

WordPress:

4.7

–

7.2

PHP >=

5.6

Changelog

2.1.2

Release date: 2026-11-03

Highlights

  • Legacy v1 options no longer wiped on save, and WordPress 7.2 / PHP 8.6 compatibility declared and verified.

Fixed

  • Legacy v1.0.x Reply-To options (wp_mail_replyto_email, wp_mail_replyto_name) were emptied on every settings save, destroying the rollback/migration fallback values; on PHP 8.1+ hosts the same code path logged a sanitize_email() deprecation (found in debug.log review). Root cause: the options were registered in the Settings API group while the settings form no longer posts them, so wp-admin/options.php passed null to update_option() for each of them. Fix: the options are no longer part of the settings group, so their values survive every save and no null ever reaches the sanitizers.

Changed

  • Development tooling updated via composer update (PHPStan 2.2.14 → 2.3.5, wp-compat 2.0.1 → 3.0.1, wordpress-stubs 7.1.0 → 7.1.2, PHPUnit 9.6.36 → 9.6.38).
  • phpcompatibility/php-compatibility 9.3.5 → 10.0.0-alpha2 (dev-only dependency): the 9.x line cannot see PHP 8.x syntax, so previous “5.6-8.5” scans were blind above 7.4; the 10.x line genuinely scans PHP 5.6 through 8.6 (sniff verified against a known 8.0-only construct).
  • bin/preflight.sh PHPCompatibility scan upper bound raised from 8.5 to 8.6.
  • AGENTS default compatibility windows updated (WordPress 7.0-7.2, PHP 8.3-8.6 development target).

Compatibility

  • WordPress: 4.7 – 7.2 (Tested up to raised to 7.2 after smoke tests on WordPress 7.2-beta4 single-site staging — MariaDB 11.8.9 — covering settings page render, options.php save path, context sanitization, and wp_mail Reply-To injection; WordPress floor re-verified with wp-compat 3.0.1 enforcing Requires at least 4.7).
  • PHP: 5.6 – 8.6 (PHPCompatibility scan 5.6-8.6 clean; the 87-test PHPUnit suite green on PHP 7.4, 8.2, 8.3, 8.4, 8.5, and 8.6.0RC3; syntax lint passes on every PHP binary 5.6 through 8.6; PHP floor stays 5.6 — the real lowest compatible version).

Tests

  • PHP Coding Standards: 3.13.6
  • WordPress Coding Standards: 3.4.1
  • PHPCompatibility: 10.0.0-alpha2 (range 5.6-8.6)
  • PHPStan: 2.3.5 (level 9, wp-compat 3.0.1)
  • PHPUnit: 9.6.38 — 87 tests (86 → 87: added regression test asserting the legacy options stay out of the settings group)
  • Plugin Check (PCP): 0 errors on the release package (4 accepted warnings, unchanged: trademarked_term x2, load_plugin_textdomain, $site_id in uninstall.php)

2.1.0

Release date: 2026-09-18

Highlights

  • Known issues resolved: WooCommerce context values are no longer lost, and plugin data is now preserved on uninstall unless you opt in to removal.

Added

  • “Delete plugin data on uninstall” opt-in setting (Default tab). Your Reply-To settings are preserved by default and only removed when you explicitly check this box. On Multisite, each site’s own opt-in decides its own data.
  • WP_MAIL_REPLYTO_VERSION constant for cache-busting and version checks.

Changed

  • WooCommerce context values now survive settings saves made while WooCommerce is deactivated (previously they were silently dropped; the tab reappears with its values when WooCommerce is reactivated).
  • Settings page now terminates with wp_die() instead of a silent blank page when accessed without manage_options.
  • “Save Settings” button no longer double-escaped.
  • Active tab query parameter ($_GET[‘tab’]) now unslashed before sanitization (Plugin Check hardening).
  • Development tooling updated via composer update (PHPStan 2.2.8 → 2.2.14, wp-compat 1.5.0 → 2.0.1, wordpress-stubs 6.9.4 → 7.1.0, phpstan-wordpress 2.0.3 → 2.0.4, php-parser 5.8.0 → 5.9.0, wp-hooks/wordpress-core 1.12.0 → 1.13.0).
  • Documented wp-compat 2.x false positive for apply_filters() extra args (formalized in the 6.0 signature, functional since WP 0.71) with a targeted phpstan.neon ignore.
  • bin/preflight.sh runs PHPStan with –memory-limit=1G (updated dev deps exceed the default 512M worker limit).

Fixed

  • Uninstall no longer deletes plugin options unconditionally (previous documented behavior since 1.1.0); removal now requires the explicit opt-in introduced in this version.
  • Uninstall no longer processes the main site twice on Multisite.

Compatibility

  • WordPress: 4.7 – 7.1 (7.2 not yet released — expected December 2026 — so Tested up to stays at 7.1)
  • PHP: 5.6 – 8.5

Tests

  • PHP Coding Standards: 3.13.6
  • WordPress Coding Standards: 3.4.1
  • PHPStan: 2.2.14 (level 9)
  • PHPUnit: 9.6.36
  • PHPUnit suite expanded from 78 to 86 tests (95.84% line coverage): uninstall opt-in behaviour, WooCommerce context preservation, admin opt-in rendering.
  • Plugin Check (PCP): run against the release package — 0 errors (3 accepted warnings documented in docs/known-issues.md).
  • Smoke-tested on WordPress 7.1-alpha staging (single-site): settings page renders, wp_mail filter injects the configured Reply-To header.

2.0.3

Release date: 2026-08-18

Highlights

  • Housekeeping release: branding URLs moved to robotstxt.software and declared WordPress support floor set to 4.7.

Changed

  • Minimum WordPress version raised from 3.6 to 4.7 (real functional floor: register_setting() with array arguments requires WordPress 4.7; symbol-wise floor is 3.6 — wp_unslash — but sanitization on save only works from 4.7).
  • Developer URL updated to https://www.robotstxt.software/ and plugin home page added (https://www.robotstxt.software/plugins/replyto/).
  • Full changelog now hosted at https://www.robotstxt.software/plugins/replyto/changelog/.
  • Development tooling updated via composer update (PHPCS 3.13.6, WPCS 3.4.1, PHPStan 2.2.8, PHPUnit 9.6.36).

Added

  • bin/preflight.sh automated pre-deploy verification script (PHPCS, PHPStan, PHPCompatibility, PHPUnit, composer audit, candidate ZIP inspection).
  • WordPress floor verification (wp-compat) integrated into PHPStan analysis; declared minimum now verified on every run.
  • PHPUnit suite expanded from 27 to 78 tests (95.5% line coverage): wp_mail filter routing, context detection, migration, sanitization, admin rendering, uninstall cleanup.

Compatibility

  • WordPress: 4.7 – 7.1
  • PHP: 5.6 – 8.5

Tests

  • PHP Coding Standards: 3.13.6
  • WordPress Coding Standards: 3.4.1
  • PHPStan: 2.2.8 (level 9)
  • PHPUnit: 9.6.36

2.0.2

Release date: 2026-06-05

Highlights

  • Translations added for Spanish (Spain) and Catalan.
  • WordPress minimum version corrected to 3.6 based on actual function usage.

Changed

  • Minimum WordPress version updated from 4.1 to 3.6 (real minimum per wp-compat analysis: wp_unslash since WP 3.6).
  • Tested up to WordPress 7.1.
  • POT file regenerated via WP-CLI i18n — removed dead strings, corrected line references.
  • Deploy script no longer includes docs/ in the distributable ZIP.
  • Deploy script skips empty vendor/ directory when no production Composer dependencies exist.

Added

  • Spanish (Spain) translation (es_ES).
  • Catalan translation (ca).

Compatibility

  • WordPress: 3.6 – 7.1
  • PHP: 5.6 – 8.5

Tests

  • PHP Coding Standards: 3.13.5
  • WordPress Coding Standards: 3.3.0
  • PHPStan: 2.2.2 (level 9)
  • PHPUnit: 9.6.34

2.0.1

Release date: 2026-06-05

Highlights

  • Major bugfix release addressing three critical issues found during pre-deploy audit.

Fixed

  • Context cache not resetting between emails in the same PHP process (affected WP-Cron and REST batch sends).
  • Duplicate Reply-To header injected when an existing Reply-To was present in the email.
  • Migration hook only running on admin_init — missed WP-CLI activations and automated deployments.
  • RFC 5322 display name quoting now applied only when the name contains special characters.

Added

  • Developer filter wp_mail_replyto_context — override the detected email context.
  • Developer filter wp_mail_replyto_header — override or suppress the Reply-To header per email.
  • load_plugin_textdomain() registration for translation support on WordPress < 4.6.
  • DNS domain validation per context with user-friendly warning messages.
  • PHPUnit test suite (27 tests).
  • bin/deploy.sh build script.

Changed

  • Admin CSS now registered via wp_register_style() + wp_add_inline_style().
  • enabled flag now handles boolean true in addition to string '1'.
  • Multibyte-safe name length truncation (mb_strlen/mb_substr).
  • CR-only header normalization added alongside CRLF.

Security

  • sanitize_callback added to legacy option registrations (wp_mail_replyto_email, wp_mail_replyto_name).

Compatibility

  • WordPress: 4.1 – 6.9
  • PHP: 5.6 – 8.5

Tests

  • PHP Coding Standards: 3.13.5
  • WordPress Coding Standards: 3.3.0
  • PHPStan: 2.2.2 (level 9)
  • PHPUnit: 9.6.34

2.0.0

Release date: 2026-01-20

Highlights

  • Complete rewrite with context-based Reply-To routing.

Added

  • Context-based Reply-To routing — configure different Reply-To addresses for different types of emails.
  • Six email contexts: Default, Authentication & Security, Comments & Moderation, Users & Registration, System & Updates, WooCommerce.
  • WooCommerce tab only shown when WooCommerce plugin is active.
  • Intelligent context detection using debug_backtrace() with DEBUG_BACKTRACE_IGNORE_ARGS and a 20-frame limit.
  • Modern tabbed admin interface using WordPress native nav-tab-wrapper.
  • Visual status indicators on each tab.
  • Enable/disable toggle per context (Default is always active).
  • Fallback chain: specific context → Default context → legacy settings.
  • Reply-To display name field with header injection prevention.
  • DNS domain validation for email addresses.
  • Configuration change logging for security auditing (requires WP_DEBUG_LOG).
  • Automatic migration from v1.0.x — existing settings preserved in the Default context.
  • uninstall.php for clean removal of all plugin options on single-site and Multisite.

Changed

  • Settings structure changed from two individual options to a single serialized array (wp_mail_replyto_contexts).
  • Settings page completely rewritten with tab-based interface.

Security

  • Strict RFC 5322 email format validation beyond is_email().
  • Defense-in-depth header injection prevention.

Compatibility

  • WordPress: 4.1 – 6.9
  • PHP: 5.6 – 8.5

Tests

  • PHP Coding Standards: 3.13.4
  • WordPress Coding Standards: 3.3.0
  • Plugin Check (PCP): 1.4.0

1.0.3

Release date: 2025-04-08

Changed

  • Compatible with WordPress 6.8.
  • Improved function documentation.

Compatibility

  • WordPress: 4.1 – 6.9
  • PHP: 5.6 – 8.5

Tests

  • PHP Coding Standards: 3.12.1
  • WordPress Coding Standards: 3.1.0
  • Plugin Check (PCP): 1.4.0

1.0.2

Release date: 2024-11-02

Fixed

  • Preparation for GlotPress translation workflow.

Compatibility

  • WordPress: 4.1 – 6.9
  • PHP: 5.6 – 8.5

1.0.1

Release date: 2024-10-31

Added

  • Translation ready.

Compatibility

  • WordPress: 4.1 – 6.9
  • PHP: 5.6 – 8.5

1.0.0

Release date: 2024-10-22

Added

  • First version.

Compatibility

  • WordPress: 4.1 – 4.1
  • PHP: 5.6 – 8.5