=== NGP Donations ===
Contributors: signalfade, davidholtz
Tags: NGP, NGPVAN, Voter Action Network, donations, FEC, politics, fundraising
Requires at least: 3.0.0
Tested up to: 3.3.2
Stable tag: 0.2.2

Integrate NGP (NGP VAN) donation forms with your site. You'll need an SSL certificate running on your site if you want to use this.

== Description ==

This plugin helps you integrate NGP (NGP VAN) donation forms with your site. You'll need an SSL certificate running on your site if you want to use this.

This plugin is built and maintained by [Revolution Messaging, LLC](http://revolutionmessaging.com) and uses the New Media Campaigns' NGP API class.

= Alert! =

You should be running your site under an SSL certificate if you utilize this plugin.

== Installation ==

Go to `Settings -> General` and fill out the "NGP API Key", "Donation Support Phone Line", and "Addt'l Information for Donation Footer" fields.

"NGP API Key" is how this plugin authenticates with your NGP VAN service.

"Thanks for Contributing URL" is where the contributor is sent after a successful contribution.

"NGP Secure URL" is used if you need to specify a different secure URL than the site might have already been configured to use (for instance, your SSL cert is for donate.yourdomain.com, which points at your Wordpress site, but the site also loads under www.yourdomain.com).

"Donation Support Phone Line" is shown with the error message when the contribution gets rejected by the NGP VAN server.

"Addt'l Information for Donation Footer" might be used for listing things like donation mailing address, donation limits, taxable status of donations, etc.

If you want to work in a dev environment, use ".dev" as the TLD (We develop in virtual hosts on our developer machines. Edit /etc/hosts to add a .dev url). When this plugin is live, it forces SSL. Make sure `$_SERVER['HTTPS']` is set, valid and "on".

=== Suggested jQuery ===

We use the following on our donation pages to make sure that the user understands that the radio buttons and the input field are for the same thing. If the user doesn't support javascript and the custom field holds a value, it always overrides whatever's selected in the radio buttons.

	$('.ngp_custom_dollar_amt').keyup(function() {
		if($(this).val()!='') { $('.Amount').attr('checked', false); }
	});
	$('.Amount').mouseup(function() {
		$('.ngp_custom_dollar_amt').val('');
	});

== Usage ==

Place this short tag on the appropriate page or article:

`[ngp_show_form]`

== Changelog ==

= 0.2.2 =
* Fixed the custom amount error issue.
* Added in a ziptastic call to get City & State when not asking for them (but present as a hidden field).

= 0.2.1 =
* Wanted an error message for all the simple stuff (non-processing errors) at the top of the form.

= 0.2 =
* We had some problems where some themes happened to be writing headers early so the "Thanks" redirect would get blocked. This is fixed.
* "Full Name" wasn't being checked properly so that an error message could be prepended.

= 0.1 =
* First version. Works perfectly, not as featureful on the configuration side, though.