AffiStyle Complete Documentation

Free 1. Installation & Setup

AffiStyle Core is 100% free open-source software under GPL-2.0, hosted on the official WordPress.org plugin directory. Tested up to WordPress 7.1 and PHP 7.4–8.3+.

1. Log in to your WordPress Admin Dashboard.
2. Navigate to Plugins → Add New Plugin.
3. Search for AffiStyle in the search bar.
4. Click Install Now, and once installed, click Activate.
5. A new Affiliate Boxes menu item will appear in your admin sidebar.

Free v1.1 2. Quick-Fill Product URL Grabber (0 API Keys Required)

Stop wasting time manually copying product titles, downloading images, and looking up prices. AffiStyle Free v1.1.0 introduces the **Quick-Fill Product URL Grabber** requiring 0 Amazon PA-API keys or AWS credentials.

1. Go to Affiliate Boxes → Add New Box in your WordPress dashboard.
2. In the Quick-Fill Amazon Product URL field at the top of the metabox, paste any standard Amazon URL or amzn.to shortlink.
3. Click the Fetch Info button.
4. AffiStyle automatically parses and populates:
   • Product Title: Clean, trimmed headline product name.
   • High-Resolution Product Image: Direct CDN image URL with auto-calculated aspect ratio.
   • Current Price: Product price (e.g. $29.99) inserted into the native Price field.
5. Add your own affiliate tag to the destination URL, customize rating stars and pros/cons, and click Publish.

Free v1.1 3. 1-Click Multi-Plugin Importer & Migration Engine

Switching from bulky, expensive, or abandoned affiliate plugins? AffiStyle v1.1.0 includes an automated migration wizard under AffiStyle → Importer.

AffiStyle automatically scans your database for links and product boxes from 8 supported plugins:

• Lasso (Lite & Pro editions)
• AAWP (Amazon Affiliate for WordPress)
• Pretty Links
• ThirstyAffiliates
• Easy Affiliate Links
• EasyAzon
• AmaLinks Pro
• Earnist

How to Migrate:

1. Navigate to AffiStyle → Importer.
2. Click Scan Existing Plugins to view detected affiliate links and cards.
3. Review the migration preview table showing source plugin, title, destination URL, and product image.
4. Click Import All Cards (or select individual cards). AffiStyle converts all entries into native affistyle_box cards while fully preserving your original affiliate tags, cloaked slugs, and tracking parameters.

Free 4. Card Builder & Native Price Display

Each affiliate card is configured once in your admin dashboard and can be embedded across hundreds of blog posts simultaneously.

1. Go to Affiliate Boxes → Add New Box.
2. Enter a descriptive admin title (e.g., "Sony WH-1000XM5 Headphone Card").
3. In the Product 1 Details section, configure:
   • Product Title: Customer-facing headline name.
   • Native Price Field (New in v1.1): Enter formatted price (e.g. $149.00). Rendered prominently in Style 1 & Style 2.
   • Product Image: Media Library image or auto-grabbed image URL with fixed aspect ratio.
   • Description: 2–3 concise sentences highlighting key benefits.
   • Affiliate Link: Raw affiliate link (will be cloaked automatically).
   • CTA Button Text: e.g., "Check Price on Amazon →".
   • Star Rating & Badges: Numeric score (0.0 to 5.0) and highlight pill (e.g. "#1 Top Pick").
   • Pros & Cons: Line-separated positive checkmarks and negative points.
4. Under Template Style, select Style 1 (Modern Product Card) or Style 2 (Minimalist Review Box).
5. Click Publish.

Free v1.1 5. Gutenberg Blocks, Copyable Shortcodes & Admin Quick Preview

AffiStyle makes previewing and embedding cards effortless:

• Admin Quick Preview Modal (New in v1.1): In the Affiliate Boxes admin list table, hover any card and click Quick Preview. An interactive responsive modal opens with:
  • Desktop Viewport (100%): Test full-width column rendering.
  • Tablet Viewport (768px): Verify medium tablet breakpoint layout.
  • Mobile Viewport (375px): Inspect mobile button stacking and text wrap.
• 1-Click Copyable Shortcodes (New in v1.1): Click the shortcode badge directly in the admin list column to copy [affistyle_box id="123"] to your clipboard.
• Native Gutenberg Block: In any post or page, click the + block inserter, search for Affiliate Box, and choose your card from the live visual dropdown.

Free 6. Link Cloaking & Automated FTC Compliance

AffiStyle protects both your SEO rankings and legal compliance automatically:

• Branded Outbound URLs: Raw affiliate links are cleanly cloaked under your domain:

  https://yourdomain.com/recommends/sony-headphones/

  Using HTTP 302 temporary redirects with X-Robots-Tag: noindex, nofollow headers.
