=== CategoView for Amazon ===

Contributors: penguinpluginlabs, freemius
Tags: amazon, affiliate, api, blocks, widget
Requires at least: 6.3
Requires PHP: 7.0
Tested up to: 7.1
Stable tag: 3.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Description ==

**Simple setup → Select an Amazon category → Automatically display multiple products → Carousel → Auto updates → Set and forget.**

CategoView for Amazon lets you display multiple products from a selected Amazon category in a carousel on your WordPress site using the Amazon Creators API.

No need to select products one by one. CategoView retrieves product information, saves it as a catalog, and keeps the catalog updated automatically.

== Features ==

=== Free ===

* Simple setup
* Amazon category-based product retrieval
* Up to 5 products in one carousel
* Automatic catalog updates
* Ranking display
* Gutenberg block
* WordPress widget
* Multiple Amazon marketplaces

=== Pro ===

* Up to 5 product categories
* 5 / 10 / 15 / 20 products
* Random display
* Text color customization
* Background color customization

== How it works ==

1. **Select an Amazon category**
   Enter the Browse Node ID of the Amazon category you want to display.

2. **CategoView automatically retrieves products**
   CategoView retrieves product information from the Amazon Creators API and creates a product catalog.

3. **Display the carousel on your site**
   Add the CategoView carousel using a Gutenberg block or widget. No individual product selection or manual updates are required.

== Requirements ==

* WordPress 6.3 or later
* PHP 7.0 or later
* Amazon Associates account
* Amazon Creators API credentials

== Setup ==

1. Install and activate CategoView for Amazon.
2. Enter your Amazon Creators API credentials.
3. Select an Amazon marketplace and enter your Associate Tag.
4. Enter a Browse Node ID.
5. Add the CategoView carousel to your site.

**That's it. CategoView handles product retrieval and automatic updates for you.**

== Display ==

CategoView can be displayed using either:

* **Gutenberg block** — Add the CategoView carousel directly to your posts or pages.
* **Widget** — Display the carousel in a widget area supported by your theme.

== Automatic updates ==

CategoView automatically updates the product catalog at regular intervals using the Amazon Creators API.

Once configured, no manual product selection or update is required.

== Amazon Creators API ==

CategoView uses the **Amazon Creators API** to retrieve product information from Amazon.

An Amazon Associates account and valid API credentials are required.

== External Services ==

=== Amazon Creators API ===

CategoView for Amazon connects to Amazon through the Amazon Creators API to retrieve product information.

The plugin sends the Amazon Creators API credentials entered in the plugin settings, along with the selected Amazon marketplace, Associate Tag, and Browse Node ID, as required for authentication and product retrieval.

Product information returned by Amazon is saved as a catalog on your WordPress site and used to display products on the front end.

Use of the Amazon Creators API is subject to the Amazon Associates Program and other applicable Amazon terms and licenses for each marketplace.

For more information, see:

* [Amazon Creators API Documentation](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/introduction)
* [Amazon Associates Program Operating Agreement](https://affiliate-program.amazon.com/help/operating/agreement/)
* [Amazon.com Privacy Notice](https://www.amazon.com/gp/help/customer/display.html?nodeId=GX7NJQ4ZB8MHFRNJ)

== Frequently Asked Questions ==

= What is a Browse Node ID? =

A Browse Node ID is an identifier used by Amazon to identify a product category or subcategory.

= Where can I find the Browse Node ID? =

The Browse Node ID can be found in the URL of an Amazon product category or ranking page.

= What is an Associate Tag? =

An Associate Tag is an identifier issued through the Amazon Associates Program. Enter the tag associated with the Amazon marketplace you want to use.

= Why are products from outside the selected category sometimes displayed? =

Depending on the Amazon API response, products related or adjacent to the selected category may be included in the results.

= When is the catalog updated? =

The catalog is initially updated when you click Update Catalog. After that, it is updated automatically according to the scheduled update. it is updated automatically according to the scheduled update.

= What happens if a catalog update fails? =

The existing catalog is preserved, and the update error is recorded.

= How many products can be displayed? =

The Free version can display up to 5 products from one product category.

The Pro version can register up to 5 product categories and display 5, 10, 15, or 20 products.

== Screenshots ==

1. Settings — Configure Amazon API credentials and product category settings.
2. Catalog — View the saved product catalog.
3. Gutenberg — Insert the CategoView Amazon Carousel block.
4. Carousel — Display Amazon products in a carousel on the front end.

== Changelog ==

= 3.0.0 =

* Unified the Free and Pro releases into a single Freemius deployment source.
* Separated Free and Pro functionality through Freemius premium-only code handling.

= 2.4.4 =

* Added Freemius premium-only markers for Pro features and Free/Premium code separation.

= 2.4.1 =

* Reordered the admin tabs to Settings, Pro, and FAQ.

= 2.4.0 =

* Moved Pro-only display settings to the Pro tab.
* Kept Amazon API settings and product categories in the Settings tab.
* Updated plugin directory tags.

= 2.3.0 =

* Added Pro support for up to 5 product categories.
* Added category selection for the Gutenberg block and WordPress widget.
* Existing single-category settings and catalog data are migrated automatically.

= 2.2.0 =

* Added Pro text color and background color settings for the carousel.
* Applied saved colors to the Gutenberg block preview and front-end carousel.

= 2.1.0 =

* Added Pro Ranking and Random display methods.
* Randomized catalog order is saved at catalog update time.
* Added Pro display count options up to 20 products.

= 1.0.0 =

* Initial public release.
* Amazon Creators API integration.
* Support for multiple Amazon marketplaces.
* Browse Node ID-based product category selection.
* Automatic product catalog updates.
* Gutenberg block support.
* WordPress widget support.
* Product carousel display.
* Up to 5 products per category.

== License ==

CategoView for Amazon is licensed under the GPL-2.0-or-later license.
