Frumbik Affiliate Hub – Affiliate Links, Amazon Product Displays, Click Tracking & Geo-Targeting

Description

Affiliate links are the backbone of your revenue, but managing them shouldn’t be a full-time job. Frumbik Affiliate Hub turns scattered, ugly affiliate URLs into clean branded links — and gives you the analytics, Amazon integration, and automation tools to earn more from every click.

Stop paying for features that should be free. Frumbik Affiliate Hub is 100% free, open source, and packed with capabilities that rival — and often exceed — the most popular premium affiliate plugins on the market.

Link Management & Cloaking

Transform messy URLs like https://partner-site.com/ref?id=12345&campaign=xyz into clean, trustworthy links like yoursite.com/go/best-hosting. Organize everything with categories and tags, and insert links from the Gutenberg or Classic editor in seconds. Your visitors see professional links. You see higher click-through rates.

Amazon Products Integration (NEW)

Display product boxes, comparison tables, and bestseller lists from Amazon — directly in your content. Supports 22 Amazon marketplaces with automatic geo-targeting, so visitors always land on their local store. A built-in TOS Compliance Engine handles price freshness, affiliate disclaimers, and link transparency automatically. No competitor offers this level of compliance out of the box.

Analytics & Click Tracking

Know exactly which links perform and where your clicks come from. The Enhanced Analytics dashboard shows interactive charts, geographic data on a world map, browser and device breakdowns, and unique visitor tracking. Export everything to CSV for deeper analysis.

Google Analytics 4 Integration (NEW)

Send affiliate link click events directly to your GA4 property — including link slug, ASIN, marketplace, and page URL. Works with your existing Google Analytics setup. Optionally load gtag.js from the plugin, or use your own. No coding required.

Core Link Management

• 🔗 Link Cloaking — Clean, branded redirect URLs with 301/302/307 support
• 📁 Categories & Tags — Organize hundreds of links effortlessly
• ✏️ Editor Integration — Insert links from Gutenberg blocks or TinyMCE toolbar
• 📋 Shortcodes — Use [affiliate-link id="123"] anywhere in your content
• 🔄 Import/Export — Bulk import from CSV/JSON, export for backup or migration
• 🔑 QR Codes — Generate downloadable QR codes for any affiliate link
• 🌐 Query Forwarding — Pass URL parameters through cloaked links to destination

Amazon Products Module (NEW)

• 🛒 Product Boxes — 4 layouts that showcase Amazon products and drive clicks
• 📊 Comparison Tables — Drag-and-drop builder for side-by-side product comparisons
• 🏆 Bestseller Lists — Auto-updating grids from any Amazon category
• ⚡ Zero-API Mode — Start displaying products immediately, no API credentials needed
• 🌍 22 Marketplaces — Automatic geo-targeting replaces Geniuslink ($5-48/mo)
• ✅ TOS Compliance Engine — Automated disclaimers, price checks, and transparency
• 📦 Bulk ASIN Import — Add up to 200 products at once
• 🧱 5 Gutenberg Blocks — Product Box, Product Link, Comparison Table, Bestseller List, Product Grid
• 📈 Price History — Track price trends and time your recommendations
• 🔮 Creators API Ready — Future-proofed for Amazon’s new API (PA-API 5.0 deprecated April 2026)

Analytics & Tracking

• 📊 Enhanced Analytics — Interactive dashboard with ApexCharts, filtering, and CSV export
• 🌍 GeoLocation Tracking — World map analytics with MaxMind GeoIP2 + 3 fallback APIs
• 👤 Unique Visitor Detection — 24-hour fingerprinting with session management
• 📱 Device Detection — Browser, OS, and device breakdowns for every click
• 🔍 Keywords Autolinker — Automatically convert keywords in your content to affiliate links
• 🔗 Link Scanner — Detect broken links with scheduled scans and email alerts

Google Analytics 4 (NEW)

