NAME

Mojolicious::Plugin::ReCAPTCHAv2Async - Adds async recaptcha_verify_p helper to Mojolicious ReCAPTCHAv2 plugin.

VERSION

version 0.001

SYNOPSIS

use Mojolicious::Lite;

plugin(
  ReCAPTCHAv2Async => {
    sitekey => 'site-key-embedded-in-public-html',
    secret  => 'key-used-in-internal-verification-requests',
    ... # and all the rest from ReCAPTCHAv2
  }
);

# later

# assembling website:
$c->stash( captcha => app->recaptcha_get_html );
# now use stashed value in your HTML template, i.e.: <form..>...<% $captcha %>...</form>

# on incoming request:
sub form_handler {
  my $c = shift;

  $c->render_later;

  $c->recaptcha_verify_p->then(
    sub {
      ...
      $c->render('success');
    }
  )->catch(
    sub {
      my @errors = @_;
      if (@errors) {
        $c->reply->exception(join "\n", @errors);
      }
      else {
        $c->render(text => "no bots allowed", status 403);
      }
    }
  );
}

# or in an under:
under sub {
  my $c = shift;

  $c->render_later;
  
  $c->recaptcha_verify_p->then(
    sub { $c->continue }
  )->catch(
    sub { $c->reply->exception(...)  }
  );

  return undef;
};

DESCRIPTION

This subclass of Mojolicious::Plugin::ReCAPTCHAv2 adds a helper that returns a Mojo::Promise, allowing you to use it in a non-blocking/async manner.

HELPERS

Mojolicious::Plugin::ReCAPTCHAv2Async inherits all helpers from Mojolicious::Plugin::ReCAPTCHAv2 and adds the following ones:

recaptcha_verify_p

This helper returns a Mojo::Promise that will resolve if the reCAPTCHA service believes that the challenge was solved by a human, and it will reject if there was a failure. The failure can be caused either by an error or because the service believes the challenge was attempted by a bot.

In case of errors, those will be passed through the rejection. See the recaptcha_get_errors helper for more information about the possible errors.

SEE ALSO

Mojolicious

Mojolicious::Plugin::ReCAPTCHAv2

AUTHOR

Andreas Guldstrand <andreas.guldstrand@gmail.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018 by Andreas Guldstrand.

This is free software, licensed under:

The MIT (X11) License