# WooCommerce Top Customers

Adds the shortcode [wc_top_customers] to WooCommerce and shows a list of customers ordered by the number of their completed orders.

## Usage

`[wc_top_customers number="12" columns="4" orderby="meta_key" orderby_meta_key="_order_count" order="asc" role="customer"]`

## Shortcode Parameters

* **number**: The maximum number of customers to show. Default *12*
* **columns**: The number of columns to use for the grid. Default *4*
* **orderby**: The order key used to show customers. Default *meta_key*
* **orderby_meta_key**: Order customers by orders count (_order_count) or money spent(_money_spent). Default *_order_count*
* **order**: Shows customer in ascending or descending order. Default *asc*
* **role**: Show customers with the role assigned to this attribute. Default *customer*

## Support
For any support request, please create a new issue [here](https://github.com/PinchOfCode/woocommerce-top-customers/issues).

**Note**: since the free nature of this plugin, the support may be discontinuous, but all the requests are checked and replied. We suggest to write on [GitHub](https://github.com/PinchOfCode/woocommerce-top-customers/issues) to get faster support.

## Installation

### WP Installation

1. Go to Plugins > Add New > Search
2. Type WooCommerce Top Customers in the search box and hit Enter
3. Click on the button Install and then activate the plugin

### Manual Installation

1. Upload `woocommerce-top-customers` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress


## Changelog

### 1.0.0
* First release

## License
Copyright (C) 2014 Pinch Of Code. All rights reserved.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.