# Where Heard for WooCommerce
A plugin for WooCommerce that empowers shop owners to find out exactly where their orders are coming from by asking customers to provide feedback as to how they found the website.

## 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 the `where-heard-for-woocommerce` folder 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

## 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** - *~July 2017*
- Add a new section in WooCommerce->Reports with data providing a summary of all referral sources over the specified time period.

**1.3.0** - *~Aug 2017*
- Add a dashboard widget to show the data made available in 1.3.0.

## Changelog

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

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

**1.1.0** - *30.12.2015*
- Refactored to comply with WordPress.org repo rules.

**1.0.0** - *15.09.2015*
- First stable release.