=== Slider CAPTCHA ===
Contributors: vaurdan, jpargana
Donate link: https://dsi.tecnico.ulisboa.pt
Tags: slider, captcha, comment, spam
Requires at least: 3.0
Tested up to: 3.5
Stable tag: 0.5
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==

Using Slider CAPTCHA, you can replace or add a CAPTCHA to your WordPress forms. By default, Slider CAPTCHA will try to add a CAPTCHA to your templates' comment form.

You can also use `slider_captcha()` function to insert a CAPTCHA wherever you want, and fully costumize your CAPTCHA.

At the moment, this plugin is really simple and basic, but in the upcoming versions, a Settings page will be added and you will be able to create your own sliders.

== 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. 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();
?>`

== 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();
?>`

== What if I want to add another Slider? Can I costumize it? ==
Sure, you can use the `slider_captcha($container, $params)` function to insert a new Slider Captcha.
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',
	textAfterUnlock: 'You can submit now',
	styles: {
		knobColor: "#5CDF3B",
		disabledKnobColor: "#000000",
		backgroundColor: "#444",
		textColor: "#fff",
		unlockTextColor: "#fff",
		width: '90%',
		height: '35px'
	},
	face: {
		topStart: 4,
		rightStart: 9,
		entypoStart: 'right-thin',
		textColorStart: '#ddd',
		textColorEnd: '#5CDF3B',
		topEnd: 3,
		rightEnd: 9,				
		entypoEnd: 'flag'
	},
	events: {
		afterUnlock: function () {
			console.log("afterUnlock event");
		},
		beforeUnlock: function () {
			console.log("afterSubmit event");
		},
		beforeSubmit: function () {
			console.log("beforeSubmit event");
		},
		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 %
	),
);`

== Screenshots ==

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

== Changelog ==

= 0.5 =
* Initial release.

== Upgrade Notice ==

= 0.5 =
Initial release