This is a Play Framework module for Scala, to provide integration with Google reCAPTCHA in a reactive (non-blocking) manner.
| Module Revision | reCAPTCHA Versions | Play Version | Scala Versions | ScalaDoc |
|---|---|---|---|---|
| 3.0 | v2, invisible | 3.0.x+ | 3.x | ScalaDoc |
- Migrated to support Play 3.0.x+
- Converted all source code to Scala 3 syntax
- Migrated unit tests to Scala 3 compatible libraries
- Migrated to support Play 2.9.2+
Many thanks to @mashijp for the pull request!
- Migrated to support Play 2.8.8+
Many thanks to @gmixa for the pull request!
- Migrated to support Play 2.7.3+ and Scala 2.13
- Added CSRF to the example forms
Many thanks to @gmixa for the pull request!
- Migrated to support Play 2.6
- Minor changes to the APIs to best support Play 2.6 features
- Added support for Content Security Policy with nonces
Many thanks to @akitaylor for the pull request!
- Added support for invisible reCAPTCHA
- Added support for AJAX form submission
- Added support for optional HTML attribute arguments
- Refactored recaptchaField to simplify alternative HTML field layouts
Many thanks to @varju for the pull request!
- Added extra customisations for reCAPTCHA v2 language, tabindex and size options
- Removed support for reCAPTCHA v1, since Google no longer supports it or issues new API keys, and it helped greatly simplify the codebase.
- Added support for Play 2.5.x
Another version jump because the API has changed to accommodate Play no longer having any static configuration. As before, the functionality and the rest of the APIs have not changed at all.
Many thanks to @gmalouf and @akitaylor for the pull requests!
- Added support for Play 2.4.x (converted from a Plugin to a DI Module)
Why the version number jump? Well, the way the module is used (injected via DI) has changed, and the APIs have been updated to use Play 2.4 i18n, so this release is only compatible with Play 2.4. However, the functionality and the rest of the APIs have not changed at all.
- Added support for reCAPTCHA version 2 (aka no-captcha reCAPTCHA)
- Added full support for internationalisation (Play i18n and reCAPTCHA language and custom strings)
- Added security settings (invoke service and widget using HTTP or HTTPS)
- Initial release
The play-recaptcha module is distributed using Maven Central so it can be easily added as a library dependency in your Play Application's SBT build scripts, as follows:
"com.nappin" %% "play-recaptcha" % "3.0"
Please see this example:
for a ready-to-use internationalised Scala Play web application using this module, using reCAPTCHA v2 and Invisible reCAPTCHA, with Play Forms and with JavaScript/AJAX. You can download this code and run it in Play, or you can follow the instructions below to add this module to an existing web application.
The play-recaptcha module comes with two APIs:
- High Level API - that integrates with Play's Form APIs
- Low Level API - that has no such dependency
Unless you are using a non-standard approach in your Play Scala applications, the High Level API is the one to use - it is much simpler and requires much less code.