🛒 Martvill – Affiliate Add-on (GPL-Ready Source Description)

Martvill – Affiliate Add-on is a professional extension module for the Martvill eCommerce platform that introduces a complete affiliate marketing system.
It enables store owners to recruit promoters, track referral sales, and automatically calculate commissions.
Written for GPL/source-code repositories, this description follows full E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) standards for transparent educational redistribution.

🚀 Overview

The Affiliate Add-on empowers Martvill merchants to launch their own affiliate or influencer programs.
Partners can register, generate referral links, and earn commissions when their traffic converts into sales.
The add-on tightly integrates with Martvill’s cart and checkout modules to ensure accurate conversion tracking and revenue reporting.

• 👥 Built-in affiliate registration and login pages.
• 💰 Commission calculation for each referred sale.
• 📊 Real-time tracking dashboard for both admin and affiliates.
• 📩 Automated notifications for referrals, payouts, and status updates.

Experience (E): modelled on proven affiliate systems used in SaaS and multi-vendor stores, providing hands-on insight into referral tracking and conversion optimization.

✨ Key Features

• 🔗 Referral Links: unique affiliate URLs with built-in tracking parameters.
• 📈 Dashboard Analytics: charts showing total clicks, orders, and commissions earned.
• 💸 Commission Management: flat-rate or percentage-based structures configurable per product or store-wide.
• 🧾 Payout Module: admin can review and mark commissions as paid (PayPal, Stripe, or manual).
• 📬 Email Notifications: automated updates for new signups, referral approvals, and payout confirmations.
• 👤 Affiliate Profiles: complete user information with withdrawal and referral history.
• 🧮 Reporting: date-range filters, top affiliates, and product-level performance stats.
• 🔒 Fraud Prevention: IP tracking and cookie validation to stop duplicate referrals.
• 🌐 Multilingual Support: integrated with Martvill translation system for global affiliates.
• 🎨 Seamless UI: matches Martvill’s default theme and admin panel aesthetics.

⚙️ Technical Stack

• Base Platform: Martvill eCommerce CMS (Laravel 9+)
• Language: PHP 8.x
• Database: MySQL 5.7+ / MariaDB
• Frontend: Bootstrap 5, Blade templates, JavaScript (AJAX)
• Integration: hooks into Martvill’s checkout, orders, and user modules

Server Requirements: same as Martvill core — PHP 8+, MySQL 5.7+, HTTPS recommended, mod_rewrite enabled.

Expertise (E): showcases knowledge of Laravel modular architecture, event listeners, and multi-tenant eCommerce structures.

🧩 Installation Guide

1. 1. Ensure Martvill core is installed and running.
2. 2. Upload the affiliate_addon folder to the /modules/ directory.
3. 3. Log in to the admin panel → Modules → Add-ons.
4. 4. Find Affiliate Add-on and click Activate.
5. 5. Configure commission rates, payout settings, and email templates.
6. 6. Optionally, customize affiliate registration pages under CMS → Pages.

Tip: back up the database before enabling any new module on a live store.

📦 Deliverables

• ✅ Complete PHP module source code for Martvill
• ✅ SQL migrations and seeders
• ✅ Blade view templates for affiliate and admin dashboards
• ✅ Email template files (HTML)
• ✅ Setup & configuration documentation
• ✅ GPL redistribution notice for educational/archive use

📱 Supported Platforms

• Web: works inside Martvill CMS admin and front-end themes
• Server OS: Linux (Ubuntu / CentOS) recommended; Windows Server compatible
• Browsers: Chrome, Edge, Firefox, Safari (latest)
• Devices: responsive UI for desktop, tablet, and mobile users

🧠 Notes

• License: released under the GPL for transparency and education; original item may be commercial.
• Customization: extend commission logic, add coupon tracking, or integrate with external affiliate APIs.
• Security: includes validation middleware and anti-spam checks on signup.
• Performance: optimized SQL joins and caching for large affiliate networks.
• SEO Assurance: keywords → “Martvill affiliate module”, “Laravel eCommerce addon”, “affiliate marketing system”.

👨‍💻 Original Developer Credit

This add-on was originally developed by the Martvill team and released on CodeCanyon and other marketplaces.
All intellectual-property rights, branding, and naming belong to the original author.
This entry is a GPL-compliant educational restatement for open-source reference and technical documentation.

Authoritativeness (A): proper credit ensures authenticity and directs users to official Martvill sources for updates or premium support.

🔒 Disclaimer

Important:

• This is a source-code documentation summary, not an official vendor listing.
• No license keys or premium support are included unless purchased from the official developer.
• GPL redistribution must preserve author credits and cannot be resold as proprietary software.
• Always verify compatibility with your Martvill version before production deployment.

Trustworthiness (T): transparent licensing, security awareness, and attribution ensure ethical redistribution and reliable educational use.