{"id":321375,"date":"2026-06-09T08:43:14","date_gmt":"2026-06-09T08:43:14","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/codefaeries-top-customers\/"},"modified":"2026-06-09T13:18:51","modified_gmt":"2026-06-09T13:18:51","slug":"codefaeries-top-customers","status":"publish","type":"plugin","link":"https:\/\/sv.wordpress.org\/plugins\/codefaeries-top-customers\/","author":15664861,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.4","stable_tag":"1.0.4","tested":"7.0","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"CodeFaeries Top Customers","header_author":"CodeFaeries","header_description":"Analyze and rank WooCommerce customers by revenue, orders, average cart, purchase frequency, and loyalty.","assets_banners_color":"e9f3ee","last_updated":"2026-06-09 13:18:51","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/codefaeries.com\/product\/top-customers\/","header_author_uri":"https:\/\/codefaeries.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":38,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.4":{"tag":"1.0.4","author":"lwsdevelopers","date":"2026-06-09 13:18:51"}},"upgrade_notice":{"1.0.4":"<p>Recommended update \u2014 clearer external-services disclosure and a hardened distribution package.<\/p>","1.0.3":"<p>Recommended update \u2014 minimum PHP lowered to 7.3 (runs on more hosts) and Plugin Check compliance.<\/p>","1.0.0":"<p>Initial public release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3565628,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3565628,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3565628,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3565628,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Top Customers dashboard with summary cards, charts, and the ranking table.","2":"Segment pills with live counts.","3":"Customer detail slide-over panel."}},"plugin_section":[],"plugin_tags":[232,567,7619,3654,286],"plugin_category":[36,45],"plugin_contributors":[147161],"plugin_business_model":[],"class_list":["post-321375","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-csv","plugin_tags-customers","plugin_tags-reports","plugin_tags-woocommerce","plugin_category-analytics","plugin_category-ecommerce","plugin_contributors-lwsdevelopers","plugin_committers-lwsdevelopers"],"banners":{"banner":"https:\/\/ps.w.org\/codefaeries-top-customers\/assets\/banner-772x250.png?rev=3565628","banner_2x":"https:\/\/ps.w.org\/codefaeries-top-customers\/assets\/banner-1544x500.png?rev=3565628","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/codefaeries-top-customers\/assets\/icon-128x128.png?rev=3565628","icon_2x":"https:\/\/ps.w.org\/codefaeries-top-customers\/assets\/icon-256x256.png?rev=3565628","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>CodeFaeries Top Customers adds a dedicated page under <strong>WooCommerce \u2192 Top Customers<\/strong> that ranks your shoppers so you can spot the customers who matter most at a glance.<\/p>\n\n<p><strong>Highlights<\/strong><\/p>\n\n<ul>\n<li>Sortable ranking table \u2014 revenue, order count, average cart, frequency, loyalty<\/li>\n<li>Summary cards \u2014 totals and per-customer averages for any date range<\/li>\n<li>Segment pills \u2014 At-Risk, New, VIP, Regular, One-Time (priority-evaluated)<\/li>\n<li>Charts \u2014 Top-10 revenue bar chart and revenue concentration doughnut<\/li>\n<li>Customer detail panel \u2014 recent orders, top products, profile link<\/li>\n<li>Date-range presets + custom range<\/li>\n<li>Live search, column visibility toggles, and CSV export<\/li>\n<li>HPOS-ready (automatic detection of High-Performance Order Storage)<\/li>\n<li>Active-subscriber awareness (WooCommerce Subscriptions optional)<\/li>\n<li>GDPR personal-data exporter and eraser<\/li>\n<\/ul>\n\n<p><strong>Only completed and processing orders are counted.<\/strong> Pending, on-hold, cancelled, refunded, and failed orders are excluded from rankings and totals.<\/p>\n\n<h3>Privacy &amp; Data<\/h3>\n\n<p>All customer ranking data is computed locally from your own WooCommerce database. The plugin does not contact any external service: no data ever leaves your site. Customer avatars are drawn locally from name initials, so no requests are made to third-party avatar providers.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to <code>\/wp-content\/plugins\/codefaeries-top-customers<\/code>, or install it directly from the WordPress admin interface.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu.<\/li>\n<li>Visit <strong>WooCommerce \u2192 Top Customers<\/strong>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"my%20totals%20differ%20from%20the%20woocommerce%20sales%20report.\"><h3>My totals differ from the WooCommerce sales report.<\/h3><\/dt>\n<dd><p>Top Customers only counts orders in the Completed or Processing status. Small differences from core reports are expected.<\/p><\/dd>\n<dt id=\"are%20guest%20orders%20included%3F\"><h3>Are guest orders included?<\/h3><\/dt>\n<dd><p>Yes. Guests are grouped by billing email. Customers without a billing email cannot be ranked.<\/p><\/dd>\n<dt id=\"does%20it%20handle%20multiple%20currencies%3F\"><h3>Does it handle multiple currencies?<\/h3><\/dt>\n<dd><p>No. Revenue is reported in your store's base currency without conversion.<\/p><\/dd>\n<dt id=\"what%20happens%20on%20uninstall%3F\"><h3>What happens on uninstall?<\/h3><\/dt>\n<dd><p>If \"Delete all plugin data when uninstalling\" is enabled on the Top Customers page, all options, transients, and scheduled events created by the plugin are removed. Otherwise, your settings are preserved so you can reinstall later.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.4 - 2026-05-18<\/h4>\n\n<ul>\n<li>Improved: customer avatars are now drawn locally from name initials \u2014 the plugin no longer contacts any external avatar service.<\/li>\n<li>Improved: distribution package hardened for the WordPress.org Plugin Directory.<\/li>\n<\/ul>\n\n<h4>1.0.3 - 2026-05-11<\/h4>\n\n<ul>\n<li>Compatibility: minimum PHP requirement lowered to 7.3 \u2014 the plugin now runs on a wider range of hosts.<\/li>\n<li>Code quality: passes WordPress Plugin Check cleanly.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fixed: removed repeated \"Invalid plugin file\" errors that WooCommerce logged on every admin request.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fixed: database queries hardened and graceful handling when optional dependencies are missing.<\/li>\n<li>Fixed: stability fixes at plugin startup \u2014 internal services now initialize reliably alongside the shared toolkit.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<p>First public release. CodeFaeries Top Customers ranks your WooCommerce customers by revenue, order count, and other lifetime metrics.<\/p>\n\n<ul>\n<li>Customer ranking dashboard with sortable columns and visual charts.<\/li>\n<li>Customer segments (top spenders, frequent buyers, and more).<\/li>\n<li>CSV export of the customer list.<\/li>\n<li>GDPR data exporter and eraser.<\/li>\n<li>HPOS and legacy order-table support.<\/li>\n<\/ul>","raw_excerpt":"Rank WooCommerce customers by revenue, orders, average cart, purchase frequency, and loyalty \u2014 with segments, charts, and CSV export.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/321375","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=321375"}],"author":[{"embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/lwsdevelopers"}],"wp:attachment":[{"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=321375"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=321375"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=321375"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=321375"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=321375"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/sv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=321375"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}