dario_swain / re-captcha-validator
Google reCaptcha FormType and Validator for Symfony applications.
Requires
- php: >=5.3.3
- dario_swain/re-captcha-library: 1.0.*
Requires (Dev)
- phpunit/phpunit: ~4.0
- squizlabs/php_codesniffer: ~2.0
- symfony/form: ~2.3|~3.0
- symfony/framework-bundle: ~2.3|~3.0
- symfony/validator: ~2.3|~3.0
This package is not auto-updated.
Last update: 2024-11-05 04:58:58 UTC
README
Really light and simple reCAPTCHA component for Symfony Frameworks, it's not a Bundle, you can reconfigure all components whatever you like.
You can find full documentation about Google reCAPTCHA API v2 here.
Installation
You can install this package with Composer. Add next lines to your composer.json file:
{ "require": { "dario_swain/re-captcha-validator": "dev-master" }, "scripts": { "post-install-cmd": [ "DS\\Component\\ReCaptchaValidator\\Composer\\ScriptHandler::replaceViews" ], "post-update-cmd": [ "DS\\Component\\ReCaptchaValidator\\Composer\\ScriptHandler::replaceViews" ] }, }
To use this package with php version ~ 5.3 use version ~ 1.0
Usage Example
Add public and private keys, and configure reCAPTCHA Form Type like a service, provide next configuration to application bundle service configuration (service.yml):
parameters: ds_recaptcha_public_key: #YOUR_PUBLIC_KEY# ds_recaptcha_private_key: #YOUR_PRIVATE_KEY# services: ds.form.type.recaptcha: class: DS\Component\ReCaptchaValidator\Form\ReCaptchaType arguments: ['@request_stack', %ds_recaptcha_public_key%, %ds_recaptcha_private_key%, %locale%] tags: - { name: form.type, alias: ds_recaptcha }
After this you can add reCAPTCHA type to your custom form:
<?php namespace AcmeBundle\Form; use Symfony\Component\Form\AbstractType; use Symfony\Component\Form\FormBuilderInterface; use Symfony\Component\OptionsResolver\OptionsResolverInterface; class ContactType extends AbstractType { public function buildForm(FormBuilderInterface $builder, array $options) { $builder->add('message', 'textarea') /** In type add your form alias **/ ->add('captcha', 'ds_recaptcha', array('mapped' => false)) ->add('send', 'submit'); } public function setDefaultOptions(OptionsResolverInterface $resolver) { $resolver->setDefaults(array( /** This option is require, because reCaptcha api.js add extra field "g-recaptcha-response" to form **/ 'allow_extra_fields' => true, )); } }
Next step, you need to add form_theme to your form view, it seems like that:
{% extends 'AcmeBundle::layout.html.twig' %} {% form_theme form 'DS/ReCaptcha/views/form_div_layout.html.twig' %} {% block content %} {{ form_start(form) }} {{ form_widget(form) }} {{ form_end(form) }} {% endblock %}
If you need to customize from widget, feel free to change template in %kernel_root%/Resources/DS/ReCaptcha/views/form_div_layout.twig
Copyright
Copyright (c) 2015 Ilya Pokamestov dario_swain@yahoo.com.