reach-connector

Description

This plugin enables you to easily integrate your REACH℠ site with your WordPress site. Use short codes to embed all sponsorships or campaigns on pages or filter based on short code parameters.

Support

Please visit http://support.reachapp.co or email support@reachapp.co.

Usage

Sponsorship Shortcode Setup

To pull a list of sponsorships from REACH® to display on your site use the shortcode [sponsorships]. You can also pass optional parameters to filter your sponsorship results similar to the dropdown filters on the Sponsorships page using the parameters:
sponsorship_type
location
project
sponsorship_categories
status
Example: [sponsorships sponsorship_type=”children”]

Campaigns Shortcode Setup

To pull a list of campaigns from REACH® to display on your site use the shortcode [campaigns].
Campaign Page Shortcode Setup

To pull a specific campaign from REACH® to display on your site use the shortcode with the permalink shown in REACH® [campaign permalink=’my-campaign-permalink’].
Donation Shortcode Setup

To display a donation page from REACH® on your site use the shortcode [donations] on any page. You can also pass optional paramters defined in the Giving Options page in REACH to customize the donation form by setting amount, recurring period, purpose etc.
amount
fixed_amount (true/false)
recurring
fixed_recurring (true/false)
referral
Example: [donations amount=”50″]

Custom Form Shortcode Setup

To pull a specific custom form from REACH® to display on your site use the shortcode with the permalink shown in REACH® [custom_form permalink=’my-form-permalink’].
Projects Shortcode Setup

To pull a list of projects from REACH® to display on your site use the shortcode [projects].
Project Page Shortcode Setup

To pull a specific project from REACH® to display on your site use the shortcode with the permalink shown in REACH® [project permalink=’my-project-permalink’].
Places Shortcode Setup

To pull a list of places from REACH® to display on your site use the shortcode [places].
Place Page Shortcode Setup

To pull a specific place from REACH® to display on your site use the shortcode with the permalink shown in REACH® [place permalink=’my-place-permalink’].
Products Shortcode Setup

To pull a list of products from REACH® to display on your site use the shortcode [products].
Events Shortcode Setup

To pull a list of events from REACH® to display on your site use the shortcode [events].
Calendar Shortcode Setup

To display a calendar of events from REACH® on your site use the shortcode [calendar].
Event Page Shortcode Setup

To pull a specific event from REACH® to display on your site use the shortcode with the permalink shown in REACH® [event permalink=’my-place-permalink’].
Supporter Login Shortcode Setup

To display a login page for supporters from REACH® on your site use the shortcode [supporter_login].

Installation

Copy the “reach-connector” folder and all of it’s files in to your “wp-content/plugins” folder.

FAQ

Installation Instructions

Copy the “reach-connector” folder and all of it’s files in to your “wp-content/plugins” folder.

Does this plugin require a REACH account?

Yes, you can sign up for a REACH account at http://www.reachapp.co.

Contributors & Developers

“reach-connector” is open source software. The following people have contributed to this plugin.

Contributors

Translate “reach-connector” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1

  • This is the intial release to the public.

1.2

  • This release switches to a more user-friendly format which provides pagination and filtering for sponsorships and campaigns.

1.3

  • This release adds the new shortcode “donations” to display the general donation form on any page.

1.3.1

  • Added documentation to simplify the setup process.

1.4

  • This release adds optional parameters to customize the donations shortcode.

1.5

  • This release adds shortcodes for projects, places, and individual pages for projects, places, and campaigns.

1.6

  • Bug fix when accounts are using their own sub-domain on REACH.

1.7

  • Scroll to the top of the page when a user clicks a link in the content.

1.8

  • Bug fix when plugin content was being displayed above text on the page.

1.9

  • Update for displaying https assets for campaigns.

2.0

  • Display custom forms from REACH in your WordPress site.

2.1

  • Display events and products from REACH in your WordPress site.

2.2

  • Display supporter login page and embed menu from REACH in your WordPress site.

2.3

  • Test under WordPress 4.8.

2.4

  • Test under WordPress 4.8.2. Update https issue with campaigns.

2.5

  • Resolve javascript error when loading REACH connections.

2.6

  • Remove scroll to top behavior.

2.7

  • Add unique IDs for code inserted for individual projects, places, and campaigns.

2.8

  • Add configuration option to disable the jQuery auto-include when using the plugin short codes.

2.9

  • Update javascript files.

3.0

  • Force version update.