Enlarge your fundraising corrupt by being paid your donors and fans involved in the fundraising administer. This plugin provides organizations the ability to allocate their fans and constituents to make their own custom online fundraisers using PayPal donations and additional payment methods. All donations for this plugin go to provide go-changing surgery for family ranking in the developing world. Learn extra at CURE International.

Installation Confidential Fundraiser

1. Upload the plugin to your plugins directory and activate.
2. Try out the settings by clicking on the Confidential Fundraiser admin menu cut.
3. Mark out the Confidential Fundraiser Fields that users will impart out when making a confidential fundraiser battle.
4. Check over/View the try out yield Aid Bring to somebody’s attention Money For My Yield to see a try out yield.
5. Make a new Yield from the Causes admin menu using the shortcode[pfund-check over] as well as the shortcode from the Confidential Fundraiser settings.
6. Steer to /<CAUSE SLUG> to see the list of available causes to make campaigns from.

Why must I use this plugin?

charity: water has raised over $10M using confidential fundraising campaigns. This plugin adds the capability of making confidential fundraising campaigns on your WordPress site.

What is a Yield?

A Yield is a pattern used to make fundraising campaigns. As an official you mark out the peek and feel of the campaigns that your users make.

When making or editing a yield, here are numerous things to keep in mentality:

1. Each yield needs to have the shortcode [pfund-check over] in the content. This enables the ability for users to make and/or check over campaigns.
2. Each yield must also have the shortcode [pfund-donate] in the content. This enables the ability for donations to be collected on campaigns made from the yield.
3. Besides the content specified in the WYSIWYG editor, each yield has a description and image field. These fields are showed on the yield list page.
4. If you bring up to date the peek and feel of a yield, all of the campaigns made from that yield will also have an updated peek and feel.

What shortcodes does this plugin provide?

Each of the fields defined in the Confidential Fundraiser Fields section of the Confidential Fundraiser settings has a corresponding shortcode. In addition, the plugin provides the subsequent shortcodes:

• [pfund-battle-list] Show the list of campaigns.
• [pfund-battle-permalink] Show the permalink(URL) for the battle.
• [pfund-yield-list] Show the list of causes.
• [pfund-comments] Show the comments/donations for the battle.
• [pfund-donate] PayPal donate button. This shortcode is vital in order to accept donations for the campaigns.
• [pfund-check over] Vital shortcode to show check over button.
• [pfund-camp-title] The title of the battle.
• [pfund-living-left] The number of living left in the battle (if an end date is specified for the battle).
• [pfund-gift-goal] The amount that the user hopes to bring to somebody’s attention for their battle.
• [pfund-gift-tally] The total amount raised.
• [pfund-giver-list] Displays a list of supporters for the contemporary battle. The supported attributes are:
  • row_max Number of supporters to show in one row. This attribute is simply used to add a css class to the last supporter in a row. The class is specified by the row_end_class attribute.
  • row_end_class Class to apply to last support in a row. This class is applied to the last supporter in a row.