• 📈 GA4 Event Tracking — Send click events with link slug, ASIN, marketplace, and page URL
• 🏷️ Custom Events — Track affiliate clicks alongside your other GA4 data
• ⚙️ Flexible Setup — Load gtag.js from the plugin or use your existing tag

Advanced Modules

• ⚡ Performance Monitor — System optimization and caching insights
• 🏥 Health Monitor — Diagnostic tools and error logging
• 🧩 Modular Architecture — Enable only what you need; disable the rest
• 🌐 Multilingual — English, Polish, German, and Spanish out of the box
• 📱 Mobile Responsive — Admin interface works on any device

Why Choose Frumbik Affiliate Hub?

It’s free. Not “free with limits” or “free trial” — genuinely free and open source under GPLv2. No upsells, no premium tier, no nag screens.

Most affiliate plugins charge annual subscriptions for features like link cloaking, auto-linking, click analytics, Amazon product displays, or geo-targeting — and you often need multiple paid plugins to cover everything. With Frumbik Affiliate Hub, you get all of these capabilities in one plugin, completely free. No annual fees, no feature gates, no “upgrade to unlock” prompts. Just install and use everything from day one — including features you won’t find anywhere else, like the TOS Compliance Engine and built-in GA4 event tracking.

Approved and distributed through WordPress.org. Follows WordPress Coding Standards. All SQL queries use prepared statements. All output is escaped. Nonce verification on every form.

Perfect For

• Bloggers who monetize with affiliate links and want clean URLs
• Amazon affiliates who need product boxes, comparison tables, and geo-targeting
• Content creators who want to track which links actually earn money
• Niche site builders running multiple affiliate programs at once
• Marketing agencies managing affiliate links across client sites

Privacy & Security

GDPR Compliance

• Data Minimization: Only essential data is collected
• User Consent: All tracking and geolocation are disabled by default — must be explicitly enabled
• Data Export: Built-in tools for data export/deletion requests
• Anonymization: IP address anonymization options
• Transparency: Clear data usage policies in settings

Security Features

• Nonce Protection: All forms use WordPress nonces
• Capability Checks: Role-based access control
• SQL Injection Prevention: Prepared statements only
• XSS Protection: All output properly sanitized
• Regular Updates: Active maintenance and security patches

External Services

This plugin connects to several third-party services to provide enhanced functionality. All external connections are optional and can be disabled.

MaxMind GeoLite2 Database Service

What it is: MaxMind provides geolocation data through their GeoLite2 database
What it’s used for: Converting visitor IP addresses to geographical locations (country, city, coordinates) for analytics
What data is sent: Only IP addresses of visitors who click affiliate links. IP data is processed locally using the downloaded database — no visitor data is sent to MaxMind servers in real-time.
When it’s sent: Only when the GeoLocation module is enabled and a visitor clicks an affiliate link
Database updates: When a license key is configured, the plugin automatically re-downloads the GeoLite2 database weekly via WordPress Cron (no visitor data is sent — only a download request using the administrator’s license key)
Service provider: MaxMind, Inc.
Terms of service: https://www.maxmind.com/en/terms-of-use
Privacy policy: https://www.maxmind.com/en/privacy-policy
Database download: https://download.maxmind.com/ (requires free license key)

IP Geolocation API Services

What they are: Fallback geolocation services when MaxMind database is not available
What they’re used for: Converting IP addresses to location data as backup to local database
What data is sent: Visitor IP addresses only
When it’s sent: Only when local MaxMind database is unavailable and GeoLocation tracking is enabled

IP-API.com
– Service: Free IP geolocation API
– Data sent: Visitor IP address (anonymized if IP anonymization is enabled)
– When: When the GeoLocation module is enabled and the MaxMind local database is unavailable (fallback mode, one request per click). Also used during admin-initiated GeoIP performance benchmark tests (sends standard public test IPs such as 8.8.8.8 — no visitor data).
– Terms & Privacy policy: https://ip-api.com/docs/legal (combined page)
– Rate limits: 45 requests per minute for free tier