• Automated FTC Micro-Disclosure: A compliant notice ("We may earn an affiliate commission when you purchase through links on our site") is appended beneath each card.
• SEO Safe Attributes: All outbound buttons enforce rel="nofollow sponsored noopener" and target="_blank".

Free v1.1 7. Local Click Analytics & Native Canvas Line Chart

AffiStyle features a built-in, 100% privacy-compliant click tracking dashboard under AffiStyle → Analytics:

• Interactive Time-Series Line Chart: Rendered using a native HTML5 canvas engine with zero external CDN dependencies or tracking scripts. Fast, lightweight, and 100% GDPR compliant.
• Flexible Date Range Filters: Filter click trends by 7 Days, 30 Days, 60 Days, 90 Days, or custom date pickers.
• Top-Performing Product Cards: See which cards generate the highest click-through volumes.
• Country Demographics: View country-level visitor distributions without storing visitor IP addresses in cookies.

Free v1.2 8. Sitewide Keyword Auto-Linker & Revenue Velocity Engine

Monetize historical blog posts automatically without manually editing hundreds of legacy articles:

• Tag-Safe Text Tokenizer: Scans editorial content and converts specified product mentions into cloaked affiliate links without corrupting HTML tags, attributes, images, or headings.
• Up to 3 Target Keywords per Card: Specify up to three distinct high-intent anchor keywords directly inside the Free metabox.
• Anti-Spam Density Throttling: Enforces an intelligent cap of 1–2 auto-links per post to keep content organic, readable, and Google search-friendly.
• Zero Query Overhead Transient Indexing: Target keywords and card routes are cached in-memory using WordPress transients, ensuring zero extra SQL query overhead on page loads.
• Configurable Link Target Behavior: Choose whether auto-linked affiliate links open in a fresh browser tab (target="_blank") or the current tab.
• Dual-Axis Click & Revenue Velocity Chart: Correlate raw click traffic against your estimated earnings velocity with configurable client EPC (Earnings Per Click) metrics in native canvas.
• Educational Upgrade to Pro Matrix: Interactive comparison matrix inside the WordPress admin displaying all advanced monetization capabilities.

Pro 9. Installing & Activating Pro License

AffiStyle Pro is a modular extension built on top of the free core plugin. It requires AffiStyle Free to be active.

1. Ensure AffiStyle Free is installed and activated.
2. Download affistyle-pro.zip from your Lemon Squeezy receipt.
3. Navigate to Plugins → Add New Plugin → Upload Plugin and upload the ZIP archive.
4. Click Activate Plugin.
5. Go to AffiStyle → Pro License in your dashboard menu.
6. Enter your Lemon Squeezy license key and click Activate License. Cryptographic HMAC SHA-256 validation activates your license immediately.

Pro 10. Mobile Sticky Bottom CTA Bar

Mobile readers often scroll past review boxes and leave the page without converting. AffiStyle Pro features an automated Mobile Sticky Bottom CTA Bar:

• Automatic Viewport Docking: When a mobile reader scrolls past the embedded product box, a sleek floating dock slides up at the bottom of their screen.
• High-CTR Elements: Features product thumbnail, truncated title, rating score, and prominent primary buy button.
• Scroll Detection & Dismissal: Automatically dismisses when scrolling back to the card, avoiding screen obstruction.
• Dedicated Click Tracking: Sticky CTA taps are logged separately in local click analytics to measure mobile conversion lift.

Pro 11. Multi-Retailer Choice Buttons & Quick Fetch

Give your readers choice between retailers to capture sales from non-Amazon shoppers:

• Secondary Retailer Support: Add direct buy buttons for Walmart, Best Buy, eBay, Target, or brand storefronts.
• Multi-Retailer Quick Fetch: Fetch product info directly for Walmart, Best Buy, and eBay to rapidly populate prices and affiliate links.
• Conversion Lift: Giving buyers retailer choice routinely increases overall affiliate revenue by +25% to +38%.

Pro 12. Pro Conversion Intelligence Charts Suite & CSV Log Exports

Take affiliate reporting to the enterprise level without external analytics bloat:

• Device Donut Breakdown: Visualize traffic share across Mobile, Tablet, and Desktop.
• Top Cards Comparative Bars: Compare conversion rates and total clicks across all published affiliate boxes.
• 24-Hour Peak Conversion Timeline: Identify peak buying hours to schedule newsletter promotions and social posts.
• 1-Click CSV Log Export: Export raw click logs containing visitor country code, device type, referrer URL, and timestamp directly to a CSV spreadsheet for accounting and sponsor reporting.

Pro 13. 16+ Designer Templates & Versus Battle Cards

Once Pro is active, unlock all 16 conversion-tested layouts:

