PHPackages                             clarknelson/craft-recaptcha-3 - 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. [Validation & Sanitization](/categories/validation)
4. /
5. clarknelson/craft-recaptcha-3

ActiveCraft-plugin[Validation & Sanitization](/categories/validation)

clarknelson/craft-recaptcha-3
=============================

Verifies via Google the site and secret codes required to verify humanity through reCAPTCHA v3.

5.0.0(10mo ago)933.7k↑50%3[3 issues](https://github.com/clarknelson/craft-recaptcha-3/issues)[2 PRs](https://github.com/clarknelson/craft-recaptcha-3/pulls)MITPHPPHP ^8.0

Since Mar 20Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/clarknelson/craft-recaptcha-3)[ Packagist](https://packagist.org/packages/clarknelson/craft-recaptcha-3)[ RSS](/packages/clarknelson-craft-recaptcha-3/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (29)Used By (0)

Craft reCAPTCHA 3 plugin for Craft CMS
======================================

[](#craft-recaptcha-3-plugin-for-craft-cms)

A Craft CMS plugin to verify the user's humanity via Google's reCAPTCHA v3.

Craft reCaptcha 3 Overview
--------------------------

[](#craft-recaptcha-3-overview)

Google's reCaptcha service is the industry leader in determining whether a website visitor is human or robot. Their newest version (v3) does not require any human challenge such as a checkbox. Google will determine whether the user is human based on their browser characteristics, visiting history, and cookie information. The request to Google must come from a server, not a browser, which is where this plugin comes in. It attempts to take the busy work out of validating reCaptcha with Google by providing a drop-in solution.

Because of the low user friction, this may not be the most secure or reliable service in filtering bots. It will simply return whether or not Google thinks the current user is a bot. You may also need a checkbox captcha if the score does not pass and the user is likely a bot. There is a very good [hCaptcha Plugin](https://plugins.craftcms.com/craft-hcaptcha) which i've found to have the best success in preventing bots. Many contact form plugins also have options for including captcha security. See FAQ page for more information:

I've decided to depricate this plugin so I would appreciate developers exploring other options before installing. It's difficult to keep up with the Craft release schedule and there are many good options available now for captchas. I'll try to keep this plugin up to date as long as possible to prevent breaking any existing codebases.

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 3.0.0 or later. Google reCAPTCHA account (with v3 site / secret keys).

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

[](#installation)

To install the plugin, follow these instructions.

```
composer require clarknelson/craft-recaptcha-3
craft plugin/install craft-recaptcha-3
```

Configuring Craft reCAPTCHA 3
-----------------------------

[](#configuring-craft-recaptcha-3)

To configure the plugin, simply provide the site key and secret key in the settings screen. Please make sure that these keys are to the v3 version of the plugin, or else Google's server will return a 400 error.

Settings may be optionally configured using a config file.

Create `config/craft-recaptcha-3.php`

```