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.

Pro v1.1.1 8. 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 v1.1.1 9. Mobile Sticky Bottom CTA Bar

Mobile readers often scroll past review boxes and leave the page without converting. AffiStyle Pro v1.1.1 introduces 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 v1.1.1 10. 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 (New in v1.1.1): 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 v1.1.1 11. 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 12. 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 13. 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.

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

15. Official Release Changelog

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