• Styles 1–2: Modern Product Card & Minimalist Review Box (Free & Pro).
• Styles 3–8: Glassmorphism Cards, Floating Shadows, Border Accents, and Highlight Grids.
• Styles 9–13: High-Contrast Dark Mode, Gradient Borders, and 3-Tier Comparison Cards.
• Styles 14–16 (Versus & Matrices): Head-to-head product showdown duels with #1 Winner ribbons, spec matrices, and multi-merchant tables.

Pro 14. Smart Geo-Targeted Regional Store Routing

Route international visitors to their local Amazon and storefront affiliate networks:

• Supported Regions: United States, United Kingdom, Canada, India, and Australia.
• ipapi.co Integration: Optionally connects to ipapi.co for country-level exit node geolocation resolution.
• Zero Leak Revenue: Automatically converts US Amazon clicks into Amazon UK or Amazon CA links when international visitors click your recommendations.

Pro v1.2 15. Interactive Hover Popover Micro-Cards & Granular Auto-Link Rules

Transform raw auto-links into interactive, high-converting product preview micro-cards:

• Interactive Hover Popover Micro-Cards: Displays high-resolution product thumbnail, star rating, deal price, and direct buy button on mouse hover or tap.
• Desktop Hover Intent & Mobile Tap Dock: Engineered with hover intent delay on desktop to prevent accidental triggers, and a persistent bottom popover dock on mobile touchscreens.
• Global Granular Auto-Link Rules: Customize auto-linking rules sitewide with post-type filtering, taxonomy exclusions (categories, tags), specific post ID exclusions, and link density sliders.
• Heading Bypass Protection: Automatically skips headings (h1 through h6) to preserve clean editorial hierarchy and SEO structure.
• Pro Unlimited Keyword Tag Manager: Define unlimited target keywords per product box with 1-click automatic title keyword extraction.
• Per-Post Editorial Opt-Out: Easily disable sitewide auto-linking on individual posts via a dedicated editorial metabox.

Pro v1.2 16. A/B Split Testing Engine, Deal Urgency & Exit-Intent Drawer

Scientifically test review card variations and maximize impulse purchases:

• A/B Split Testing Engine: Automatically rotate 50/50 traffic between two card variations (copy, button styles, pricing displays) with 1-click winner promotion once statistical significance is reached.
• Deal Expiration Countdown Ticker: Embed animated real-time countdown timers directly on cards to drive urgency during Black Friday, Prime Day, or flash sales.
• Dynamic Savings & Discount Badges: Auto-calculates dollar savings and percentage discounts (e.g., "Save 35% ($40 Off)") on the fly from MSRP and deal prices.
• Exit-Intent Slide-Out Offer Drawer: Recovers abandoning desktop visitors by triggering a sleek slide-out drawer featuring your top-converting recommendation when cursor exit velocity is detected.
• Curated Product Roundups Shortcode: Deploy multi-product roundup lists instantly in any post or template with the new [affistyle_roundup] shortcode.

Pro v1.2 17. Multi-Retailer Price Grabber, PDF Reports & Monetization Radar

Enterprise monetization intelligence tools to safeguard revenue and discover untapped commission channels:

• 1-Click Multi-Retailer Price Grabber: Instant pricing and card data grabber for Amazon, Walmart, Best Buy, and eBay.
• Executive PDF Report & CSV Data Exports: Generate presentation-ready executive PDF affiliate performance reports and complete raw CSV click telemetry.
• Amazon Associates TOS UTC Timestamp Stamper: Automatically stamps and displays verified UTC pricing timestamps on Amazon product displays to comply with strict Amazon Associates operating policies.
• Multi-Layer Conversion Attribution Flow Chart: Inspect the full buyer referral journey from entry page to exit click across devices and affiliate merchants.
• Monetization Opportunity Matrix: Automated untapped revenue scanner that audits your published post archives for high-traffic articles missing affiliate cards.
• Link Health & Conversion Decay Radar: Early-warning system that flags broken destination URLs, out-of-stock items, or products experiencing conversion drop-offs before commissions are lost.

18. 0.000 CLS Architecture & PageSpeed Benchmarks

How AffiStyle guarantees 100/100 Google Core Web Vitals:

• Pure Scoped CSS (<15KB): Zero jQuery, zero heavy frontend JavaScript frameworks.
• Conditional Asset Loading: Styles are only enqueued on posts where an affiliate card is actively rendered.
• Server-Side Aspect-Ratio Calculation: Image dimensions are hard-coded into server HTML to eliminate Cumulative Layout Shift (0.000 CLS).

19. Official Release Changelog

20. Developer Support Desk

Need assistance with installation, custom CSS, migration, or licensing?

• Direct Email: [email protected]
• Contact Desk: Online Contact Form →
• WordPress.org Support Forum: AffiStyle Free Community Forum