=== AffiStyle - Affiliate Product Cards & Box Builder ===
Contributors: Dreainno
Donate link: https://affistyle.shop
Tags: affiliate, affiliate box, amazon affiliate, link cloaking, ftc disclosure
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create affiliate product boxes, review cards, and track clicks locally with link cloaking and FTC compliance.

== Description ==

AffiStyle is an affiliate marketing plugin for bloggers, product reviewers, and content creators. Easily build responsive affiliate product boxes, review cards, pros and cons lists, and rating badges directly within WordPress.

Whether you run an affiliate review site, technology blog, or comparison portal, AffiStyle helps you showcase product recommendations cleanly using structured cards and local click tracking.

### 🚀 Key Features

* **Affiliate Box Builder**: Create product boxes for Amazon Associates, ShareASale, CJ Affiliate, Impact, ClickBank, or custom affiliate programs.
* **Link Cloaking**: Clean, professional branded outbound URLs (e.g., `yoursite.com/recommends/product-name`) with automatic 302 redirects.
* **FTC Micro-Disclosure Compliance**: Automatic affiliate disclosure notices under product cards, paired with SEO-friendly `rel="nofollow sponsored noopener"` and `target="_blank"` link attributes.
* **Built-in Local Click Analytics**: Track total affiliate link clicks with 7/30/60/90-day and custom date range filters, top-performing product cards, and visitor country demographics locally in your database with zero third-party tracking scripts.
* **Native Gutenberg Block & Shortcode**: Insert product boxes anywhere using the native Gutenberg block or standard shortcode `[affistyle_box id="123"]`.
* **Schema.org Rich Snippets**: Integrated JSON-LD AggregateRating and Product schema structured data for search engine rich snippets.
* **Read-Only Star Ratings & Pros/Cons Lists**: Display visual star ratings (0.0 to 5.0), custom review counts, and styled pros/cons highlights.
* **Custom Color Palette Controls**: Customize card background colors and primary CTA button colors to match your theme's brand identity.

== Installation ==

### Automatic Installation (Recommended)
1. Log in to your WordPress Admin Dashboard.
2. Go to **Plugins > Add New**.
3. Search for **AffiStyle**.
4. Click **Install Now** and then **Activate**.

### Manual Installation
1. Download the `affistyle.zip` archive.
2. Log in to your WordPress Dashboard and navigate to **Plugins > Add New > Upload Plugin**.
3. Choose the downloaded ZIP file and click **Install Now**.
4. Activate the plugin through the **Plugins** menu.

== Frequently Asked Questions ==

= Is AffiStyle compliant with FTC Affiliate Disclosure Guidelines? =
Yes! AffiStyle automatically appends FTC micro-disclosure notices beneath affiliate cards and attaches `rel="nofollow sponsored noopener"` attributes to all CTA links.

= Does link cloaking affect SEO? =
No. Cloaked links send proper HTTP `302` temporary redirect status codes alongside `X-Robots-Tag: noindex, nofollow` headers to instruct search engine bots not to index affiliate tracking links.

= How do I insert an Affiliate Box into a post or page? =
You can insert boxes using the native Gutenberg block (**Affiliate Box**) from the block library or using the shortcode `[affistyle_box id="YOUR_BOX_ID"]` anywhere shortcodes are supported (Elementor, Beaver Builder, Divi, Classic Editor).

= Is visitor data sent to third-party tracking servers? =
No. AffiStyle tracks affiliate clicks locally inside your WordPress database (`wp_affistyle_clicks`). No visitor IP addresses or data are sent to external analytics servers.

== Screenshots ==

1. Affiliate Box Builder editor interface with title, destination URL, star ratings, pros/cons, and color controls.
2. All Affiliate Boxes management screen showing shortcodes, cloaked links, and template assignments.
3. Native Gutenberg block inserter searching for the Affiliate Box block.
4. Block inspector panel for selecting card styles and customizing display parameters.
5. Saving and publishing the WordPress blog post with the embedded Affiliate Box.
6. Frontend rendering of Style 1 (Modern Product Card) with badges, review stars, and CTA button.
7. Local Click Analytics dashboard showing aggregate clicks, top-performing cards, and geographic demographics.
8. Frontend rendering of Style 2 (Minimalist Review Box) ideal for sidebars and compact summaries.

== Changelog ==

= 1.0.0 =
* Initial official release on WordPress.org.
* Feature: Standalone Affiliate Card CPT (`affistyle_box`) with custom metabox builder.
* Feature: Style 1 (Modern Product Card) and Style 2 (Minimalist Review Box) templates.
* Feature: Smart Link Cloaking engine (`/recommends/slug/`).
* Feature: FTC micro-disclosure engine & automated link compliance attributes (`rel="nofollow sponsored noopener"`).
* Feature: Local click tracking & country-level analytics dashboard with 7/30/60/90-day and custom date range filters.
* Feature: Gutenberg block and shortcode integration `[affistyle_box id="..."]`.
* Feature: Schema.org Product & AggregateRating JSON-LD metadata generation.

== Upgrade Notice ==

= 1.0.0 =
Initial release of AffiStyle Free - Affiliate Product Cards & Box Builder.