Home / / Cache Purge & Reset Tools

Cache Purge & Reset Tools

1 view

WPResidence Translate ships with three admin-side maintenance tools that help you keep a clean multilingual site: a cache purge hook for translations, a reset button that wipes plugin data without losing translated content, and a delete translations batch tool that permanently removes translated posts or terms for a chosen language. This article covers all three in order of risk — from safe to destructive. For overall product context, see the WPResidence multi-language real estate website page.

Where You Will Find These Tools

All three tools live on the same admin screen: WPEstate Translate > Settings. Scroll past the main settings form and you will see the Reset card and the Delete Translations card stacked below it. The cache purge runs automatically at the end of automatic-translation batches — no button to click.

Screenshot: Settings page scrolled down showing Reset Translation Settings and Delete Translations cards

Translation Cache Purge

WPResidence caches certain expensive queries (property action lists, city lists, category dropdowns, feature lists). When you add or auto-translate content in a new language, those caches need to be refreshed so translated labels show up on the frontend.

You normally do not need to do anything — the plugin automatically:

  • Invalidates the relevant WPResidence transients whenever it detects changes to translated admin strings (Action, Category, City, Area, County/State, Status, Features select lists).
  • Calls the WPResidence cache purge endpoint at the end of a bulk automatic-translation run, so the new translations are visible immediately on the frontend.

When to Manually Trigger It

You may want to manually clear cache in these situations:

  • You imported translations via a database tool (phpMyAdmin, WP-CLI) and bypassed the normal admin UI.
  • A translated dropdown on the frontend still shows untranslated labels after a refresh.
  • You changed the default language.

To manually purge, open any property edit screen (or any screen with a WPResidence cache purge button) and click the WPResidence cache purge control. This flushes the same caches the plugin flushes internally.

Reset Translation Settings

Use the Reset Translation Settings card when you want to start configuration from scratch — for example, during testing, after an aborted migration, or when handing the site to a new owner.

What Reset Does

  • Empties all six plugin database tables (translations, strings, slugs, glossary, memory, languages).
  • Deletes all plugin options — languages, catalog, settings, glossary, auto-translation config, scanner state, custom field rules, theme widget/admin strings markers, language switcher options.
  • Clears in-memory caches.
  • Re-runs the activation routine so the plugin comes back with default settings and a freshly seeded language catalog.

What Reset Does NOT Do

  • It does not delete translated posts, pages, properties, agents, or terms. These remain as regular WordPress content.
  • It does not delete anything in your default language.
  • It does not uninstall the plugin.

How to Run the Reset

  1. Take a backup.
  2. Open WPEstate Translate > Settings.
  3. Scroll to the Reset Translation Settings card.
  4. Click Reset Translation Settings.
  5. Confirm the JavaScript dialog.

You will be redirected back to the Settings page with a green success message: “Translation settings were reset. Existing translated posts were kept.”

Screenshot: Reset Translation Settings confirmation dialog asking the user to confirm the action

Delete Translations (Bulk)

The Delete Translations card permanently deletes translated posts or translated terms in a single target language. Originals in the default language are never touched.

When to Use It

  • You want to drop support for a specific language but keep the plugin running for other languages.
  • You ran an automatic translation batch that produced low-quality results and want to start that language over.
  • You are cleaning up a staging site before cloning it to production.

Delete Translated Posts

  1. In the Select post types list, click one or more post types (hold Ctrl / Cmd to select multiple). Properties, posts, pages, agents, agencies, developers, and any other public post types all appear here. Transactional types like bookings and invoices are excluded automatically.
  2. In the Select language dropdown, choose the target language. The default language is deliberately missing from this list — you cannot use this tool to destroy originals.
  3. Click Delete Translated Posts.
  4. The status line shows progress. The tool processes items in batches of 20 at a time; the bar will tick down to zero.

Screenshot: Delete Translated Posts sub-section with multi-select post types and language dropdown

Delete Translated Terms

Same flow, applied to taxonomies:

  1. Select one or more taxonomies (categories, locations, features, custom taxonomies).
  2. Select the target language (default language is excluded).
  3. Click Delete Translated Terms.

Safety Guarantees

Several safety checks run on every batch:

  • The default language is always excluded from the dropdown and from the server-side handler.
  • The plugin only deletes items that carry its own translation marker meta — content that was never a plugin-managed translation is skipped.
  • Each AJAX batch re-verifies the user’s Manage Options capability and the security nonce.

Order of Operations — Choosing the Right Tool

Goal Use
Translated labels look stale on the frontend WPResidence cache purge
Start configuration fresh but keep translated posts Reset Translation Settings
Drop one language’s translated content, keep everything else Delete Translated Posts / Terms
Remove the plugin entirely Plugins > Delete (see Installation, Activation & Uninstall)

Recovery

Reset and Delete operations cannot be undone from inside the plugin. Always take a database backup before using them on a production site. If you need to recover, restore from that backup.

Tips

  • Delete Translations runs as an AJAX batch — you can leave the tab open and walk away. It will keep ticking through 20-item batches until the counter reaches zero.
  • If you change the default language, consider running the Reset after, because translation links will point to a different “original” language after the switch.
  • After a Reset, visit Languages first and re-add the languages you want, then re-scan strings on the Theme & Plugins Strings page.

What To Read Next

  • Settings Page — a tour of every configuration option.
  • Installation, Activation & Uninstall — what gets removed when you delete the plugin.
  • Automatic Translation — how auto-translation batches trigger the cache purge on finish.

To see where these tools fit inside the bigger picture, see the WPResidence multi-language real estate website reference.