• [pfund-giver-tally] The total number of unique donors to the battle.
• [pfund-user-avatar] The avatar of the user who made the battle. You can disorder the size of the avatar by passing a “size” attribute (e.g. [pfund-user-avatar size="50"].

What do the various settings do?

• Battle Slug URL prefix for campaigns. Also the location of the page containing the list of causes.
• Yield Slug URL prefix for causes. Also the location of the page containing the list of campaigns.
• Currency Symbol Currency symbol to show at that time to monetary amounts such as amount of donations expected.
• Date Format Date format to use to show dates. The date formats correspond to the ones defined at:http://codex.wordpress.org/Formatting_Date_and_Time. This plugin only supports the subsequent subset of formatting font:
  • d Day of the month.
  • j Day of the month with no chief zeros
  • m Numeric month chief zeros
  • n Numeric month lacking chief zeros
  • Y Full numeric year, 4 digits
  • y Numeric year: 2 digits
• Login Vital To Make If tartan, users must be logged in before they can make campaigns. If it is not tartan, users may make campaigns anonymously, but those campaigns stay in recruit reputation until the user kindling in. Once the user kindling in the battle is assigned to that user.
• Allocate Users To Register If users are not logged in, allocate them to register using the custom registration the confidential fundraiser plugin provides.
• Campaigns Require Approval If tartan, campaigns for logged in users are saved as Pending Assess until an admininstrator can approve them. Campaigns pending assess are only visible to the creator of the battle as well as admins. If this checkbox is not tartan, campaigns will be publicly visible as quickly as a logged in user saves them.
• User Roles that can submit campaigns Determines what user roles can make campaigns. This setting only affects anonymous campaigns after a user kindling in. If a battle is made anonymously, but the logged in user doesn’t have rights to submit a battle, the battle will stay in a recruit reputation indefintely.
• PayPal Options See not extra than
• MailChimp Options This plugin provides the ability to hurl transactional emails owing to MailChimp. The transactional emails must be made using MailChimp’s API.
• MailChimp API key MailChimp API key needed to hurl emails via MailChimp. This API key can be obtained by going to: API Key.
• Battle Approval Hurl by e-mail ID The MailChimp battle id of the transactional battle to use to hurl battle approved emails. The subsequent merge fields are voted for:
  • NAME The show name of the user who made the battle.
  • CAMP_TITLE The title of the battle.
  • CAMP_URL The URL for the battle.
• Battle Donation Hurl by e-mail ID The MailChimp battle id of the transactional battle to use to hurl battle donation emails. The subsequent merge fields are voted for:
  • NAME The show name of the user who made the battle.
  • CAMP_TITLE The title of the battle.
  • CAMP_URL The URL for the battle.
  • DONATE_AMT The amount donated.
• Goal Reached Hurl by e-mail ID The MailChimp battle id of the transactional battle to use to hurl an hurl by e-mail when the battle goal is reached. The subsequent merge fields are voted for:
  • NAME The show name of the user who made the battle.
  • CAMP_TITLE The title of the battle.
  • CAMP_URL The URL for the battle.
  • GOAL_AMT The goal that was reached.
• Confidential Fundraiser Fields Defines the fields that are available for use for confidential fundraisers. Each field has the subsequent settings:
  • Categorize The copy to show to identify this field on the battle creation/check over screen.
  • Description A longer copy description of the field that will be showed on the battle creation/check over screen.
  • Category Defines the category of field. The subsequent types are available:
    • Date Selector Displays a date picker to the user.
    • Battle Title The field used to power the battle title. This field is vital and the category cannot be changed.
    • Battle URL slug The field used to power the battle url suffix. This field is vital and the category cannot be changed.
    • End Date The field used to power the battle end date. The category of this field cannot be changed.
    • Generous Copy Participation (textarea) Provides a generous textbox for users to provide copy.
    • Image Provides an image upload.
    • Select Dropdown Displays a dropdown for users to select a regard.
    • Copy Participation Unadorned copy participation field.
    • Flat Participation Intended for future enhancement. Generally the thought of this field is pass by the side of flat data when a donation is processed. Useful if you need additional fields to compartmentalize donations.
    • User Hurl by e-mail Hurl by e-mail field that will default to the user’s hurl by e-mail but can be overriden with any valid hurl by e-mail address.
    • User Show Name Copy participation field that defaults to the user’s show name but can be overriden with any regard.
    • User Goal The field used to power the battle goal. This field is vital and the category cannot be changed.
  • Data Currently only used by Select Dropdown fields, this field defines the valid values for the decline not working. Each regard for the decline not working must be separated by a new line.
  • Vital If this checkbox is tartan, this field is vital in order to make or bring up to date the battle.
  • Shortcode The shortcode to use to show this field on the battle.
  • Actions Actions that can be full on the field:
    • Delete the field. Note that the field will not really be deleted until you click on the “Save Changes” button.
    • Go Up/Go Not working Exchange the show order of the field on the battle creation/check over screen.

How do I use PayPal?

Using PayPal requires a Premier or Affair PayPal account. Also here two fields on the Confidential Fundraising settings screen that must be set. These values can be obtained by sorting into PayPal:

Donate Button Code

1. Click on Merchant Air force.
2. Under Make Buttons, click on Donate.
3. Impart in your Organization name and optionally impart in a Donation ID. In cooperation these values will be showed to the user during the PayPal checkout administer.
4. Optionally, you may get on to to order the copy or appearance of the button.
5. For contribution amount, select Donors enter their own contribution amount.
6. For Merchant account IDs, select Use my secure merchant account ID.
7. Click on Make Button.
8. Imitation all of the HTML code from the Website tab and paste it in the Donate Button Code field.

PayPal has extra information on using a donate button here: PayPal Donate Button.

Payment Data Transfer Token

1. Click My Account tab.
2. Click on Profile.
3. Click Website Payment Preferences in the Seller Preferences column.
4. Get on to sure that Car Return for Website Payments is turned on.
5. For Return URL, disorder your site’s URL. The plugin will override this regard to return to the battle once a donation is processed.
6. Under the Payment Data Transfer (discretionary) section, get on to sure that Payment Data Transfer is On. If it is already on, imitation the Identity Token regard and paste it into the Payment Data Transfer Token field. If it is not on, curve it on, click on Save at the bottom of the page and at that time click Website Payment Preferences in the Seller Preferences column to show the screen again with the Identity Token regard.

Use PayPal Sandbox If you are using PayPal’s developer sandbox for hard, try out this checkbox; otherwise leave it unchecked.