Plugin / News Match Donation Shortcode

Description

The News Match Donation Shortcode plugin creates a donation form compatible with the News Revenue Hub and News Match donation systems. The plugin allows you to configure donation levels to match your organization’s existing membership program, and it implements a shortcode that creates a donation form with either buttons or drop-down styled membership level selections. The shortcode can be used multiple times on a single page.

The plugin was developed thanks to an investment from Knight Foundation as part of the national News Match campaign.

Settings

The plugin’s settings can be found in the WordPress Dashboard. In the left sidebar, look for Settings > News Match Shortcode.

These settings allow you to configure:
– your organization’s name
– whether to accept donations through NewsMatch.org or FundJournalism.org
– your organization’s News Match ID with that provider
– the default donation amount
– the live and testing donation form URLs
– which donation form to use
– the Salesforce campaign ID associated with this form

The settings page also allows you to configure up to four donation levels with minimum and maximum donation amounts and custom names for the tiers. Configure the donation levels to match your organization’s existing membership programs.

Donation Shortcode Examples

Donations can occur once or reoccur on a monthly or yearly basis. (“One Time”, “Per Month” or “Per Year”.) The donation shortcode comes in two forms: one with buttons and one with a drop-down to choose the donation frequency. The default shortcode uses buttons:

Add donation form with no Salesforce campaign id and no default donation amount specified:

[newsmatch_donation_form]

Add donation form with no Salesforce campaign id and $50.00 as the default donation amount:

[newsmatch_donation_form amount=”50″]

Add a donation form with a Salesforce campaign id of foo and $25.00 as the default donation amount:

[newsmatch_donation_form sf_campaign_id=”foo” amount=”25″]

Add a donation form with a Salesforce campaign id of foo and do not specify a default donation amount:

[newsmatch_donation_form sf_campaign_id=”foo”]

You may wish to use a drop-down instead of buttons; to do that add type="select" to the shortcode:

[newsmatch_donation_form type="select"]

[newsmatch_donation_form amount="50" type="select"]

[newsmatch_donation_form sf_campaign_id="foo" amount="25" type="select"]

[newsmatch_donation_form sf_campaign_id="foo" type="select"]

If you have set the plugin to use NewsMatch.org to handle donations instead of FundJournalism.org, the donation frequency options will not be available to readers, as News Match only allows one-time donations.