CaptchaBundle/README.md

1.4 KiB

Gregwar's CaptchaBundle

GregwarCaptchaBundle provides the form type "captcha"

Installation

To install GregwarCaptchaBundle, first adds it to your deps:

[GregwarCaptchaBundle]
    git=git://github.com/Gregwar/CaptchaBundle.git
    target=/bundles/Gregwar/CaptchaBundle

And run php bin/vendors install. Then add the namespace to your app/autoload.php file:

<?php
...
'Gregwar' => __DIR__.'/../vendor/bundles',
...

And registers the bundle in your app/AppKernel.php:

<?php
//...
public function registerBundles()
{
    $bundles = array(
        ...
        new Gregwar\CaptchaBundle\GregwarCaptchaBundle(),
        ...
    );
...

Adds the following configuration to your app/config/config.yml:

gregwar_captcha: ~

Usage

You can use the "captcha" type in your forms this way:

<?php
    // ...
    $builder->add('captcha', 'captcha'); // That's all !
    // ...

Note that the generated image will be embeded in the HTML document, to avoid dealing with route and subrequests.

Form theming

If you want to put the image in an other way, you can form theme captcha_bundle (this is the default behavior) :

{% block captcha_widget %}
    <img src="{{ captcha_code }}" title="captcha" width="120" height="40" />
    {{ form_widget(form) }}
{% endblock %}

License

This bundle is under MIT license