Azonmate
AzonMate – Amazon Affiliate Product Engine for WordPress. Search, display & monetize Amazon products with 8 showcase layouts, 7 shortcodes, Gutenberg blocks, geo-targeting, click tracking & analytics.
Install / Use
/learn @numanrki/AzonmateREADME
<br />[!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.
<br /> <!-- ═══════════════════════════════════════════════════════════ --> <!-- What's New in v2.0.0 — Amazon Creators API --> <!-- ═══════════════════════════════════════════════════════════ --> <details> <summary><strong>🆕 What's New in v2.0.0 — Amazon Creators API</strong></summary> <br />[!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.
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:
| | PA-API 5.0 (old) | Creators API (v2.0.0) |
|:---|:---|:---|
| Authentication | AWS Signature v4 (HMAC-SHA256) | OAuth 2.0 Bearer token |
| Credentials | Access Key + Secret Key | Credential ID + Credential Secret + Version |
| API Endpoint | webservices.amazon.*/paapi5/... | creatorsapi.amazon/catalog/v1/... |
| Token Caching | None (signed per-request) | Auto-cached for 1 hour |
| Request Format | PascalCase params | lowerCamelCase params |
| Offers Resource | Offers.Listings.* | offersV2.listings.* |
| Price Structure | Flat (Price.Amount) | Nested (price.money.amount) |
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
- Download the latest
.zipfrom the Releases page — or click the green Code button above → Download ZIP. - In WordPress go to Plugins → Add New → Upload Plugin and upload the zip.
- Click Install Now, then Activate.
- 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
<table> <tr> <td width="50%" valign="top">Amazon Creators API
- OAuth 2.0 authentication
- 22 marketplaces — US, CA, MX, BR, UK, DE, FR, IT, ES, NL, BE, PL, SE, TR, SA, AE, EG, IE, IN, JP, SG, AU
- Real-time product search inside the editor
- Live price, rating & availability sync
8 Showcase Layouts
Theme-proof product displays — admin preview = live post:
| Multi-Product | Single-Product | |:---|:---| | Grid Cards | Hero Card | | Row List | Compact | | Masonry | Split | | Comparison Table | Deal Card |
8 Shortcodes
box · link · image · field · list · table · showcase · collage
8 Gutenberg Blocks
Product Box · Product List · Comparison Table · Bestseller · Text Link · Product Search · Showcase · Collage
</td> <td width="50%" valign="top">Visual Showcase Builder
Point-and-click shortcode generator with live WYSIWYG preview — no code required.
Smart Caching
Database-backed cache with configurable TTL + WP-Cron auto-refresh.
Geo-Targeting
Auto-detect visitor country → swap affiliate tag → redirect to correct Amazon store.
Click Tracking & Analytics
Privacy-safe tracking with SHA-256 hashed IPs, per-product stats, dashboard widget, CSV export.
Security First
AES-256-CBC key encryption · nonce-verified AJAX · capability checks · rate limiting.
Theme-Proof CSS
Fully scoped BEM classes · CSS Custom Properties · dark mode · template overrides.
Manual Products
Add products manually without an API key — full CRUD admin interface. Fetch from Amazon button auto-populates all fields from the Creators API.
Product Collage
Dynamic multi-product collage shortcode with auto-adjusting grid layout and hover-reveal buy buttons.
One-Click Updates
Built-in update manager — check for new GitHub releases and install updates with one click from Settings → Updates. Dashboard notification banner when a new version is available.
</td> </tr> </table>🎨 Showcase Layouts
Multi-Product
| Layout | Description | |:---|:---| | Grid Cards | Responsive 1–4 column card grid with badges, savings %, ratings, and a prominent CTA button. | | Row List | Full-width horizontal rows — thumbnail left, details center, price + button right. Highlighted rows for badged products. | | Masonry | Pinterest-style CSS-column layout. Products flow dynamically for a magazine feel. | | Comparison Table | Data-rich column-per-product table — image, title, rating, price, buy button. Highlight the recommended pick. |
Single-Product
| Layout | Description | |:---|:---| | Hero Card | Large spotlight card with 42% image panel + full body. Perfect for "top pick" callouts. | | Compact | Slim inline card that sits between paragraphs — thumbnail, title, price, CTA in one row. | | Split | Clean 50/50 grid — image on one side, details + features + CTA on the other. | | Deal Card | Price-drop focused design with orange accent, savings % badge, and "Save X%" callout. |
📦 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 → Showcasein the admin) to generate shortcodes visually — no syntax to memorize.
⚙️ Configuration
| Setting | Where | |:---|:---| | API credentials (Credential ID, Credential Secret, Version, Partner Tag, Marketplace) | AzonMate → Settings → API | | Cache TTL & auto-refresh schedule | AzonMate → Settings → Cache | | Geo-targeting regions & fallback tags | AzonMate → Settings → Geo | | Click tracking & analytics options | AzonMate → Settings → Tracking | | Manual products CRUD | AzonMate → Products | | Visual showcase builder | AzonMate → Showcase |
📋 Requirements
| | Minimum | |:---|:---| | WordPress | 6.0 | | PHP | 7.4 | | Amazon Creators API | Credential ID, Secret & Version |
📂 Project Structure
azonmate/
├── azonmate.php
