RiskyBuyer – Customer Flags for WooCommerce

RiskyBuyer lets your team keep a list of problematic customers (uncollected COD shipments, fake orders, abusive behaviour, etc.) and flags their orders right in the WooCommerce orders list. Each entry is a phone and/or a name, with a reason and an optional note. When a customer's order matches an entry (by normalized phone OR name), the order row is highlighted with a warning badge — and you get a clear warning panel on the order edit screen, with quick links to that buyer's other orders. Features

• Searchable, sortable list — one table of flagged buyers. Filter by phone and/or name (with an AND/OR toggle) and by reason, and sort by any column — all instantly in the browser.
• Orders list flagging — a warning badge and colored bar on orders of blacklisted customers. Computed server-side, so it works across pagination. Supports both HPOS (the new orders screen) and the legacy screen.
• Order edit panel — a warning when the buyer is blacklisted (with links to their other orders on your site), or a one-click "mark client" form otherwise.
• Add one or in bulk — add a single buyer or paste a list (one per line). You can also search your existing customers (by name or phone, taken from your orders) and pick one to fill the form.
• Phone normalization — numbers are stored in international "+CC" form, so the same person matches across formatting differences.
• Roles — anyone who can edit orders (edit_shop_orders) can add; only administrators (manage_options) can edit or delete.
• Optional shared list — opt-in synchronization with a central service (see the "External services" section), off by default.

Architecture The plugin talks to its data through a storage-provider interface. Today it uses a local database table; the design is ready for a future shared/central service so multiple sites can contribute to and read the same list.

1. Upload the riskybuyer folder to /wp-content/plugins/, or install it from the Plugins screen.
2. Activate the plugin (this creates the database table).
3. Manage the list under WooCommerce → Risky buyers.

Requires WooCommerce.

1.0.3

• Added a "Settings" link to the plugin's row on the Plugins screen.

1.0.2

• Renamed to "RiskyBuyer – Customer Flags for WooCommerce".
• Orders-list styles and script are now loaded with the standard WordPress enqueue functions instead of inline tags.

1.0.1

• Order screen: the "Risky buyer" box now shows a single "Mark as problematic" button and reveals the reason/note form only when you click it — less clutter on every order.

1.0.0

• First public release.

0.6.11

• Add tab: fixed the icon vertical alignment on the "Add one client" / "Bulk add" buttons (dashicons now sit level with the text).

0.6.10

• Settings: the "data sent to the server" note and the sync status (last update / downloaded / new) now appear as hover tooltips behind small info / help icons next to the enable-sync checkbox, instead of permanent paragraphs.
• Settings: key check now tells an unreachable server apart from an actually invalid key (no more false "invalid key" when the server is just down).

0.6.9

• Customer search: phone numbers shown normalized (+CC), duplicate spellings/formats of the same buyer collapsed into one result, and the matching order numbers listed in parentheses.

0.6.8

• Add tab: nicer "Add one client" / "Bulk add" buttons (card style, accent icons, hover lift, solid active state).

0.6.7

• Fixed: the customer search dropdown now appears (its results box was nested in a , which browsers auto-close before block elements, breaking positioning). Added a loading spinner and an error state.
• Add tab: the single and bulk forms are now behind "Add one client" / "Bulk add" buttons; clicking reveals the fields, which stay open (empty) after each add so you can keep adding until you reload.
• Add tab: reason defaults to the top option and remembers your last-used reason for the next entry.

0.6.6

• Add tab: the customer search now sits above the form (outside it), so pressing Enter searches instead of submitting an empty entry; Enter also triggers the search immediately.

0.6.5

• Add tab: search existing shop customers (by name or phone, pulled from your orders) and pick one to fill in the name and phone instantly.

0.6.4

• Settings: the API key locks (grey, read-only) once validated for this site, with a red x to clear it; it is checked once (on entry/load), not continuously.
• Settings: Sync now / Push are color-coded icon buttons next to the server URL; Push appears only with a valid write key; both save settings first.
• Sync status now shows how many entries are new in the last sync, not just the total downloaded.
• List: click any column header to sort (default: date, newest first).

0.6.3

• Phone numbers are normalized on save to international +CC form (00 -> +, national leading 0 -> country code; default +359, filterable).
• Order banner now links to the buyer's other orders on this site (excluding the one open).
• List: centered cell values; Edit/Delete shown as icons; reason filter and reason dropdowns color-coded to match the list.
• Settings: clearer wording for the sync status; the "data sent" note moved under the sync panel; constrained width.

0.6.2

• Admin: removed the redundant Check tab — the List tab now filters instantly in the browser (phone/name with AND/OR + reason, no reload).
• Admin: cleaner Add/Edit forms and centered, bold table headers.

0.6.1

• Passes Plugin Check with zero errors and warnings (security/SQL/i18n).

0.6.0

• Renamed to RiskyBuyer (slug, text domain, identifiers) to match the project and site; data is migrated automatically on update.
• Tested up to WordPress 7.0.

0.5.0

• Settings tab is now AJAX: enabling sync reveals the URL/key fields and saves automatically (no reload, no Save button). The API key is validated against the server; the "Push my list" button appears only for a valid write key.

0.4.2

• AND/OR toggle added to the Check tab search too (not only the List tab).

0.4.1

• Prominent banner on the order screen when the customer is on the problem list.
• List tab: separate phone/name search (LIKE) with an AND/OR toggle (AND by default).
• Daily sync moved to ~03:00 site time.

0.4.0

• Optional synchronization with the central shared blacklist (riskybuyer.com), opt-in and off by default.
• Settings tab: enable sync, server URL, API key, Sync now, Push my list.
• Checks are extended with cached server phone numbers; local entries always stay local.

0.3.0

• Internationalized: English source strings with full translation support; ships a Bulgarian (bg_BG) translation.
• Unique plugin prefix across classes, options, table, AJAX actions and hooks.
• Check tab now does partial (LIKE) matching on phone or name, newest first.
• Admin page moved under the WooCommerce menu (just before Settings).
• Declared HPOS compatibility; added uninstall cleanup and GPL license.

0.2.0

• Admin page reorganised into tabs: Check / List / Add.
• Check tab: exact match plus possible (partial) matches.
• Bulk add (one client per line; batch reason/note; existing entries skipped).
• Moved the admin page under the WooCommerce menu.
• Declared HPOS compatibility; load text domain.

0.1.0

• Initial release: storage-provider architecture, local table, matching by phone or name, orders-list flagging, order metabox, management page.