pollen-solutions/recaptcha

Pollen Solutions - Recaptcha Component - Recaptcha V2/V3 integration layer for PHP forms

Maintainers

Details

github.com/pollen-solutions/recaptcha

Homepage

Source

Issues

Installs: 2

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

v1.0.0 2021-08-19 00:00 UTC

Requires

Requires (Dev)

Suggests

MIT f9b3124cc9e1c01500912782d281c346479ef448

  • Jordy Manner <jordy.woop@presstify.com>

recaptchacomponentv3v2pollen-solutions

This package is auto-updated.

Last update: 2024-04-20 00:25:53 UTC

README

Latest Stable Version MIT Licensed PHP Supported Versions

Pollen Solutions Recaptcha Component provides a recaptcha V2/V3 integration layer for PHP forms.

Installation

composer require pollen-solutions/recaptcha

Basic Usage with Pollen form component

  1. Install Pollen form component with composer.
composer require pollen-solutions/form
  1. Create a form, display it and send a submission.
use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;
use Pollen\Form\FormManager;
use Pollen\Recaptcha\Recaptcha;
use Pollen\Recaptcha\Form\RecaptchaFormField;

$recaptcha = new Recaptcha();
$recaptcha->config(
    [
        /**
         * Recaptcha version or type (required).
         * @var int 2|3
         */
        'version'   => 3,
        /**
         * Recaptcha Site key (required).
         * @var string|null $sitekey
         */
        'sitekey'   => '===== sitekey =====',
        /**
         * Recaptcha secret key (required).
         * @var string|null $secretkey
         */
        'secretkey' => '===== secretkey =====',
        /**
         * Locale in ISO 15897 format. en_US if null.
         * @var string|null $locale
         */
        'locale'    => null,
    ]
);

$forms = new FormManager();

try {
    $forms->registerFormFieldDriver('recaptcha', new RecaptchaFormField($recaptcha));
} catch(Throwable $e) {
    // If the recaptcha form field is already registered.
    unset($e);
}

$form = $forms->buildForm(
    [
        'fields' => [
            'email'   => [
                'type' => 'text',
            ],
            'captcha' => [
                'type' => 'recaptcha',
            ],
        ],
    ]
)->get();

if ($response = $form->handle()->proceed()) {
    (new SapiEmitter())->emit($response->psr());
    exit;
}

echo <<< HTML
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Test Recaptcha</title>
    </head>
    <body>
    $form
HTML;

// A Recaptcha widget was then automatically added by the form render.
$jsScripts = $recaptcha->getJsScripts();

echo <<< HTML
    <!-- Recaptcha Scripts -->
    <script type="text/javascript">/* <![CDATA[ */$jsScripts/* ]]> */</script>
    <!-- / Recaptcha Scripts -->
    </body>
    </html>
HTML;

Asset autoloader

By default an asset autoloader places the JS in the HTML footer of all pages in the web application. You might want to call these scripts manually.

In Wordpress application

use Pollen\Recaptcha\RecaptchaInstance;

/** @var RecaptchaInstance $recaptcha */
$recaptcha = $this->config(['asset.autoloader' => true]);

add_action('wp_print_footer_scripts', function () use ($recaptcha) {
    echo "<!-- Recaptcha Scripts -->" .
    "<script type=\"text/javascript\">/* <![CDATA[ */" . $recaptcha->getJsScripts() . "/* ]]> */</script>" .
    "<!-- / Recaptcha Scripts -->";
});