Frumbik Affiliate Hub

Transform your affiliate marketing with Frumbik Affiliate Hub – the complete solution for creating, managing, and tracking professional affiliate links in WordPress.

Transform messy URLs like https://partner-site.com/ref?id=12345&campaign=xyz&source=blog into clean, professional links like https://yoursite.com/best-hosting.

Key Features:

• Link Cloaking & Shortening – Convert ugly affiliate URLs into beautiful branded links
• Advanced Analytics Dashboard – Interactive charts, filtering, exports and comprehensive reporting
• Enhanced Click Tracking – 24-hour unique visitor fingerprinting with session management
• GeoLocation Analytics – Track visitor locations with MaxMind integration and multiple API providers
• Keywords Autolinker – Automatically convert keywords in content to affiliate links
• Link Scanner Module – Scan for broken/active links with automated monitoring and reporting
• User Agent Detection – Browser, OS and device detection for enhanced analytics
• Performance Monitor – System performance optimization and caching for better site speed
• Health Monitor – System health monitoring with diagnostic tools and error logging
• Easy Link Management – Organize links with categories and tags
• Editor Integration – Insert links directly from WordPress editor
• Shortcode Support – Use [affiliate-link id=”123″] anywhere in your content
• Import/Export – Bulk import links and export analytics data
• Modular Architecture – Enable/disable features as needed with dependency management
• Multilingual Ready – Supports English, Polish, German, and Spanish
• Mobile Optimized – Works perfectly on all devices

Advanced Modules:

📊 Enhanced Analytics – Interactive dashboard with charts, filtering, and export capabilities
🌍 GeoLocation Tracking – World map analytics with MaxMind GeoIP2 integration
🔍 Keywords Autolinker – Automatic keyword-to-link conversion in your content
🔗 Link Scanner – Automated monitoring for broken and redirected links
📱 User Agent Detection – Browser, OS, and device analytics
⚡ Performance Monitor – System optimization and caching tools
🏥 Health Monitor – Diagnostic tools and system health monitoring
🧩 Modular Architecture – Enable/disable features as needed

Perfect For:
– Bloggers and content creators
– Affiliate marketers
– Digital product sellers
– E-commerce businesses
– Marketing agencies

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

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

Automatic Installation

1. Log in to your WordPress dashboard
2. Navigate to Plugins > Add New
3. Search for “Frumbik Affiliate Hub”
4. Click “Install Now” and then “Activate”

Manual Installation

1. Download the plugin zip file
2. Upload it via Plugins > Add New > Upload Plugin
3. Activate the plugin through the ‘Plugins’ menu in WordPress

After Activation

1. Go to Affiliate Hub in your WordPress admin menu
2. Configure your settings under Settings tab
3. Enable desired modules in the Modules tab
4. Start creating your first affiliate links!

System Requirements

• WordPress 6.2 or higher
• PHP 8.1 or higher
• MySQL 5.6 or higher / MariaDB 10.0 or higher
• Minimum 64MB PHP memory limit (128MB+ recommended)
• cURL support for link validation
• MaxMind GeoIP2 database for geographical analytics (optional)

1. 

   Main affiliate links management dashboard

2. 

   Enhanced Analytics dashboard with interactive charts and world map

3. 

   Link creation interface with advanced options

4. 

   Advanced analytics with geographic data and filtering

5. 

   Link management with categories, tags and bulk operations

1.0.0

• Initial stable release
• Core affiliate link management with clean URL cloaking and 301/302/307 redirects
• Enhanced Analytics Dashboard with interactive ApexCharts visualizations
• Advanced click tracking with unique visitor detection and IP anonymization
• GeoLocation tracking with MaxMind GeoLite2 database integration
• Fallback IP geolocation via IP-API.com, IPApi.co, and IPInfo.io
• Keywords Autolinker for automatic keyword-to-affiliate-link conversion
• Link Scanner module for broken link detection and monitoring
• User Agent Detection for browser, device, and OS analytics
• Performance Monitor for system optimization insights
• Health Monitor with diagnostic tools
• Modular architecture — enable only the features you need
• Category and tag organization for affiliate links
• Shortcode support with multiple display options
• TinyMCE editor integration for easy link insertion
• Gutenberg Block Editor integration for inserting affiliate links
• Setup Wizard with guided onboarding for new users
• Query parameter forwarding from cloaked URLs to destination URLs
• QR Code generation for affiliate links with PNG download
• Import/Export functionality (CSV and JSON formats)
• Multilingual support (English, Polish, German, Spanish)
• Mobile-responsive admin interface
• GDPR compliance features with IP anonymization and data minimization
• Full WordPress Coding Standards (WPCS) compliance
• All SQL queries use $wpdb->prepare() with identifier placeholders
• All output properly escaped at point of rendering
• Nonce verification on all forms and AJAX requests
• Capability checks on all privileged operations