Django nocaptcha recaptcha form field/widget app
Python HTML
Latest commit b6d8007 Mar 29, 2016 @imagescape imagescape updated travis
Permalink
Failed to load latest commit information.
demo Some pep8 and style fixes. Dec 12, 2014
nocaptcha_recaptcha bump version Mar 29, 2016
.gitignore updated setup.py read function Dec 10, 2014
.travis.yml updated travis Mar 29, 2016
AUTHORS bump version Mar 29, 2016
LICENSE update Dec 10, 2014
MANIFEST.in cleanup of manifest Dec 11, 2014
README.md added build status icon Dec 16, 2014
setup.py bump version Mar 29, 2016
test_settings.py Some pep8 and style fixes. Dec 12, 2014

README.md

Build Status

SUMMARY

Add new-style Google ReCaptcha widgets to your Django forms simply by adding a NoReCaptchaField field to said forms.

ABOUT

In late 2014, Google updated their ReCaptcha service, changing its API. The update significantly changes the appearance and function of ReCaptcha. This has been referred to as ReCaptcha 2 or "nocaptcha recaptcha".

This module is intended to be a successor to django-recaptcha to support the new style Google Recaptcha. It borrows a lot of the logic from the django-recaptcha, but has been updated to support the Google change.

For the Google documentation for this service, visit the following:

https://developers.google.com/recaptcha/intro

The original django-recaptcha project is located at the following location:

https://github.com/praekelt/django-recaptcha

FEATURES

  • Implements Google's New "NoCaptcha ReCaptcha Field"
  • Uses the fallback option for browsers without JavaScript
  • Easy to add to a Form via a FormField
  • Works similar to django-recaptcha
  • Working demo projects
  • Works with Python 2.7 and 3.4

INSTALL

pip install django-nocaptcha-recaptcha

CONFIGURE

Add nocaptcha_recaptcha to your INSTALLED_APPS setting

Add the following to settings.py

Required settings: 
NORECAPTCHA_SITE_KEY  (string) = the Google provided site_key
NORECAPTCHA_SECRET_KEY (string) = the Google provided secret_key 

Optional Settings:
NORECAPTCHA_VERIFY_URL (string) = reCaptcha api endpoint for verification.
    Best to leave this as the default setting.
    Default is https://www.google.com/recaptcha/api/siteverify
NORECAPTCHA_WIDGET_TEMPLATE (string) = location for the widget template.  
    Default is nocaptcha_recaptcha/widget.html

Add the field to a form that you want to protect.

from nocaptcha_recaptcha.fields import NoReCaptchaField

class DemoForm(forms.Form):
    .....
    captcha = NoReCaptchaField()

Add Google's JavaScript library to your base template or elsewhere, so it is available on the page containing the django form.

<script src="https://www.google.com/recaptcha/api.js" async defer></script>     

(optional) You can customize the field.

  • You can add attributes to the g-recaptcha div tag through the following

    captcha = NoReCaptchaField(gtag_attrs={'data-theme':'dark'}))

  • You can override the template for the widget like you would any other django template.

DEMO PROJECT

The demo project includes a fully working example of this module. To use it, run the following:

cd demo
export NORECAPTCHA_SITE_KEY="<your site key>"
export NORECAPTCHA_SECRET_KEY="<your secret key>"
./manage.py runserver 

# in a browser, visit http://localhost:8000

TESTING

python setup.py test