{"id":305905,"date":"2026-05-11T08:59:01","date_gmt":"2026-05-11T08:59:01","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/flexa-unsubscribe\/"},"modified":"2026-05-20T10:06:14","modified_gmt":"2026-05-20T10:06:14","slug":"flexa-unsubscribe","status":"publish","type":"plugin","link":"https:\/\/ko.wordpress.org\/plugins\/flexa-unsubscribe\/","author":23412324,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"3.1.2","stable_tag":"3.1.2","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Flexa Unsubscribe","header_author":"flexatech","header_description":"Professional email unsubscribe management with HMAC tokens, auto-append logic, and CSV export.","assets_banners_color":"faf8ff","last_updated":"2026-05-20 10:06:14","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":103,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"3.0.2":{"tag":"3.0.2","author":"flexatech","date":"2026-05-11 09:03:22"},"3.1.1":{"tag":"3.1.1","author":"flexatech","date":"2026-05-20 09:21:49"},"3.1.2":{"tag":"3.1.2","author":"flexatech","date":"2026-05-20 10:06:14"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":3528475,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3528443,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["3.0.2","3.1.1","3.1.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3538671,"resolution":"1","location":"assets","locale":"","width":1170,"height":658},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3538671,"resolution":"2","location":"assets","locale":"","width":1170,"height":658},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3538671,"resolution":"3","location":"assets","locale":"","width":1148,"height":658},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3538671,"resolution":"4","location":"assets","locale":"","width":1170,"height":658},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3538671,"resolution":"5","location":"assets","locale":"","width":1170,"height":658},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3538671,"resolution":"6","location":"assets","locale":"","width":1170,"height":658}},"screenshots":{"1":"Dashboard<\/strong> - stats cards + bar chart of unsubscribes over time + pie chart of top reasons.","2":"Unsubscribes \/ Blocked emails \/ Re-subscribed<\/strong> - paginated tables with sorting, per-row delete, and CSV export. The Unsubscribes screen also accepts CSV import for bulk-adding opt-out records (skip-on-duplicate).","3":"Reasons<\/strong> - manage the dropdown options shown on the public unsubscribe form; click-to-edit, \u2191\/\u2193 reorder.","4":"Settings<\/strong> - enable\/disable auto-append + blocking, tune the exclude-keywords list.","5":"Appearance<\/strong> - 19 tokens (colors, typography, copy) across three tabs with a live preview panel.","6":"Blocked Emails<\/strong> - audit log of send attempts that were stopped because the recipient had opted out - it is not the opt-out list itself."}},"plugin_section":[],"plugin_tags":[267,131785,5825,44115,9755],"plugin_category":[41],"plugin_contributors":[255540],"plugin_business_model":[],"class_list":["post-305905","plugin","type-plugin","status-publish","hentry","plugin_tags-email","plugin_tags-gdpr","plugin_tags-mailing-list","plugin_tags-opt-out","plugin_tags-unsubscribe","plugin_category-communication","plugin_contributors-flexatech","plugin_committers-flexatech"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/icon.svg?rev=3528475","icon":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/icon.svg?rev=3528475","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/screenshot-1.png?rev=3538671","caption":"Dashboard<\/strong> - stats cards + bar chart of unsubscribes over time + pie chart of top reasons."},{"src":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/screenshot-2.png?rev=3538671","caption":"Unsubscribes \/ Blocked emails \/ Re-subscribed<\/strong> - paginated tables with sorting, per-row delete, and CSV export. The Unsubscribes screen also accepts CSV import for bulk-adding opt-out records (skip-on-duplicate)."},{"src":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/screenshot-3.png?rev=3538671","caption":"Reasons<\/strong> - manage the dropdown options shown on the public unsubscribe form; click-to-edit, \u2191\/\u2193 reorder."},{"src":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/screenshot-4.png?rev=3538671","caption":"Settings<\/strong> - enable\/disable auto-append + blocking, tune the exclude-keywords list."},{"src":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/screenshot-5.png?rev=3538671","caption":"Appearance<\/strong> - 19 tokens (colors, typography, copy) across three tabs with a live preview panel."},{"src":"https:\/\/ps.w.org\/flexa-unsubscribe\/assets\/screenshot-6.png?rev=3538671","caption":"Blocked Emails<\/strong> - audit log of send attempts that were stopped because the recipient had opted out - it is not the opt-out list itself."}],"raw_content":"\n

