Download the PHP package timehunter/laravel-google-recaptcha-v3 without Composer

Setting up your Google reCAPTCHA details in config file

Please register all details in config for host_name, site_key, secret_key and site_verify_url.

Register credentials in .env:

`

Specify your Score threshold and action in 'setting', e.g.

Note: if you want to enable Score Comparison, you also need to enable is_score_enabled to be true.

For score comparison, all actions should be registered in googlerecaptchav3 config file under 'setting' section.

For more details please check comments in config file.

You can directly use registered facade service by calling the following methods.

• setAction() is optional only if you want to verify if the action is matched.
• verifyResponse() which accepts the token value from your form. This returns Google reCAPTCHA Response object.
• setScore() is optional only if you want to manually verify the score.

Example Usage

If you manually assign a value to setScore($score), the code will fully skip your config file and force to check the score.

You can use provided Validation object to verify your reCAPTCHA.

• $actionName: if its NULL, the package won't verify action with google response.

Display reCAPTCHA v3

Add Google API script

Include the API script at the bottom of your layout page

Consent Security Policy - Nonce

To add a nonce for content security, pass a params array with your pages nonce.

Running script on every page (optional)

It's recommended to include reCAPTCHA v3 on every page which can help you get the most context about interactions for analytics. You just need to enable the config:

If the page has not detected any Action or duplicate google script, the background mode will be enabled.

Form & Action

There are three methods to populate the reCAPTCHA within the form.

• render() and renderOne() can be placed in anywhere but before init()
• renderField() needs always to be placed within your form.

Method one - render():

Method two - renderOne():

Method three - renderField():

Badge Display for Form & Action

If your settings were not reflected, please run php artisan config:cache to clear cache.

Inline

1. Go to config file, and set

2. Badge will be displayed as inline format within the form.

Invisible

The package provides two handy Javascript functions for you to get recaptcha response and refresh recaptcha as needed.

• refreshReCaptchaV3(fieldId,actionName) - this function will reset the response whenever your ajax response is returned.

• getReCaptchaV3Response - this function helps you to get recaptcha response by id

For example:

`

The package provides a lightweight vue component. You need to publish the vue component before playing around it.

Step 1 Publish vue component:

The file will be created under js/components/googlerecaptchav3/GoogleReCaptchaV3.vue, you have full control and modification ability on this file.

Step 2 Import vue component and Register reCAPTCHA v3 SiteKey

Custom implementation on Config

For some users, they might store the config details in their own storage e.g database. You can create your own class and implement:

Remember to register it in your own service provider

Custom implementation on Request method

The package has two default options to verify: Guzzle and Curl, if you want to use your own request method, You can create your own class and implement

Remember to register it in your own service provider

Thank you for the following contributors, You guys are the BEST!