IPApi.co
– Service: IP geolocation API service
– Data sent: IP address only
– Privacy policy: https://ipapi.co/privacy/
– Terms: https://ipapi.co/terms/
– Rate limits: 15,000 requests per month for free tier

IPInfo.io
– Service: IP geolocation API service
– Data sent: IP address only
– Privacy policy: https://ipinfo.io/privacy-policy
– Terms: https://ipinfo.io/terms-of-service
– Rate limits: 50,000 requests per month for free tier

GitHub API Service

What it is: GitHub’s REST API and archive download service used for downloading open source libraries
What it’s used for: Downloading MaxMind GeoIP2 PHP libraries when an administrator chooses to install native library support
What data is sent: No visitor personal data is sent. Standard HTTP headers (including the server’s IP address and a plugin User-Agent string “AffiliateHub-WordPress-Plugin”) are transmitted to GitHub as part of normal HTTP communication. No visitor or site data beyond these headers is shared.
When it’s used: Only when an administrator manually clicks “Install Native GeoIP2 Library” in the plugin settings — never triggered automatically
Domains contacted:
– https://api.github.com/repos/maxmind/GeoIP2-php (fetch latest GeoIP2 release metadata)
– https://api.github.com/repos/maxmind/MaxMind-DB-Reader-php (fetch latest MaxMind DB Reader release metadata)
– https://github.com/maxmind/GeoIP2-php/releases (download GeoIP2 library ZIP archive; used as fallback when API is unavailable)
– https://github.com/maxmind/MaxMind-DB-Reader-php/releases (download MaxMind DB Reader ZIP archive; used as fallback when API is unavailable)
– Note: GitHub may redirect archive downloads through https://codeload.github.com/
Service provider: GitHub, Inc. (Microsoft)
Privacy policy: https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement
Terms of service: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service
API Terms: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service#h-api-terms

Link Scanner

The Link Scanner module checks your affiliate link destination URLs to verify they are still active and responding.

• It sends HTTP HEAD/GET requests to the destination URLs stored in your affiliate links
• These are URLs you have entered yourself — no visitor data is sent
• Requests are only triggered manually by an administrator from the Link Scanner settings page
• No third-party service is involved — requests go directly to the destination URLs

Google Analytics 4 (optional)

What it is: Google Analytics 4 tracking via Google Tag Manager
What it’s used for: Sending affiliate link click events to GA4 for analytics
What data is sent: Click event data (event name, link slug, ASIN, marketplace, page URL) — sent from visitor’s browser to Google
When it’s sent: Only when the Google Analytics 4 module is enabled in plugin settings
Optional script loading: When “Load gtag.js” is enabled, the plugin loads a JavaScript tracking library from Google’s CDN. This is optional and disabled by default.
Domains contacted:
– https://www.googletagmanager.com/ (gtag.js library download)
– https://www.google-analytics.com/ (event data collection)
Service provider: Google LLC
Terms of service: https://marketingplatform.google.com/about/analytics/terms/us/
Privacy policy: https://policies.google.com/privacy

User Control and Privacy

• All external services are optional – plugin works without any external connections
• GeoLocation can be disabled – stops all IP-based tracking and external API calls
• No CDN dependencies – all JavaScript and CSS assets are bundled locally
• MaxMind requires user license – user must register and provide their own license key
• No tracking by default – external services only activated when explicitly enabled
• Data minimization – only essential data (IP addresses) sent to geolocation services
• Local processing preferred – MaxMind database processes data locally when available

Source Code

This plugin includes third-party JavaScript libraries in both minified and human-readable form. All plugin-authored JavaScript files (admin.js, analytics-dashboard-production.js, affiliate-hub-block.js, affiliate-hub-qrcode.js, etc.) are unminified. No build tools are required.

Full plugin source code is included in the plugin package. All plugin-authored files are unminified and human-readable.

assets/js/jsvectormap.min.js

