=== Donate Plus ===
Contributors: skullbit, devbit
Donate link: http://skullbit.com/donate
Tags: donate, donation, recognition, paypal
Requires at least: 2.6
Tested up to: 2.7
Stable tag: 1.2

Donation form. Recognition wall.  Donation total tracker. PayPal integration. 

== Description ==

This plugin will allow you to place the shortcode `[donateplus]` on a WordPress page and accept donations.  The form includes the option to be recognized on your website after the donation is received.  The Recognition wall can be placed on any WordPress page using the shortcode `[donorwall]`.  You can display your running donation total using the shortcode `[donatetotal]`. The entire plugin is integrated with PayPal IPN so it will receive notification once a donation payment has been processed and put the donor information into your website (if they opted to be displayed).  The donor can promote his name and website, along with some comments on the Recognition Wall.  This should hopefully encourage donaters who like recognition to be more likely to contribute to you or your cause.

== Installation ==

1. Upload the `donate_plus` directory to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Set the options in the Settings Panel
1. Put the shortcode `[donateplus]` on your donation page to display the donate form.
1. Put the shortcode `[donatewall]` on your donation page or a seperate page to display the Donation Recognition Wall.
1. Use the shortcode `[donortotal]` to display your running total of donations to date.

== Frequently Asked Questions ==

= What are shortcodes? =

A shortcode is a WordPress-specific code that lets you do nifty things with very little effort. Shortcodes can embed files or create objects that would normally require lots of complicated, ugly code in just one line. Shortcode = shortcut.  To use a shortcode, simple enter it on the page or post in your WordPress blog as described below and it will be replaced on the live page with the additional functionality.

= What shortcodes does Donate Plus offer? =

`[donateplus]`
This shortcode will display the Donate Plus donation form

`[donorwall]`
This shortcode will display the Donor Recognition Wall. Optional attribute: title is wrapped within a `<h2>` tag. Usage is `[donorwall title='Donor Recognition Wall']`

`[donatetotal]`
This shortcode will display the total donations received. Optional attributes: prefix is the currency symbol (ie. $), suffix is the currency code (ie. USD), type is the english description (ie. U.S. Dollar). Usage is `[donatetotal prefix='true', suffix='true', type='false']`

= What kind of PayPal account will I need? = 
You will need a Premier or Business account.  Personal accounts are primarily for sending payments and may not include the PayPal IPN features this plugin requires.

== Screenshots ==

1. WordPress Setting Page
2. Example of Donation Form
3. Example of Recognition Wall

== Changelog ==

**Dec. 7, 2008 - v1.2**
* Altered Paypal IPN script to use `mc_amount` variable instead of `payment_amount`
* Fixed {wall} url replacement - was putting link ID, not actual link in the Thank You email.

**Dec. 7, 2008 - v1.1**
* Replaced testing url in form back to PayPal url.