Skip to content
Gundahar Bravin edited this page Jul 1, 2026 · 1 revision

❓ FAQ

General

Will this delete my established residents?

No. Never. Any account with a w4os_uuid value is completely invisible to this plugin at all times. Established residents with avatars cannot be selected, flagged, emailed, or deleted by Royal Flush under any circumstances.

Will it delete admin accounts?

No. Any user with the edit_posts capability (Administrators, Editors) is permanently exempt from all plugin activity.

Can it delete my own account?

No. Your own user ID is hardcoded as protected at deletion time. Even if you somehow selected yourself in the queue, the server-side check would skip you.

Does anything get deleted automatically?

Absolutely not. Nothing is ever auto-deleted. Every deletion requires you to manually select accounts, click the flush button, and confirm twice. You are always in full control.


Emails

Will users get spammed with repeated emails?

No. Each email is sent exactly once per account, ever. The sent timestamp is stored in user meta the moment it is sent and the scan never sends that email again.

A user got both the Day 30 and Day 59 email at the same time. Is that a bug?

No. This is expected behavior on first activation. If an account is already 60+ days old when the plugin is first activated, both emails fire in the first scan pass since neither has been sent before. This only happens once — after that, each email fires at its proper threshold going forward.

Can I customize the email content?

Not in v1.0.0. Configurable email templates are planned for a future release. The emails currently use your WordPress site name dynamically and reference your avatar creation URL automatically.

What if the email bounces or never reaches the user?

The plugin records the send attempt regardless of delivery. If an email bounces, the account will still be flagged at Day 60 and appear in your review queue as normal.


The Queue

An account is in the queue but I know it's legitimate. What do I do?

Simply don't check the box next to it when you flush. The queue is for review — you decide who gets flushed. Legitimate accounts can sit in the queue indefinitely without harm.

Can I remove an account from the queue without deleting it?

Not via the UI in v1.0.0. If you want to manually clear the queue flag for a specific user, go to Users → Edit User for that account and delete the orf_queued user meta value. The account will no longer show as Queued but will re-enter the queue on the next scan if it is still past 60 days.

How often should I run the flush?

As often as you like. The queue builds up over time — weekly or monthly review sessions work well for most grids. The daily cron handles emails and flagging automatically in the background.


Bot Detection

Gmail is showing up as a bot farm domain. How do I fix it?

Add gmail.com to your trusted domains list under Users → Royal Flush Settings. Gmail is pre-populated in the default trusted domains list — if it is showing as a bot farm domain, it may have been accidentally removed. Click Reset to Defaults to restore the full default list.

A domain is flagged as a bot farm but it's legitimate. What do I do?

Click the "Add to trusted domains →" link in the bot farm warning bar and add the domain to your trusted list. It will never be flagged again.

What counts as a bot farm domain?

Any email domain that is not on your trusted list AND has more than one no-avatar account registered under it. The threshold is simply more than one account — even two accounts from the same obscure domain will trigger the warning.


Technical

Does this work without WooCommerce?

Yes. The plugin only requires w4os to be installed and configured. WooCommerce is not required. The Last Seen column uses wc_last_active user meta if WooCommerce is present, but will simply show — if it is not.

Does this work on WordPress Multisite?

Not officially tested in v1.0.0. Multisite support is planned for a future release.

What happens if I deactivate the plugin?

The WP-Cron schedule is cleanly removed on deactivation. User meta flags remain in the database but are completely harmless. Reactivating the plugin will pick up exactly where it left off.

What happens if I delete the plugin?

Plugin files are removed. User meta flags (orf_email_d30, orf_email_d59, orf_queued) remain in the database. If you want a completely clean removal, delete these meta keys manually via phpMyAdmin or a user meta cleanup plugin.


Disabled Accounts

The Select Disabled button isn't selecting anything. Why?

The Disabled feature requires the Disable User Login plugin to be installed and active. Royal Flush detects disabled accounts via the _is_disabled user meta key that this plugin writes. Without it, no accounts will have that meta key and the Select Disabled button will have nothing to select.


How It Works | Changelog

Clone this wiki locally