README

Captcha is a Statamic addon that makes a classic captcha available for Statamic forms.

Features

This addon does:

• Provide Captcha Image
• Provide Tags to use in your Forms

Accessibility Notice

Please note that this captcha requires vision to solve. This captcha provides an image with a 4-character string that needs to be entered in the coresponding form field.

How to Install

You can search for this addon in the Tools > Addons section of the Statamic control panel and click install, or run the following command from your project root:

composer require redcodede/captcha

How to Use

1. Install the addon

Install the Captcha addon into your Statamic project as described in How to Install.

2. Add new validation rule

To use the Captcha in your form you need to add a new validation rule. Do this by running php artisan make:rule VerifyCaptcha in your terminal.

The new rule should contain these methods:

public function message(): string { return '__(validation.verify_captcha)'; }

The message handles the error messages you may want to define in resources > lang.

Extending App Service Provider Extending the App Service Provider is no longer necessary.

4. Add your form field

Your form needs to contain a text form field with the validation rules required and captcha.

5. Include the captcha into your form template

The form template should include the {{ refresh_captcha }} tag to generate a new captcha on reloading the form to get a fresh one every time.

Your form field template should include an img tag with the src of {{ captcha_image }}. This that will provide you with the image URL.

You can also add a button which will let the user generate another captcha image. <button type="button" data-refresh-url="{{ captcha_refresh_url }}">generate new captcha image</button>

Now you should be all set to use the Captcha on your own Website.