=== Where Heard for WooCommerce ===
Contributors: davetgreen, mkdo
Tags: woocommerce, marketing, referrals
Requires at least: 4.3
Tested up to: 4.7.5
Stable tag: 1.1.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A plugin for WooCommerce that empowers shop owners to find out exactly where their orders are coming from, by asking customers to provide feedback.

== Description ==

Knowing exactly where your customers are coming from is crucial when developing your ongoing marketing strategy. Capturing this information when your customers place orders on your website should be high on your list of priorities.

Where Heard for WooCommerce removes the need for any bespoke development to add this feature. Once installed, the plugin offers the following functionality:

- A new section is added to the checkout with a customisable dropdown containing a list of options for them to choose from, as well as an optional explanation.
- Configurable settings added to the *Products* tab in the WooCommerce settings:
    - Checkbox to enable/disable the feature
    - Label for the dropdown e.g. 'Please tell us how you find our website.'
    - Heading field for the Where Heard section at the checkout (optional, defaults to 'How did you hear about us?')
    - Description field to explain the reason for the question to the customer.
- Where Heard column added to the *Orders* screen containing the option the customer selected.
- The option the customer selected will be added to the order details section of the *Edit Order* screen and will also be added to order confirmation email that is sent to the shop administrator.
- Where Heard column and associated data will be added automatically to CSV files exported using the WooCommerce [Order/Customer CSV Export](http://www.woothemes.com/products/ordercustomer-csv-export/) plugin.

Where Heard for WooCommerce is also fully translatable: both in the admin area and on the front-end.

== Requirements ==

Where Heard for WooCommerce requires at least WooCommerce 2.2.3 to function correctly. Tested up to version 3.0.8.

== Installation ==

1. Upload `where-heard-for-woocommerce` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure the plugin in the 'Products' tab of the WooCommerce settings

== Changelog ==

= 1.1.2 =
* Version bump and readme updates after testing with latest WordPress and WooCommerce versions. Added new icon/banner.

= 1.1.1 =
* Refactored repository to work with Git to SVN deploy script.

= 1.1.0 =
* Refactored to comply with WordPress.org repo rules.

= 1.0.0 =
* First stable release.

== Known Issues ==

Due to the fact that WooCommerce core is missing the ability to use the `woocommerce_get_settings_` filter to add settings to either the *checkout* or *tax* tabs we're having to put them in the *Products* tab for now.

Adding a dedicated tab just for this plugin's settings is overkill, so it's unlikely that this particular workaround will be implemented in the meantime.

Any future update to the plugin that changes the tab in which the settings can be found will have no impact on your saved settings or any of the advertised functionality.

== Roadmap ==

= 1.2.0 =
* Add a new section in WooCommerce->Reports with data providing a summary of all referral sources over the specified time period.

= 1.3.0 =
* Add a dashboard widget to show the data made available in 1.3.0.