=== Datafeedr Comparison Sets ===

Contributors: datafeedr.com
Donate link: http://www.datafeedr.com/
Tags: comparison, comparison sets, compsets, price, price comparison, price compare, price comparison set, datafeedr, affiliate products, dfrapi, adrecord, adtraction, affiliate window, familyblend, affilinet, amazon local, APD, avangate, avantlink, belboon, betty mills, cj, clickbank, clixgalore, commission factory, commission junction, daisycon, flipkart, impact radius, linkconnector, linkshare, onenetworkdirect, optimise, paid on results, partner-ads, pepperjam, mycommerce, revresponse, shareasale, superclix, tradedoubler, tradetracker, webgains, zanox
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Requires at least: 3.8
Tested up to: 4.5
Stable tag: 0.9.3

Automatically create price comparison sets for your WooCommerce products or by using a shortcode.

== Description ==

The Datafeedr Comparison Set plugin automatically creates price comparison sets for any product in your WooCommerce store or by using a shortcode.

> **Heads-up!** — This plugin requires that you have an active subscription to one of our API plans. Purchase a subscription [here](https://members.datafeedr.com/subscribe/api?utm_campaign=dfrapiplugin&utm_medium=referral&utm_source=wporg).

= Screenshots =

View screenshots [here](https://wordpress.org/plugins/datafeedr-comparison-sets/screenshots/).

= Installation & Configuration =

View the set-up guide [here](https://wordpress.org/plugins/datafeedr-comparison-sets/installation/).

= WooCommerce Integration =

You can find usage instructions for WooCommerce [here](https://wordpress.org/plugins/datafeedr-comparison-sets/installation/).

= Shortcode Usage =

You can find shortcode examples [here](https://wordpress.org/plugins/datafeedr-comparison-sets/installation/).

== Installation ==

> **[IMPORTANT] Before You Begin**
>
> This plugin requires that you have installed and activated the [Datafeedr API plugin](https://wordpress.org/plugins/datafeedr-api/). The following instructions will assume that you have installed the [Datafeedr API plugin](https://wordpress.org/plugins/datafeedr-api/) and selected your affiliate networks and merchants. Installation and configuration instructions can be found [here](https://wordpress.org/plugins/datafeedr-api/installation/).

= API Usage =

Please know that the generating or updating of a single comparison set will require between 2 and 6 API requests. If you are using the API **Starter Plan**, consider [upgrading](https://members.datafeedr.com/api?utm_campaign=dfrapiplugin&utm_medium=referral&utm_source=wporg) to the **Basic Plan**.

= Plugin Installation =

1. Upload the `datafeedr-comparison-sets` folder to the `/wp-content/plugins/` directory.
1. Activate the *Datafeedr Comparison Sets* plugin through the 'Plugins' menu in WordPress.
1. Configure here: WordPress Admin Area > Datafeedr API > Comparison Sets.

= Enabling Amazon Products =

If you want Amazon products to appear in your comparison sets, do the following:

1. Go here WordPress Admin Area > Datafeedr API > Configuration > Amazon Settings.
1. Add your Amazon Access Key ID, Secret Access Key, Tracking ID and Locale.
1. Click the [Save Changes] button at the bottom of the page.
1. Go here WordPress Admin Area > Datafeedr API > Comparison Sets.
1. Change the **Cache Lifetime** field to `86400`.
1. Click the [Save Changes] button at the bottom of the page.

= Display Comparison Sets for WooCommerce Products =

To display comparison sets for products in your WooCommerce store, follow these instructions.

1. Go here WordPress Admin Area > Datafeedr API > Comparison Sets > Integrations.
1. Check the **WooCommerce** option.
1. Click the [Save Changes] button at the bottom of the page.

Now, when a product in your store is viewed for the first time, a price comparison set will be generated.

*Note: Enabling WooCommerce integration will not generate price comparison sets for all products in your store immediately. Sets will only be generated when the product is viewed for the first time.*

= Display Comparison Sets using Shortcodes =

To display comparison sets in your posts, pages or in other areas where WordPress shortcodes are allowed, use the formats below.


Create a price comparison set using name field:
`
[dfrcs name="baratza encore"]
`

Create a price comparison set using name and brand field:
`
[dfrcs name="j8006" brand="omega" ]
`

Create a price comparison set with a custom title:
`
[dfrcs name="chaos harness" brand="black diamond" title="{num_products} great deals on Black Diamond Chaos Harnesses"]
`

Create a price comparison set using `onsale` filter:
`
[dfrcs name="farpoint 55" brand="osprey" filters="onsale=1"]
`

Create a price comparison set using currency filter:
`
[dfrcs name="aeropress coffee maker" brand="aerobie" filters="currency=USD"]
`

Create a price comparison set using multiple filters:
`
[dfrcs name="nomad 20 solar panel" filters="currency=USD&finalprice_max=400"]
`

== Frequently Asked Questions ==

= Where can I get help?  =

Feel free to contact us [here](https://datafeedrapi.helpscoutdocs.com/contact?utm_campaign=dfrapiplugin&utm_medium=referral&utm_source=wporg).

== Screenshots ==

1. This is a price comparison set automatically generated for a product in a WooCommerce store.
2. This is a price comparison set automatically generated using a shortcode.
3. This is the configuration page of the Datafeedr Comparison Sets plugin.

== Changelog ==

= 0.9.3 - 2016/04/04 =
* Initial PUBLIC release.
* Clarified help texts on configuration page.
* Updated readme.txt for WordPress repository.

= 0.9.2 - 2016/03/21 =
* Changed format of URL to merchant logos to new format `https://images.datafeedr.com/m/nnn.jpg`. (#12900)

= 0.9.1 - 2016/03/09 =
* Fixed currency sign position for products with sign of "kr".

= 0.9.0 - 2016/03/07 =
* Initial BETA release.

== Upgrade Notice ==

*None*