ReCaptcha w django w 10 minut

1. Ściągamy recaptcha-django - bardzo małą i przyjemną aplikację, która udostępnia funkcjonalność ReCaptcha w sposób, jakiego nie powstydziliby się twórcy django:

svn checkout http://recaptcha-django.googlecode.com/svn/trunk/ recaptcha-django-read-only

2. Przenosimy folder recaptcha_django do folderu z naszym projektem (niech to będzie mysite), dodajemy 'recaptcha_django' do INSTALLED_APPS w mysite/settings.py. Dodajemy także załączony middleware - do MIDDLEWARE_CLASSES w settings.py dopisujemy na końcu 'recaptcha_django.middleware.ReCaptchaMiddleware'. Ten mały middleware dodaje do POST-a odpowiednich żądań http informacje o ip klienta potrzebną recaptcha. Proponuję odpalić serwer deweloperski. Możesz mieć szczęście i zobaczyć, że brakuje jakiegoś modułu... Wtedy następny punkt jest dla Ciebie.

3. Nie na każdym serwerze jest zainstalowany pythonowy moduł recaptcha-client. Dlatego ściągamy go. Jedynym czego trzeba, by jakiś moduł był dostępny w pythonie, jest obecność tego modułu na ścieżce wyszukiwań modułów [wooow!...], która w przypadku django obejmuje główny katalog projektu (mysite/). Tak więc wrzucamy katalog recaptcha z rozpakowanego archiwum do mysite/.

4. Jeszcze raz odpalamy serwer developerski. Tym razem powinien wstać. Zabieramy się do wzbogacenia naszego formularza (form):

#mysite/forms.py
from django import forms

from recaptcha_django import *

class PortalRegistrationForm(forms.Form):
    #tu jakieś mało istotne pola
    #...
    recaptcha = ReCaptchaField()

Odpalamy serwer, wchodzimy na stronę z naszą formą i widzimy, że brakuje jakichś dziwnych ustawień (RECAPTCHA_PUBLIC_KEY i RECAPTCHA_PRIVATE_KEY). Wpadamy na pomysł, żeby zarejestrować się na ReCaptcha. W nagrodę dostaniemy upragnione wartości zmiennych RECAPTCHA_PUBLIC_KEY i RECAPTCHA_PRIVATE_KEY, które wpisujemy do mysite/settings.py.

I tyle!

Jeśli ktoś chce mieć mniej standardową ReCapchę i chciałby przy okazji poznać kawałek django, to może czytać dalej:

[polecam aplikację django-regitration autorstwa James'a Bennett'a (a.k.a. ubernostrum)]

from registration.forms import RegistrationForm

class PortalRegistrationForm(RegistrationForm):
    recaptcha = ReCaptchaField(
        label='''Prove that you're a human:''' 
        #tak oto w django definiuje się niestandardowy opis dla pola formularza

        widget=ReCaptchaWidget(
            attrs={'theme': 'blackglass'}),  #zmieniamy skórkę
        # a tak podaje się atrybuty elementom HTMLa do których zostanie
        # wyrenderowany formularz. Pisząc 'atrybuty' myślę tu [w przypadku
        # standardowych Widget-ów django] o atrybutach HTML,
        # np. rows dla textarea:
    komentarz = forms.CharField(
        widget=forms.Textarea(attrs={'rows': 3})) #krótki komentarz.
    )

Naturalnym pytaniem jest: jakie są inne skórki dla ReCaptcha? Odpowiedź tutaj.

EDIT:
Niestety, RecaptchaField wyświetla ochydny error-code zamiast ładnego komunikatu o błędzie. Czytałem trochę ReCaptcha API, ale tam utrzymują, że kody błędów mogą się zmieniać i żeby się tego nie trzymać. Jako że domyślny widget captchy wyświetla komunikat o błędzie, starczy pozbyć się brzydkiego komunikatu o błędzie:

class PortalRegistrationForm(RegistrationForm):
    #...jak wyżej...

    def clean(self):
        cleaned_data = super(PortalRegistrationForm, self).clean()
        if 'recaptcha' in self._errors:
            self._errors['recaptcha'] = forms.util.ErrorList([])
        return cleaned_data 
        #jak piszą w dokumentacji, "ALWAYS return the cleaned_data" :)

Przeciążamy tutaj metodę odpowiadającą za sprawdzanie poprawnośći formularza tak, by zrobiła to, co zrobiłaby normalnie [super()], a potem zastępujemy listę błędów dla pola 'recaptcha' listą pustą. Krótki, nieinwazyjny, ale dalej hack.