Title: CodeFaeries Top Customers
Author: Long Watch Studio - Code Faeries
Published: <strong>9 de junio de 2026</strong>
Last modified: 3 de julio de 2026

---

Buscar plugins

![](https://ps.w.org/codefaeries-top-customers/assets/banner-772x250.png?rev=3565628)

![](https://ps.w.org/codefaeries-top-customers/assets/icon-256x256.png?rev=3565628)

# CodeFaeries Top Customers

 Por [Long Watch Studio – Code Faeries](https://profiles.wordpress.org/lwsdevelopers/)

[Descargar](https://downloads.wordpress.org/plugin/codefaeries-top-customers.1.0.5.zip)

 * [Detalles](https://es-mx.wordpress.org/plugins/codefaeries-top-customers/#description)
 * [Opiniones](https://es-mx.wordpress.org/plugins/codefaeries-top-customers/#reviews)
 *  [Instalación](https://es-mx.wordpress.org/plugins/codefaeries-top-customers/#installation)
 * [Desarrollo](https://es-mx.wordpress.org/plugins/codefaeries-top-customers/#developers)

 [Soporte](https://wordpress.org/support/plugin/codefaeries-top-customers/)

## Descripción

CodeFaeries Top Customers adds a dedicated page under **WooCommerce  Top Customers**
that ranks your shoppers so you can spot the customers who matter most at a glance.

**Highlights**

 * Sortable ranking table — revenue, order count, average cart, frequency, loyalty
 * Summary cards — totals and per-customer averages for any date range
 * Segment pills — At-Risk, New, VIP, Regular, One-Time (priority-evaluated)
 * Charts — Top-10 revenue bar chart and revenue concentration doughnut
 * Customer detail panel — recent orders, top products, profile link
 * Date-range presets + custom range
 * Live search, column visibility toggles, and CSV export
 * HPOS-ready (automatic detection of High-Performance Order Storage)
 * Active-subscriber awareness (WooCommerce Subscriptions optional)
 * GDPR personal-data exporter and eraser

**Only completed and processing orders are counted.** Pending, on-hold, cancelled,
refunded, and failed orders are excluded from rankings and totals.

### Privacy & Data

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.

## Instalación

 1. Upload the plugin files to `/wp-content/plugins/codefaeries-top-customers`, or 
    install it directly from the WordPress admin interface.
 2. Activate the plugin through the **Plugins** menu.
 3. Visit **WooCommerce  Top Customers**.

## Preguntas frecuentes

### My totals differ from the WooCommerce sales report.

Top Customers only counts orders in the Completed or Processing status. Small differences
from core reports are expected.

### Are guest orders included?

Yes. Guests are grouped by billing email. Customers without a billing email cannot
be ranked.

### Does it handle multiple currencies?

No. Revenue is reported in your store’s base currency without conversion.

### What happens on uninstall?

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.

## Reseñas

No hay reseñas para este plugin.

## Colaboradores y desarrolladores

Este software es de código abierto. Las siguientes personas han contribuido a este
plugin.

Colaboradores

 *   [ Long Watch Studio – Code Faeries ](https://profiles.wordpress.org/lwsdevelopers/)

[Traduce “CodeFaeries Top Customers” a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/codefaeries-top-customers)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/codefaeries-top-customers/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/codefaeries-top-customers/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/codefaeries-top-customers/)
por [RSS](https://plugins.trac.wordpress.org/log/codefaeries-top-customers/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 1.0.5 – 2026-06-19

 * Improved: usage tracking has been removed entirely from the free plugin — it 
   no longer collects any data or contacts external services.
 * Improved: the contextual help tab and readme now state clearly that the plugin
   makes no outbound network requests — all processing stays on your site.
 * Improved: simplified the admin navigation by removing the locked Pro teaser tabs.
 * Improved: refreshed the bundled charting library to the latest version.

#### 1.0.4 – 2026-05-18

 * Improved: customer avatars are now drawn locally from name initials — the plugin
   no longer contacts any external avatar service.
 * Improved: documentation now lists the opt-in telemetry service the plugin can
   contact.
 * Improved: distribution package hardened for the WordPress.org Plugin Directory.

#### 1.0.3 – 2026-05-11

 * Compatibility: minimum PHP requirement lowered to 7.3 — the plugin now runs on
   a wider range of hosts.
 * Code quality: passes WordPress Plugin Check cleanly.

#### 1.0.2

 * Fixed: removed repeated “Invalid plugin file” errors that WooCommerce logged 
   on every admin request when the plugin runs alongside its Pro add-on.

#### 1.0.1

 * Fixed: database queries hardened and graceful handling when optional dependencies
   are missing.
 * Fixed: stability fixes at plugin startup — internal services now initialize reliably
   alongside the shared toolkit.
 * Fixed: correct loading when the plugin runs alongside its Pro add-on.

#### 1.0.0

First public release. CodeFaeries Top Customers ranks your WooCommerce customers
by revenue, order count, and other lifetime metrics.

 * Customer ranking dashboard with sortable columns and visual charts.
 * Customer segments (top spenders, frequent buyers, and more).
 * CSV export of the customer list.
 * GDPR data exporter and eraser.
 * Opt-in anonymized telemetry.
 * HPOS and legacy order-table support.

## Meta

 *  Versión **1.0.5**
 *  Última actualización **hace 14 horas**
 *  Instalaciones activas **Menos de 10**
 *  Versión de WordPress ** 6.0 o superior **
 *  Probado hasta **7.0**
 *  Versión de PHP ** 7.4 o superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/codefaeries-top-customers/)
 * Etiquetas:
 * [analytics](https://es-mx.wordpress.org/plugins/tags/analytics/)[csv](https://es-mx.wordpress.org/plugins/tags/csv/)
   [customers](https://es-mx.wordpress.org/plugins/tags/customers/)[reports](https://es-mx.wordpress.org/plugins/tags/reports/)
   [woocommerce](https://es-mx.wordpress.org/plugins/tags/woocommerce/)
 *  [Vista avanzada](https://es-mx.wordpress.org/plugins/codefaeries-top-customers/advanced/)

## Valoraciones

Aún no se han enviado valoraciones.

[Your review](https://wordpress.org/support/plugin/codefaeries-top-customers/reviews/#new-post)

[Ver todas las valoraciones](https://wordpress.org/support/plugin/codefaeries-top-customers/reviews/)

## Colaboradores

 *   [ Long Watch Studio – Code Faeries ](https://profiles.wordpress.org/lwsdevelopers/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/codefaeries-top-customers/)