=== Slider CAPTCHA ===
Contributors: vaurdan, jpargana, playoutpt
Donate link: https://dsi.tecnico.ulisboa.pt
Tags: slider, captcha, ui, comment, comments, responsive, spam, antispam, anti-spam, jquery, jquery-ui, plugin, registation, login, form, password reset, security, secure
Requires at least: 3.5
Tested up to: 3.9
Stable tag: 1.0
License: GPLv3
License URI: https://www.gnu.org/copyleft/gpl.html

Slider CAPTCHA is a WordPress plugin that will allow you to replace or add a CAPTCHA field to any WordPress form.

== Description ==

Using Slider CAPTCHA, you can replace or add a CAPTCHA to your WordPress forms. By default, Slider CAPTCHA will add a CAPTCHA to your templates' comment form. You can also add sliders to the Registration form, Password Recovery form and the Login form.

Besides, you can use the `slider_captcha()` function to insert a Slider CAPTCHA wherever you want, and fully costumize it.

With our brand new Settings page, you can now fully custumize every Slider on your WordPress installation and live preview the result. In the upcoming version, you will be able to create your own slider. At the moment, if you want to create your own custom slider you should use the `slider_captcha()`. Check the FAQ for more info.

**Current possible Slider CAPTCHA locations:**

* Comments page
* Login page
* Registration page
* Lost Password page


== Installation ==

1. Install Slider CAPTCHA either via the WordPress.org plugin directory, or by uploading the files to your server (`/wp-content/plugins/`) 
2. Activation can be made in 'Plugins' menu
3. Configure and enable the sliders you want to have on your website.
4. Have fun.

**Did you know...** If you can't see any CAPTCHA on your Comment's page, you must edit comments.<?php of your template and add the following code in the position that you want to have your CAPTCHA.
`<?php if(function_exists('slider_captcha'))
	slider_captcha('comments');
?>`

== Frequently Asked Questions ==

= I've activated the plugin, but I can't see any CAPTCHA... What can I do? =

That's probabily because of the way your theme is built. You will have to edit your comments.php of your template and add the following code in the position that you want to have your CAPTCHA.
`<?php if(function_exists('slider_captcha'))
	slider_captcha('comments');
?>`

= What if I want to add another Slider? Can I costumize it? =
Yes, at the moment you have four places where you can place automaticly your Slider CAPTCHA:
* The comment form, enabled by default;
* The user registration form;
* The lost password form;
* The user login form.

You can costumize each of this sliders, or use the General Settings to have your settings all across your sliders.

If you want to insert your slider in any another position, you can use the `slider_captcha($slider_name, $container, $params)` function to insert a new Slider CAPTCHA.
The `$slider_name` is the name of your slider. You can also use 'general', 'registration', 'comments', 'login', 'reset_password' if you want to use any of the existing themes.
The `$container` is the container where your CAPTCHA will be placed. By default it is "p".
The `$params` is an array where you can costumize the Slider Captcha, acording to this:
`{
	type: "filled",
	textFeedbackAnimation: 'swipe_overlap',
	hintText: "Swipe to submit",
	hintTextSize: '12px',
	hintTextAfterUnlock: 'You can submit now',
	styles: {
		knobColor: "#5CDF3B",
		knobColorAfterUnlock: "#000000",
		backgroundColor: "#444",
		textColor: "#fff",
		textColorAfterUnlock: "#fff",
		width: '90%',
		height: '35px'
	},
	face: {
		top: 4,
		right: 9,
		icon: 'right-thin',
		textColor: '#ddd',
		textColorAfterUnlock: '#5CDF3B',
		topAfterUnlock: 3,
		rightAfterUnlock: 9,				
		iconAfterUnlock: 'flag'
	},
	events: {
		afterUnlock: function () {	},
		beforeUnlock: function () {	},
		beforeSubmit: function () {	},
		submitAfterUnlock: 0,
		validateOnServer: 1,
		validateOnServerParamName: "my_form_param_name"
	}
}`

For instance, if you want to change your hint text and your width, you must send the following array:
`$param = array(
	'hintText' => 'your new hint text',
	'styles' => array(
		'width' => '300px' //this can be a %
	),
);`

To add a class to the container, you can use `'containerClass' => 'nameoftheclass'` on your $params array.

= How do I change the appearence of the comment form Slider Captcha? =
If you want to change the appearance of your default CAPTCHA, you can play with the settings panel.

= I can't see Sliders on the Login/Registration/Password Lost page... What is the problem? =
If you are not seeing the sliders, probabily they are disabled on the settings page. If you still can't see any slider after the activation, please submit a support thread so we can help you.

= Oh dear, I've updated from 0.5 and my custom sliders are with a weird look/behave. What should I do? =
One of the changes from the 0.5 to the 1.0 was the `slider_captcha()` function. We added an new argument and the function signature is now `slider_captcha($slider_name = 'general', $container = 'p', $settings = null)`. Because of that, you may have to add a new argument on the first position, with the name of your slider.

Also, the name of the `$params keys also have changed. Please verify if your `$params` array is updated.

== Screenshots ==

1. The default slider on the WordPress Twenty Fourteen theme.

2. Settings panel 

3. The live preview

== Changelog ==

= 1.0 =
* Code refactorization
* Multiple sliders on the same page are now possible
* Settings page included with live preview
* Updated jQuery Slider Captcha to the latest version with new properties names
* Added three extra sliders (register form; login form; lost password form.)
* Bug fixes

= 0.5.4 =
* Fixed bug with wrong settings on Comment Form captcha.

= 0.5.2 =
* Added `containerClass` setting to allow a custom class name to the container
* Fixed bug with Entypo on Windows deviced
* Added new version of jQuery UI Slider Captcha

= 0.5.1 =
* jQuery Slider Captcha version updated with bugfix in HTML5 form validations

= 0.5 =
* Initial release.

== Upgrade Notice ==

= Update now! Version 1.0 released =  
New settings page where you can configure as many sliders as you like!

= 0.5 =
Initial release