bandaid-SMHS-deets

2020-21 Fundraiser

$24,000
$13,750
 We've received 5 donations, for a total of $13,750!

=== Band Aid ===

  • Author: Michael Lapkin
  • Link: http://michael.lapkin.net/bandaid4smhs
  • Tags: progress bar
  • Requires at least: 4.7
  • Tested up to: 4.7
  • Stable tag: 1.0
  • License: GPLv2 or later
  • License URI: http://www.gnu.org/licenses/gpl-2.0.html

== Configuration ==

Visit demo our Sample Fundraiser Page page for examples.

  • You gotta set a goal for it to make any sense, and for that matter, you really need some transactions.
  • You can pick a single or recurring transaction table, or one of each.
  • Attributes in the short code define tables, fields, and other options.
  • Gravity Forms GFAPI is used to retrieve names and donation amounts.
  • Stripe API is used to retrieve the total of all transactions for recurring payment donations.
  • Stripe keys are required to calculate recurring transactions, and are configured in the Bandaid Settings panel in WordPress.

A goal is required to run Bandaid. Enter the unformatted amount of the fundraiser goal (i.e. for $40,000, just enter goal=”40000″).
goal="40000"

  • To include transactions from a single transaction Gravity Form, specify the form_id containing one time donations.
    otd_form_id="14"
  • Include the field_id containing the total amount of each donation.
    otd_amount_field_id="3"
  • (optional) Include the field_id containing then name to be displayed for each donation.
    otd_name_field_id="2.6"
  • To include transactions from a recurring transaction Gravity Form, specify the form_id containing subscription donations.
    rec_form_id="15'
  • (optional) Include the field_id containing then name to be displayed for each donation.
    rec_name_field_id="2.6"
  • To display a list of available Gravity Forms:
    show_forms="1"
  • To display a list of available fields on a Gravity Form, specify the form_id.
    show_fields_for_form_id="14"

  • OPTIONAL –
    The folllowing attributes are optional:
  • Display transaction details for configuration and testing:
    show_deets="1"
  • Test Stripe auth
    stripe_auth_test="1"
  • Display a title:
    title_text="2020-21 Fundraiser"
  • Display custom text with goal amount. Goal amount will be appended to this string, or will replace “%d” token in string.
    goal_text="Help us get to %d!"
  • Display number of donations.
    `show_count=”true”
  • Display custom text with current count of donations and/or amount Tokens in string will be replaced by values. “%c” = count; “%d” = current total.
    count_text="We've received %c donations, for a total of %d!"
  • Display thanks_text & names. Set to “true” (requires name fields specified with forms)
    `show_thanks=”true”
  • Display custom text with current count of donations and/or amount Tokens in string will be replaced by values. “%c” = count; “%d” = current total.
    thanks_text="We've received %c donations, for a total of %d!"
  • specify colors of elements using HEX/RGB/CSS color values, separated by “|”. Eight(8) values must be defined: [title|goal|bar1|bar2|total|count|thanks|names]
    colors="BLUE|#FFAD66|rgb(20, 108, 195)|rgb(119, 195, 236)|||RED|rgb(40,40,40)"

Visit example page page

Note: Multiple bandaids may be independently configured on each page.

== Installation ==

  1. Uncompress smhs_bandaid.zip to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Place [smhs_bandaid] shortcode in your posts & specify required attributes
  4. Enter Stripe keys in “Bandaid Options”

DOWNLOAD