bandaid

Bandaid is a WordPress plugin, used to display the current fundraising progress.

band-aid_v1.zipDownload

=== Band Aid ===

  • Author: Michael Lapkin
  • Link: http://michael.lapkin.net/bandaid
  • Tags: comments, spam
  • 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

2020-21 Fundraiser

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

== Description ==

Bandaid is a implemented using the shortcode: "bandaid".
Bandaid displays the goal, total amount collected, and the number of contributions, and can display static data (entered manually), or active data (retrieved from a database table).

== Configuration ==

Visit demo our Sample Fundraiser Page page for examples.

STATIC configuration

The following attributes are required to run Bandaid in static mode:

goal

The unformatted amount of the fundraiser goal (i.e. for $40,000, enter 40000)

goal="40000"

current

The unformatted current amount (i.e. for $40,000, enter 40000)

current="24450"

ACTIVE configuration

The following attributes are required to run Bandaid in active mode:

goal

The unformatted amount of the fundraiser goal (i.e. for $40,000, enter 40000)

goal="40000"

table

The name of the table which stores fundraising donations

table="Donations"

column

The name of the column containing the amount of each donation

column="Amount"

OPTIONAL

The folllowing attributes are optional:

title_text

Display a title

title_text="2020-21 Fundraiser"
goal_text

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!"
show_count

Display number of donations. Set to “true”.

show_count="true"
count_text

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!"
current_offset

Adjust the total value returned from db. Enter unformated dollar value.

current_offset="4500"
count_offset

Adjust the total number of donations returned from db. Enter unformated value.

count_offset="23"
colors

Specify color scheme. Value is a list of HEX/RGB CSS color values, separated by “|”.

Six values must be defined: [title, goal, bar1, bar2, current total, count]

default scheme

colors="rgb(40,40,40)|rgb(20, 108, 195)|rgb(20, 108, 195)|rgb(119, 195, 236)|rgb(20, 108, 195)|rgb(40,40,40)"

red scheme

colors="rgb(40,40,40)|rgb(241, 58, 58)|rgb(255, 50, 50)|rgb(250, 50, 50,.2)|rgb(110, 107, 107)|rgb(110, 107, 107)"

Visit demo page page for sample usage

Note: Multiple bandaids may be used in each page, and independently configured.

== Installation ==

  1. Uncompress band-aid.zip to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Place bandaid shortcode in your posts & specify required attributes