== 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.1 = _Release date: 2026-09-18_ **Highlights** * Security hardening patch: settings error messages now escape the context label, and the deferred review items are closed out. No behavior change. **Security** * Context name in settings error/warning messages (invalid email, DNS domain warning, name truncation) now escaped at output time via esc_html() — defense in depth for translated labels. **Changed** * Known-issues triage closed: load_plugin_textdomain() accepted (bundled translations in /languages must load even before GlotPress coverage); trademarked_term accepted (not a problem per maintainer); switch_to_blog() uninstall sweep confirmed as the standard pattern — batched get_sites() pagination documented as the fallback for very large networks. * composer update re-run: no dependency changes (already current). **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 = 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