Flexa Unsubscribe<\/strong> adds a complete unsubscribe workflow to every email WordPress sends, with a fully-branded admin UI for managing opt-outs, analytics, and the public unsubscribe page.<\/p>\n\n

    \n
  • Auto-appends a secure unsubscribe button<\/strong> to outgoing single-recipient emails. Tokens are HMAC-signed using the AUTH_KEY<\/code> in wp-config.php<\/code>, so no database lookup is needed to verify a link.<\/li>\n
  • Blocks outbound mail to unsubscribed addresses<\/strong> before it reaches the mail server. Blocked attempts are logged to a dedicated audit table.<\/li>\n
  • Honours an exclude-keywords list<\/strong> (default: Order, Password, Invoice<\/code>) so transactional mail never gets an unsubscribe link and never gets blocked.<\/li>\n
  • Re-subscribe URL<\/strong> is supported as a first-class action - the plugin can tell opt-outs from opt-backs.<\/li>\n
  • Customisable public page<\/strong> - every color, font, and string on the unsubscribe\/re-subscribe templates is editable from the admin with a live preview.<\/li>\n<\/ul>\n\n

    Admin UI<\/h3>\n\n

    Starting with v3.0.0 the admin is a React single-page application with seven screens:<\/p>\n\n

      \n
    • Dashboard<\/strong> - stats cards + bar chart of unsubscribes over time + pie chart of top reasons.<\/li>\n
    • Unsubscribes \/ Blocked emails \/ Re-subscribed<\/strong> - paginated tables with sorting, per-row delete, and CSV export. The Unsubscribes screen also accepts CSV import for bulk-adding opt-out records (skip-on-duplicate).<\/li>\n
    • Reasons<\/strong> - manage the dropdown options shown on the public unsubscribe form; click-to-edit, \u2191\/\u2193 reorder.<\/li>\n
    • Settings<\/strong> - enable\/disable auto-append + blocking, tune the exclude-keywords list.<\/li>\n
    • Appearance<\/strong> - 19 tokens (colors, typography, copy) across three tabs with a live preview panel.<\/li>\n<\/ul>\n\n

      All screens are powered by a REST API under \/wp-json\/flexa-unsubscribe\/v1\/<\/code>, so external integrations can plug in too.<\/p>\n\n

      Documentation<\/strong><\/p>\n\n

      Full user guide, technical reference, and REST API documentation are hosted at:<\/p>\n\n

      https:\/\/unsubscribe-doc.flexacommerce.com\/<\/p>\n\n

      A \"Documentation\" link is also added to the plugin row on the Plugins<\/strong> screen for one-click access from inside WordPress.<\/p>\n\n\n

        \n
      1. Upload the plugin files to \/wp-content\/plugins\/flexa-unsubscribe<\/code>, or install through the WordPress Plugins<\/strong> screen.<\/li>\n
      2. Activate the plugin through the Plugins<\/strong> screen.<\/li>\n
      3. On activation the plugin provisions three database tables: {prefix}flexa_unsubscribes<\/code>, {prefix}flexa_blocked_emails<\/code>, {prefix}flexa_unsubscribe_reasons<\/code> (the last seeded with three default reasons).<\/li>\n
      4. Visit Unsubscribe<\/strong> in the admin sidebar to configure.<\/li>\n<\/ol>\n\n\n
        \n

        Do I need to change anything in my existing email sending code?<\/h3><\/dt>\n

        No. The plugin hooks wp_mail<\/code> with standard WordPress filters. Any plugin or theme that sends mail via wp_mail<\/code> is covered automatically.<\/p><\/dd>\n

        What happens if I rotate `AUTH_KEY`?<\/h3><\/dt>\n

        Every in-flight unsubscribe\/resubscribe link becomes invalid, because the HMAC key is AUTH_KEY<\/code>. New links issued after rotation work normally. Existing records in the database are unaffected.<\/p><\/dd>\n

        How are blocked emails different from unsubscribed addresses?<\/h3><\/dt>\n

        Unsubscribes is the list of addresses that opted out. Blocked emails<\/code> is the audit log of outgoing sends that were stopped because they targeted an unsubscribed address. One unsubscribe can cause many blocked-email entries over time.<\/p><\/dd>\n

        Are CSV exports safe to share publicly?<\/h3><\/dt>\n

        No - CSV exports contain email addresses. Treat them as PII. The download link is nonce-protected so it's not trivially shareable across sessions.<\/p><\/dd>\n\n<\/dl>\n\n\n

        3.1.2<\/h4>\n\n
          \n
        • Fix:<\/strong> Inline-editing a reason on the Reasons<\/strong> screen now commits the new value when you click anywhere outside the input. Previously, clicking away discarded the typed value - only pressing Enter would save. Enter still saves; Esc still discards.<\/li>\n<\/ul>\n\n

          3.1.1<\/h4>\n\n
            \n
          • New:<\/strong> Plugins-list row now shows Settings<\/strong> and Documentation<\/strong> links next to Deactivate<\/strong>, plus a View documentation<\/strong> link in the row's meta line. The doc site is https:\/\/unsubscribe-doc.flexacommerce.com\/.<\/li>\n
          • i18n:<\/strong> 3 new translatable strings (\"Settings\", \"Documentation\", \"View documentation\").<\/li>\n<\/ul>\n\n

            3.1.0<\/h4>\n\n
              \n
            • New:<\/strong> CSV import on the Unsubscribes screen. Bulk-add opt-out records by uploading a CSV file - the same Email, Reason, Date<\/code> shape produced by the existing CSV export, so an export from one site can be re-imported on another. Email is the only required column; Reason and Date are optional. A header row is auto-detected; headerless files are also accepted.<\/li>\n
            • Behavior:<\/strong> Existing emails are skipped (the import is idempotent - it never overwrites the original unsubscribed_at<\/code> or reason for a row already on the list). The dialog reports imported \/ skipped \/ failed counts and lists the first 100 row-level errors so you can correct the source file.<\/li>\n
            • Safety limits:<\/strong> 2 MiB max file size, 10,000 rows per import, requires manage_options<\/code> plus the standard REST nonce.<\/li>\n
            • REST:<\/strong> new POST \/flexa-unsubscribe\/v1\/unsubscribes\/import<\/code> endpoint accepts a multipart\/form-data<\/code> upload (field file<\/code>).<\/li>\n
            • i18n:<\/strong> 29 new translatable strings (8 PHP, 21 admin UI), translated across all seven bundled locales.<\/li>\n<\/ul>\n\n

              3.0.2<\/h4>\n\n
                \n
              • Security:<\/strong> Sanitize $_GET['email']<\/code> and $_GET['token']<\/code> at the read site in the public unsubscribe\/resubscribe handler (sanitize_email<\/code> \/ sanitize_text_field<\/code> + wp_unslash<\/code>), with a documented phpcs:disable WordPress.Security.NonceVerification.Recommended<\/code> since the HMAC token is the CSRF protection layer for these public links.<\/li>\n
              • Compatibility:<\/strong> Replace inline <style><\/code> and <script><\/code> blocks in templates\/unsubscribe-page.php<\/code> and templates\/resubscribe-page.php<\/code> with wp_register_style<\/code> \/ wp_enqueue_style<\/code> \/ wp_add_inline_style<\/code> (and the script equivalents), so the public templates pass the WP.org Plugin Check enqueue rule.<\/li>\n
              • Docs:<\/strong> Fix the source-code repository URL in readme.txt<\/code>.<\/li>\n<\/ul>\n\n

                3.0.0<\/h4>\n\n
                  \n
                • Complete admin rewrite.<\/strong> The seven admin pages are now a React single-page app (Vite + TypeScript + shadcn\/ui + Tailwind v4) instead of individual PHP-rendered screens.<\/li>\n
                • New:<\/strong> REST API under \/wp-json\/flexa-unsubscribe\/v1\/<\/code> covering unsubscribes, blocked emails, re-subscribes, reasons, settings, appearance, and analytics. Every admin screen consumes this API.<\/li>\n
                • New:<\/strong> Dashboard with time-series and reasons charts (recharts).<\/li>\n
                • New:<\/strong> Live preview panel on the Appearance screen - see your colors, fonts, and copy applied to a replica of the public unsubscribe page while you edit.<\/li>\n
                • New:<\/strong> Client-side search + server-side sort + server-side pagination on every list screen.<\/li>\n
                • New:<\/strong> URL-synced table state (?page=2&sort=email&order=desc<\/code> bookmarkable) on every list screen.<\/li>\n
                • Security:<\/strong> CSV export admin-post.php<\/code> handlers now verify nonces via check_admin_referer()<\/code>.<\/li>\n
                • Change:<\/strong> Admin menu label is \"Unsubscribe\" (same as pre-2.x) and sits at menu position 60. Slug changed from flexa-su<\/code> to flexa-unsubscribe<\/code> - legacy admin bookmarks will 404.<\/li>\n
                • Change:<\/strong> Removed the flexa_get_analytics_data<\/code> AJAX endpoint, superseded by the REST \/analytics\/*<\/code> routes.<\/li>\n
                • Requires PHP 7.4<\/strong> (was previously unspecified; the plugin now declares the floor).<\/li>\n<\/ul>\n\n

                  2.0.2<\/h4>\n\n
                    \n
                  • Pagination for large lists.<\/li>\n<\/ul>\n\n

                    2.0.1<\/h4>\n\n
                      \n
                    • Menu refinements.<\/li>\n<\/ul>\n\n

                      2.0.0<\/h4>\n\n
                        \n
                      • Analytics page introduced.<\/li>\n<\/ul>","raw_excerpt":"Professional email unsubscribe management with HMAC tokens, auto-appended unsubscribe links, recipient blocking, and CSV import\/export.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/305905","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=305905"}],"author":[{"embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/flexatech"}],"wp:attachment":[{"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=305905"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=305905"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=305905"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=305905"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=305905"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ko.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=305905"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}