PHPackages maatoo/mautic-referrals-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. maatoo/mautic-referrals-bundle ActiveMautic-plugin[Utility & Helpers](/categories/utility) maatoo/mautic-referrals-bundle ============================== This plugin enables referrals in mautic. 1.0.3(4y ago)142.7k2[7 issues](https://github.com/maatoo-io/MauticReferralsBundle/issues)GPL-3.0-onlyPHP Since Oct 2Pushed 4y ago5 watchersCompare [ Source](https://github.com/maatoo-io/MauticReferralsBundle)[ Packagist](https://packagist.org/packages/maatoo/mautic-referrals-bundle)[ RSS](/packages/maatoo-mautic-referrals-bundle/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (1)Versions (5)Used By (0) Mautic Referrals Plugin ======================= [](#mautic-referrals-plugin) [![license](https://camo.githubusercontent.com/f005d52b3de56c726b41c11c10c6b0eaa1ce3263900475e0dc19cb2d659f3203/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6161746f6f2f6d61757469632d726566657272616c732d62756e646c652e737667)](https://packagist.org/packages/maatoo/mautic-referrals-bundle)[![Packagist](https://camo.githubusercontent.com/959c69d02ec9e003c3982d3bbac6bff11ea320f4fc471fc42ed7913a4e8630a5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d6161746f6f2f6d61757469632d726566657272616c732d62756e646c652e737667)](LICENSE)[![mautic](https://camo.githubusercontent.com/43c4ef9e79bdcc1cf55b38090aed5e8f9c19bddf094dd3b8e5a61e52a87573a8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61757469632d332d626c75652e737667)](https://www.mautic.org/mixin/referrals/) This plugins extends Mautic forms with a 'Referrals' field that enables Mautic to build Referral campaigns. New or existing contacts can invite additional contacts. Invitees are added as contacts to Mautic with a freely selectable tag. How it works ------------ [](#how-it-works) The plugin adds a new form field type ‘Referrals’. This field has a configuration to specify how many text inputs are shown in the form and what tags should be set on referred contacts. Once the form is submitted and the email addresses are valid, a new contact is created for each specified email address, or updated if one already exists with the same email address. The plugins keeps then a reference which contact invited the new contact (Referral). Additionally, you can use {referrerfield=...} tokens in emails to access contact fields of the referring contact. That enables you to build a campaign based on a segment that includes referred contacts (by filtering with the specified tag) and send a welcome email to those new contacts including for example the first name of the referring contact or a personal message. Feedback -------- [](#feedback) Ideas and suggestions are welcome, feel free to create an issue or PR on Github. License ------- [](#license) Licensed under GNU General Public License v3.0. Author ------ [](#author) This plugin is developed and maintained by [maatoo.io](https://maatoo.io) Installation via composer (preferred) ------------------------------------- [](#installation-via-composer-preferred) Execute `composer require maatoo/mautic-referrals-bundle:1.*` in the main directory of the mautic installation. Installation via .zip --------------------- [](#installation-via-zip) Download the .zip file, extract it into the `plugins/` directory and rename the new directory to `MauticReferralsBundle`. - Download for Mautic 3: [MauticReferralsBundle.zip](https://github.com/maatoo-io/mauticreferralsbundle/archive/main.zip) Clear the cache via console command `php app/console cache:clear --env=prod` (might take a while) *OR* manually delete the `app/cache/prod` directory. Configuration ------------- [](#configuration) Navigate to the Plugins page and click "Install/Upgrade Plugins". You should now see a "Referrals" plugin. Open it and set it to published. Usage ----- [](#usage) Add "Referrals" field to the Form and specify number of email inputs to display and what tags to set on referrals: [![mautic form](/doc/form_preview.png?raw=true "Mautic Form with Referrals")](/doc/form_preview.png?raw=true) Use `{referrerfield=...}` tokens in emails to include contact fields from the referring contact. Known Issues ------------ [](#known-issues) n/a Ideas ----- [](#ideas) - Add `{referrerfield=...}` tokens to list of email tokens - Dynamically add/remove input fields in the form and ability to specify a maximum in the form ### Health Score 29 — LowBetter than 57% of packages Maintenance10 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community11 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~140 days Total 4 Last Release 1678d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/65348077?v=4)[maatoo](/maintainers/maatoo)[@Maatoo](https://github.com/Maatoo) --- Top Contributors [![simcen](https://avatars.githubusercontent.com/u/560765?v=4)](https://github.com/simcen "simcen (12 commits)") ### Embed Badge ![Health badge](/badges/maatoo-mautic-referrals-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/maatoo-mautic-referrals-bundle/health.svg)](https://phpackages.com/packages/maatoo-mautic-referrals-bundle) ``` ### Alternatives [thedmsgroup/mautic-health-bundle Checks the health of the Mautic instance. 1210.8k](/packages/thedmsgroup-mautic-health-bundle)[thedmsgroup/mautic-contact-ledger-bundle Historical accounting for contacts 222.7k](/packages/thedmsgroup-mautic-contact-ledger-bundle)[thedmsgroup/mautic-media-bundle Pulls cost data from media advertising services. 251.0k](/packages/thedmsgroup-mautic-media-bundle)[thedmsgroup/mautic-campaign-watch-bundle Visual improvements for campaigns. 171.9k](/packages/thedmsgroup-mautic-campaign-watch-bundle)[thedmsgroup/mautic-segment-extras-bundle Extends Mautic Lead Bundle's Lead List (Segment) functionality. 151.4k](/packages/thedmsgroup-mautic-segment-extras-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)