Minified distribution of jsVectorMap v1.7.0, an interactive map library.
The unminified human-readable source is included in the plugin as assets/js/jsvectormap.js (2301 lines).
Upstream source: https://github.com/themustafaomar/jsvectormap/releases/tag/v1.7.0

assets/js/jsvectormap-world.js

This file (1661 lines) contains auto-generated SVG path data defining country boundaries for every country in the world. It is distributed as part of the jsVectorMap package. The path strings consist of SVG drawing commands (M=moveto, l=lineto, Z=closepath) followed by x,y geographic coordinates — they are NOT minified or obfuscated JavaScript code. The upstream dist/maps/world.js ships this data fully minified on a single line; this version is reformatted for readability with each country in its own commented block, properties on separate lines, and long multi-territory paths split at sub-path (Z) boundaries. Maximum line length is under 250 characters.
Upstream source: https://github.com/themustafaomar/jsvectormap/releases/tag/v1.7.0

assets/js/qrcode-generator.js / qrcode-generator.min.js

QR code generation library (qrcodejs v1.0.0). The human-readable source is included as assets/js/qrcode-generator.js (fully formatted with proper indentation). The minified version (qrcode-generator.min.js) is used at runtime.
Upstream source: https://github.com/davidshimjs/qrcodejs

assets/js/apexcharts.min.js

Minified distribution of ApexCharts v5.3.3, a JavaScript charting library.
The unminified source (dist/apexcharts.js) is available in the upstream release archive.
Upstream source: https://github.com/apexcharts/apexcharts.js/releases/tag/v5.3.3

Third-Party Libraries

This plugin bundles the following open-source JavaScript and CSS libraries. All libraries are served locally from the plugin package — no external network requests are made to load them.

ApexCharts

• Library: ApexCharts
• Version: 5.3.3
• Bundled file: assets/js/apexcharts.min.js
• Purpose: Interactive charts in the Enhanced Analytics and Link Scanner dashboards
• License: MIT License
• Source: https://github.com/apexcharts/apexcharts.js/releases/tag/v5.3.3
• Copyright: (c) 2018-2025 ApexCharts

jsVectorMap

• Library: jsVectorMap
• Version: 1.7.0
• Bundled files: assets/js/jsvectormap.js (unminified source, 2301 lines), assets/js/jsvectormap.min.js, assets/js/jsvectormap-world.js (1661 lines), assets/css/jsvectormap.min.css
• Purpose: Interactive world map in the GeoLocation analytics view
• Note: jsvectormap-world.js contains auto-generated SVG geographic coordinate data (not minified JS). Reformatted from upstream single-line format to one commented block per country with paths split at sub-path boundaries. Max line length under 250 chars.
• License: MIT License
• Source: https://github.com/themustafaomar/jsvectormap/releases/tag/v1.7.0
• Copyright: (c) Mustafa Omar

QRCode (qrcodejs)

• Library: qrcodejs
• Version: 1.0.0
• Bundled files: assets/js/qrcode-generator.js (human-readable formatted source, 1425 lines), assets/js/qrcode-generator.min.js
• Purpose: QR code generation for affiliate links
• License: MIT License
• Source: https://github.com/davidshimjs/qrcodejs
• Copyright: (c) 2012 davidshimjs

Support & Development

Getting Help

• Documentation: Visit our Knowledge Base
• Community Forum: WordPress.org support forums
• Feature Requests: Submit via WordPress.org or GitHub
• Bug Reports: Please include WordPress/PHP versions and error logs

Contributing

• Translations: Help translate AffiliateHub in your language
• Code Contributions: Submit pull requests via GitHub
• Testing: Beta testing program available
• Feedback: Your suggestions shape our roadmap

Roadmap

• Advanced Targeting: Device, browser, time-based rules
• A/B Testing: Split testing for affiliate links
• API Integration: REST API for external tools
• White Label: Custom branding options
• Multi-Site Support: Network-wide management

License

This plugin is licensed under the GPLv2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA