PHPackages                             aiviemarketing/mautic-recaptcha - 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. [Security](/categories/security)
4. /
5. aiviemarketing/mautic-recaptcha

ActiveMautic-plugin[Security](/categories/security)

aiviemarketing/mautic-recaptcha
===============================

This plugin brings reCAPTCHA integration to Aivie and mautic.

6.0.6(6mo ago)001GPL-3.0-onlyPHPCI passing

Since Sep 25Pushed 1mo agoCompare

[ Source](https://github.com/aiviemarketing/aivie-recaptcha)[ Packagist](https://packagist.org/packages/aiviemarketing/mautic-recaptcha)[ RSS](/packages/aiviemarketing-mautic-recaptcha/feed)WikiDiscussions 6.x Synced 1mo ago

READMEChangelog (4)Dependencies (2)Versions (8)Used By (0)

Aivie Mautic reCAPTCHA Plugin
=============================

[](#aivie-mautic-recaptcha-plugin)

[![license](https://camo.githubusercontent.com/63c2da20fcb665cb9996d2d9cea9f22322bae2e3d52a52de3ab78407c6196db7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6f636f2f6d61757469632d7265636170746368612d62756e646c652e737667)](https://packagist.org/packages/koco/mautic-recaptcha-bundle)[![Packagist](https://camo.githubusercontent.com/f8bdedc37d597fd7c639048051dcee8096bf6e02eb730dd41b6eb7859212f217/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6b6f636f2f6d61757469632d7265636170746368612d62756e646c652e737667)](LICENSE)[![mautic](https://camo.githubusercontent.com/ca556adc57d933b110edae5df4d46615370e758203b85596ad6abfd340dfc53e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61757469632d3325323026253230342d626c75652e737667)](https://www.mautic.org/mixin/recaptcha/)

This Plugin brings reCAPTCHA integration to mautic 3 and 4.

Installation
------------

[](#installation)

### mautic 3 &amp; 4

[](#mautic-3--4)

Supports reCaptcha v3.

Add this code to the plugins/ directory of your mautic installation.

Execute `composer require google/cloud-recaptcha-enterprise` in the main directory of the mautic installation.

> @todo needs to be moved to the plugins composer.json, when we support composer v2. So we can install the .

- This plugin is already installed with your [Aivie Mautic Hosting](https://aivie.ch/en/mautic-hosting-and-installation/?utm_source=github&utm_medium=recaptcha&utm_campaign=opensource&utm_content=hosting)

Configuration
-------------

[](#configuration)

Navigate to the Plugins page and click "Install/Upgrade Plugins". You should now see a "reCAPTCHA" plugin. Open it to enable it.

Set the following ENV variables on your server:

- GOOGLE\_CLOUD\_PROJECT
- GC\_RECAPTCHA\_SITE\_KEY
- GOOGLE\_APPLICATION\_CREDENTIALS

The plugin relies on [Google reCAPTCHA Enterprise](https://cloud.google.com/recaptcha). For it to work it needs [Google Application Default Credentials](https://cloud.google.com/docs/authentication/application-default-credentials#GAC).

Usage in a Mautic Form
----------------------

[](#usage-in-a-mautic-form)

Add "reCAPTCHA" field to the Form and save changes. [![mautic form](/doc/form_preview.png?raw=true "Mautic Form with reCAPTCHA")](/doc/form_preview.png?raw=true)

Score validation
----------------

[](#score-validation)

reCAPTCHA v3 will rank traffic and interactions based on a score of 0.0 to 1.0, with a 1.0 being a good interaction and scores closer to 0.0 indicating a good likelihood that the traffic was generated by bots

[![score validation](/doc/score-validation.png?raw=true "plugin config")](/doc/score-validation.png?raw=true)

Release Workflow
----------------

[](#release-workflow)

This project uses GitHub Actions for automated releases. To push to protected branches (like `6.x`), you need to configure one of the following:

### Option 1: Personal Access Token (Recommended)

[](#option-1-personal-access-token-recommended)

1. Create a Personal Access Token (PAT) with the following permissions:
    - **Classic PAT**: `repo` scope (full control of private repositories)
    - **Fine-grained PAT**:
        - Contents: Read and write
        - Metadata: Read-only (automatically included)
        - Releases: Write (if creating releases)
2. Add it as a repository secret named `RELEASE_TOKEN` in Settings → Secrets and variables → Actions
3. The workflow will use this token to bypass branch protection rules and push commits/tags to the protected branch

### Option 2: Configure Branch Protection

[](#option-2-configure-branch-protection)

1. Go to Settings → Branches → Branch protection rules for `6.x`
2. Enable "Allow specified actors to bypass required pull requests"
3. Add `github-actions[bot]` to the bypass list

Based on
--------

[](#based-on)

Contributers
------------

[](#contributers)

[Aivie](https://aivie.ch/en/?utm_source=github&utm_medium=recaptcha&utm_campaign=opensource&utm_content=contact>)
[![](https://camo.githubusercontent.com/f3d92c50a7475e09d9915638d1b50e106fcc850da31a5cb12d4bbe087ce42239/68747470733a2f2f63646e2e61697669652e63682f6d656469612f77702f323032312f30362f31393133313730342f6c6f676f2d61697669652d666173742d6b65696e2d72616e642d343030772e706e67)](https://aivie.ch/en/?utm_source=github&utm_medium=recaptcha&utm_campaign=opensource&utm_content=contact>)

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance79

Regular maintenance activity

Popularity1

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~90 days

Recently: every ~35 days

Total

7

Last Release

54d ago

Major Versions

4.x-dev → 5.x-dev2024-09-25

5.x-dev → 6.0.32025-10-31

### Community

Maintainers

![](https://www.gravatar.com/avatar/4b7199b32ae210cd7ca95fcdaa2e84cdd14cdb5a87020602c929c4453ad5c68d?d=identicon)[aivie](/maintainers/aivie)

---

Top Contributors

[![KonstantinCodes](https://avatars.githubusercontent.com/u/844484?v=4)](https://github.com/KonstantinCodes "KonstantinCodes (61 commits)")[![adiux](https://avatars.githubusercontent.com/u/13075514?v=4)](https://github.com/adiux "adiux (39 commits)")[![shinde-rahul](https://avatars.githubusercontent.com/u/1046788?v=4)](https://github.com/shinde-rahul "shinde-rahul (22 commits)")[![kuzmany](https://avatars.githubusercontent.com/u/462477?v=4)](https://github.com/kuzmany "kuzmany (7 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)")[![escopecz](https://avatars.githubusercontent.com/u/1235442?v=4)](https://github.com/escopecz "escopecz (1 commits)")[![loilo](https://avatars.githubusercontent.com/u/1922624?v=4)](https://github.com/loilo "loilo (1 commits)")

---

Tags

pluginMauticintegrationaivie

### Embed Badge

![Health badge](/badges/aiviemarketing-mautic-recaptcha/health.svg)

```
[![Health](https://phpackages.com/badges/aiviemarketing-mautic-recaptcha/health.svg)](https://phpackages.com/packages/aiviemarketing-mautic-recaptcha)
```

###  Alternatives

[mautic/grapes-js-builder-bundle

GrapesJS Builder with MJML support for Mautic

5684.1k4](/packages/mautic-grapes-js-builder-bundle)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

522.0k](/packages/etailors-mautic-amazon-ses)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
