AzonMate

The Amazon Affiliate Product Engine for WordPress

[!NOTE] AzonMate is free, open-source, and community-driven.

Most Amazon affiliate plugins charge $49 – $199/year. AzonMate gives you the same power — 8 stunning layouts, Gutenberg blocks, geo-targeting, analytics — for $0. No premium tier, no upsells, no nag banners.

Our goal is simple: build the best free Amazon affiliate toolkit on the planet, together. Star the repo, share it with fellow affiliate marketers, submit ideas or pull requests — every contribution makes AzonMate better for everyone.

If you find AzonMate useful, the best way to support it is to give it a ⭐ on GitHub and tell your friends.

[!IMPORTANT] 🔴 Amazon PA-API 5.0 is being deprecated on April 30, 2026.

Amazon is retiring the Product Advertising API (PA-API 5.0) and replacing it with the Creators API. Starting v2.0.0, AzonMate has fully migrated to the new Creators API with OAuth 2.0 authentication.

If you are upgrading from v1.x, you must generate new Creators API credentials (Credential ID, Credential Secret, and Version) from your Amazon Associates account and enter them in AzonMate → Settings → API. Your old PA-API Access Key and Secret Key will no longer work after the deprecation date.

🔗 Learn more about the Creators API migration

AzonMate v2.0.0 replaces the legacy PA-API 5.0 with Amazon's next-generation Creators API. Here's what changed under the hood:

Key benefits of the Creators API:

• Simpler authentication — no more complex AWS Signature v4 signing. Just a Bearer token.
• Automatic token caching — OAuth tokens are cached for ~1 hour, reducing overhead.
• Single API host — all marketplaces use creatorsapi.amazon (no per-region hosts).
• Future-proof — PA-API 5.0 shuts down April 30, 2026. Creators API is Amazon's long-term replacement.

What's no longer available (removed by Amazon):

• ⚠️ CustomerReviews (star rating, review count) — not available in Creators API
• ⚠️ DeliveryInfo.IsPrimeEligible (Prime badge) — not available in Creators API
• Existing manually-set ratings and Prime badges on your products will remain unchanged.

Quick Start  ·   Features  ·   Layouts  ·   Shortcodes  ·   Configuration  ·   Changelog  ·   License

🚀 Quick Start

1. Download the latest .zip from the Releases page — or click the green Code button above → Download ZIP.
2. In WordPress go to Plugins → Add New → Upload Plugin and upload the zip.
3. Click Install Now, then Activate.
4. Head to AzonMate → Settings, enter your Amazon Creators API credentials, hit Test Connection — done.

That's it. Start dropping shortcodes or using the visual Showcase Builder.

✨ Features

🎨 Showcase Layouts

Multi-Product

Single-Product

📦 Shortcodes

[azonmate box="ASIN"]                                          → Product box
[azonmate link="ASIN"]anchor text[/azonmate]                   → Inline text link
[azonmate image="ASIN"]                                        → Product image link
[azonmate field="price" asin="ASIN"]                           → Single data field
[azonmate list="ASIN1,ASIN2" layout="grid"]                    → Product list
[azonmate table="ASIN1,ASIN2" highlight="1"]                   → Comparison table
[azonmate showcase="ASIN1,ASIN2" layout="grid" columns="3"]    → Showcase (8 layouts)
[azonmate collage="ASIN1,ASIN2,ASIN3"]                        → Product collage

Tip: Use the Showcase Builder (AzonMate → Showcase in the admin) to generate shortcodes visually — no syntax to memorize.

⚙️ Configuration

📋 Requirements

📂 Project Structure

azonmate/
├── azonmate.php                    → Main plugin bootstrap
├── uninstall.php                   → Clean uninstall handler
├── composer.json                   → Composer config (Creators API SDK)
├── assets/
│   ├── css/                        → Admin, public, editor, showcase, collage styles
│   ├── js/                         → Admin, public, click tracker, search modal, manual products
│   └── images/                     → Icons & SVG assets (icon, prime badge, star)
├── build/                          → Compiled Gutenberg blocks (8 blocks)
├── includes/
│   ├── class-plugin.php            → Core plugin orchestrator
│   ├── class-autoloader.php        → PSR-4 autoloader
│   ├── class-activator.php         → Activation hook handler
│   ├── class-deactivator.php       → Deactivation hook handler
│   ├── admin/                      → Settings, analytics, showcase builder, manual products, product search
│   │   └── views/                  → Admin page templates & partials
│   ├── api/                        → Amazon Creators API client & marketplace config
│   ├── blocks/                     → Block registrar & Gutenberg source (JSX)
│   │   └── src/                    → 8 block sources + shared React components
│   ├── cache/                      → Cache manager & cron refresh
│   ├── geo/                        → Geo-targeting & link rewriter
│   ├── models/                     → Product data model
│   ├── shortcodes/                 → 9 shortcode handlers + abstract base + manager
│   ├── templates/                  → Template renderer & helper functions
│   └── tracking/                   → Click tracker
├── templates/                      → Frontend templates (theme-overridable)
│   ├── showcase/                   → 8 showcase layout templates
│   ├── product-box/                → Box templates (default, horizontal, compact)
│   ├── comparison-table/           → Table template
│   ├── product-list/               → List templates (default, grid)
│   ├── bestseller/                 → Bestseller template
│   ├── collage/                    → Collage template
│   ├── image-link/                 → Image link template
│   └── text-link/                  → Text link template
├── vendor/                         → Composer dependencies (Creators API SDK, Guzzle)
└── languages/                      → Translation .pot file

📝 Changelog

Full history in CHANGELOG.md.

v2.3.5 — 2026-03-12

• Fixed: Critical error on page reload after update — navigates to fresh URL instead of reloading to avoid opcache/autoloader conflicts
• Improved: Redesigned update buttons with gradient styling, spinner animation, and color-coded result messages
• Fixed: Removed premature activate_plugin() from upgrader hook — WordPress handles reactivation automatically
• Improved: readme.txt and README.md updated to document one-click updates and dashboard notifications

👤 Author

🐛 Bug Reports & Feature Requests

📄 License

Built with ☕ by Numan Rashed — for the Amazon affiliate community.
Questions? Reach out at numanrki@gmail.com

If AzonMate saves you time or money, consider giving it a ⭐ — it helps others find it too.