yamilovs / color-captcha-bundle
Symfony form type with color captcha.
Installs: 6 048
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 1
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=5.5.9
Requires (Dev)
- phpunit/phpunit: ~4.8|~5.0
- symfony/form: ~2.7|~3.0
- symfony/framework-bundle: ~2.7|~3.0
- symfony/translation: ~2.7|~3.0
- symfony/validator: ~3.0
README
ColorCaptchaBundle
This bundle will help you to implement a captcha feature with auto generated colors.
Installation
Step 1: Download YamilovsColorCaptchaBundle using composer
Add YamilovsColorCaptchaBundle by running the command:
$ php composer.phar require yamilovs/color-captcha-bundle ^1.0
Step 2: Enable the bundle
Enable the bundle in the kernel:
<?php // app/AppKernel.php public function registerBundles() { $bundles = array( // ... new Yamilovs\ColorCaptchaBundle\YamilovsColorCaptchaBundle(), ); }
Usage
In your form type add ColorCaptchaType:
<?php // src/FooBundle/Form/Type/BarType.php use Symfony\Component\Form\AbstractType; use Symfony\Component\Form\FormBuilderInterface; use Yamilovs\ColorCaptchaBundle\Form\Type\ColorCaptchaType; class BarType extends AbstractType { public function buildForm(FormBuilderInterface $builder, array $options) { $builder //.. ->add('captcha', ColorCaptchaType::class) ; } }
Then, add some styles for captcha markup. For a sample, in your css file:
.captcha-block { font-size: 18px; } .captcha-block .captcha-color { cursor: pointer; width: 50px; height: 50px; margin: 0 10px 0 0; float: left; transition: all 0.35s ease 0s; } .captcha-block .captcha-color:hover { opacity: 0.7; } .captcha-block .captcha-color.selected { -webkit-box-shadow: inset 0px 0px 0px 8px rgba(255,255,255,0.5); -moz-box-shadow: inset 0px 0px 0px 8px rgba(255,255,255,0.5); box-shadow: inset 0px 0px 0px 8px rgba(255,255,255,0.5); }
That's all!
Displaying the help text relative of the colors block
You can adjust how to display the help text globally through bundle configuration:
# app/config/config.yml yamilovs_color_captcha: # ...... help_text: # position can be 'top' or 'bottom' position: 'top' # default value is 'bottom'
Or just for a specific form type:
class FooType extends AbstractType { public function buildForm(FormBuilderInterface $builder, array $options) { $builder ->add('captcha', ColorCaptchaType::class, [ 'help_text_position' => 'top', ]) ; } }
Decrease number of colors
You can adjust only those colors that you want:
# app/config/config.yml yamilovs_color_captcha: # available colors are: 'red', 'blue', 'green', 'grey', 'pink', 'yellow' colors: ['red', 'yellow']
ToDo:
- How to create your own colors