=== Export Customers Data ===
Contributors: fahadmahmood, invoicepress  
Tags: woocommerce, csv export, analytics, customer data, order history 
Requires at least: 4.4  
Tested up to: 6.9  
Stable tag: 1.2.7  
Requires PHP: 7.0  
License: GPL2  
License URI: http://www.gnu.org/licenses/gpl-2.0.html  

Easily export WooCommerce customers' data to CSV or XLSX with advanced filters and smart field support.

== Description ==

This plugin allows you to export WooCommerce customer data with full flexibility. Whether you need email lists, order history, customer lifetime value, or any other detail — this plugin gives you control over what to export, and how.

**Features:**
* Export customers in CSV or XLSX format
* Include custom user meta fields
* Support for WooCommerce Analytics fields like `total_spend`, `orders_count`, etc.
* Smart field mapping (like `phone`, `address`, `name`)
* Apply filters (date range, country, payment method, role, etc.)
* Built-in support for special fields not available in user meta
* Works great even with large stores using AJAX-based chunk exports

**Author:** [Fahad Mahmood](https://www.androidbubbles.com/contact)  
**Project URI:** <https://androidbubble.com/blog/wordpress/plugins/export-customers-data>

= Tags =  
woocommerce, orders, users, customers, data, export, analytics, filters, user meta

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory or install through the Plugins menu.
2. Activate it via the Plugins screen in WordPress.
3. Go to **WooCommerce → Export Customers** to begin exporting.

== Frequently Asked Questions ==

1. **How to export customer data?**  
   Go to **WooCommerce → Export Customers**, select the fields and filters you want, and click Export.

2. **Can I export custom meta fields?**  
   Yes. The plugin detects and includes user meta fields, or you can add them manually.

3. **Is `total_spend` and `orders_count` available?**  
   Yes. These are pulled from WooCommerce Analytics and can be selected as export fields.

4. **What format is the export in?**  
   Both **CSV** and **XLSX** formats are supported for different needs (bulk or quick exports).

== Screenshots ==

1. Export Customers menu under WooCommerce.
2. Field and filter options on the settings screen.

== Changelog ==
= 1.2.7 =
* Fix: Fields export revised. [07/03/2026]
= 1.2.6 =
* New: Smart field mapping (`phone`, `address`, etc.)
* New: Support for WooCommerce Analytics fields (`total_spend`, `orders_count`, etc.)
* New: Advanced filter system (by country, order date, payment method, and more)
* Improved: Export UX and chunk-based performance for large data

= 1.2.5 =
* Minor fixes and improvements

= 1.2.4 =
* Fix: WordPress sanitization and escaping improvements [Thanks Tiffany T. / Wordfence]

= 1.2.2 =
* Security checklist review [08/02/2024]

= 1.2.1 =
* Version compatibility updated

= 1.0 =
* Initial release

== Upgrade Notice ==

= 1.2.7 =
Major upgrade with analytics integration, smart fields, and advanced filtering.

== License ==

This plugin is licensed under the GNU General Public License v2 or later.  
You may modify and redistribute it freely, but without any warranty.  
See http://www.gnu.org/licenses/gpl-2.0.html for full terms.