=== 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
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Requires at least: 3.8
Tested up to: 4.7.2
Stable tag: 0.9.7

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).

= 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**.

= 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.7 - 2017/02/16 =
* Changed references to `$product` properties to calls to public methods such as `get_id()` and `get_title()`. This is in preparation for WooCommerce 2.7.

= 0.9.6 - 2016/09/27 =
* Optimized merchant logo display. (#13884, #13881)

= 0.9.5 - 2016/08/05 =
* Replaced `intval()` with `sanitize_text_field()` on the source ID because 32 bit systems were converting long IDs to 2147483647. More info http://stackoverflow.com/a/25910134.

= 0.9.4 - 2016/08/01 =
* Added support for `asin` and `isbn` to be passed along as shortcode attributes for Amazon searches.

= 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*