Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/KonstantinCodes/mautic-recaptcha

This Plugin brings reCAPTCHA integration to mautic.
https://github.com/KonstantinCodes/mautic-recaptcha

mautic plugin recaptcha

Last synced: 30 days ago
JSON representation

This Plugin brings reCAPTCHA integration to mautic.

Awesome Lists containing this project

README

        

# Mautic reCAPTCHA Plugin

[![license](https://img.shields.io/packagist/v/koco/mautic-recaptcha-bundle.svg)](https://packagist.org/packages/koco/mautic-recaptcha-bundle)
[![Packagist](https://img.shields.io/packagist/l/koco/mautic-recaptcha-bundle.svg)](LICENSE)
[![mautic](https://img.shields.io/badge/mautic-3%20&%204-blue.svg)](https://www.mautic.org/mixin/recaptcha/)

This Plugin brings reCAPTCHA integration to mautic 3 and 4.

## Installation via composer (preferred)
### mautic 2 (legacy)
This only supports reCaptcha v2.

Execute `composer require koco/mautic-recaptcha-bundle:1.*` in the main directory of the mautic installation.
### mautic 3 & 4
Supports reCaptcha v2 and v3.

Execute `composer require koco/mautic-recaptcha-bundle:3.*` in the main directory of the mautic installation.

## Installation via .zip
Download the .zip file, extract it into the `plugins/` directory and rename the new directory to `MauticRecaptchaBundle`.

* Download for mautic 2 (legacy): [mautic-recaptcha-legacy.zip](https://github.com/KonstantinCodes/mautic-recaptcha/archive/1.1.3.zip)
* Download for mautic 3 & 4: [mautic-recaptcha.zip](https://github.com/KonstantinCodes/mautic-recaptcha/archive/master.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
Navigate to the Plugins page and click "Install/Upgrade Plugins". You should now see a "reCAPTCHA" plugin. Open it to configure site key and site secret.

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

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

## Score validation

Recaptcha 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")