Skip to main content

Developer and Testing Tools

This page covers tools in Benecaster → Settings → Tools → Danger Zone that are useful when developing, testing, or debugging a Benecaster installation. None of these controls appear on production sites.


Reset Plugin Data

Appears when: WP_DEBUG is true in wp-config.php

The “Reset plugin data (testing only)” card wipes everything Benecaster has written to the database and resets the plugin to its post-activation state:

  • All Benecaster custom database tables (subscribers, download log, analytics, email queue, etc.)
  • All Benecaster CPT posts (shows, episodes, migration patrons)
  • All benecaster_* options, including the site token that connects this site to your plan
  • All scheduled Benecaster cron events
  • All Benecaster-managed media uploads

WordPress users, pages, themes, and all other plugins are untouched. After the reset, the plugin re-runs its activator as if it were a fresh install — the next admin page load redirects to the Setup Wizard.

How to use:

  1. Go to Benecaster → Settings → Tools → Danger Zone
  2. Find the “Reset plugin data (testing only)” card
  3. Type RESET in the confirmation field (case-sensitive)
  4. Click Reset — the wipe runs immediately

This action is irreversible. Use it only on development or staging sites.


Reset Setup Wizard

Appears when: the site’s environment is local, development, or staging (as reported by wp_get_environment_type()), or when WP_DEBUG is true.

Never visible on production.

The “Reset setup wizard (testing only)” card clears all wizard state and returns the wizard to its initial screen:

  • benecaster_setup_wizard_complete
  • benecaster_setup_wizard_dismissed
  • benecaster_wizard_show_id
  • benecaster_wizard_membership_mode
  • All benecaster_wizard_step_*_complete options

Show data, episodes, subscribers, and your site connection are untouched. The Reset Wizard control is the right tool when you need to re-run wizard paths without rebuilding the entire site.

How to use:

  1. Go to Benecaster → Settings → Tools → Danger Zone
  2. Find the “Reset setup wizard (testing only)” card
  3. Click Reset wizard — all wizard state options are deleted immediately and the wizard paused-state notice clears on the next page load

301 Redirect Cleanup Notices

Not a Danger Zone control — this one appears as a standard admin notice in the Benecaster shell.

When a 301 redirect rule generated by a prefix change is more than a year old, Benecaster shows a notice suggesting you remove it. After a year, podcast apps and search crawlers will have updated to the new URL, so the rule is no longer protecting anything.

What the notice says: “The redirect from /{old-prefix}/ has been active for over a year. Consider removing it — podcast apps and search engines will have updated by now.”

To dismiss: Click the × on the notice. Dismissal is per-rule — each redirect rule’s notice can be dismissed independently. The rule itself remains active until you explicitly delete it; dismissal only hides the notice.

If you later decide to delete the rule entirely, go to Benecaster → Settings → Permalinks and remove it from the active redirect list.

See Permalink Settings for how redirect rules are generated and managed.

See Also

Need this built rather than just documented? See our services →