Donation Plugin

This plugin is designed to track donations and fundraising campaigns. This is intended as a proof-of-concept for testing plugin integration with the PayPal plugin.

Requirements

glFusion v1.1.6 or newer

Installation

This plugin uses the glFusion automated plugin installer. Simply upload the distribtuion using the glFusion plugin installer located in the Plugin Administration page.

The plugin may be installed manually, if necessary.

Upgrading

The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.

Features

Create fundraising campaigns and track donations to them. Each campaign may have a preset goal, and may be automatically disabled when that goal is reached.
Display one or more campaigns in blocks, along with “Donate” buttons for Paypal.

Administration

Configuration Options

Configuration Options are set by the Paypal section in the site Configuration area. There is no config.php required unless you wish to override any other settings.

Option	Description
Integrate with the Paypal plugin?	Select “Yes” if you have the Paypal Plugin installed and wish to accept donations via Paypal. This will cause the Donation plugin to present Paypal buttons for donations. If this is “No”, then no Paypal buttons will be shown.
Email Admin upon new donations?	Select whether you'd like the site administrator to receive an email whenever a donation is received.

Creating Campaigns

The fundraising campaign determines the nature of the donation button. Create a campaign by clicking “New Campaign” in the Donation administation screen.

Option	Description
Campaign Name	Enter a short but descriptive name for this campaign. The campaign's name will appear as it's title in the donation block, and on the email to the contributor if Paypal is used.
Starting Date Ending Date	Optional starting and ending date. Solitations will not be made for campaigns when the current date is not between these dates.
Description	Enter a description for this campaign
Goal	Enter the contribution goal for this campaign. If this is not empty (or zero), then a progress bar will be displayed in the donation block indicating the progress of this campaign.
Stop after goal is reached?	Select “Yes” to have this campaign removed from the donation block after contributions have met or exceeded this goal. If this is “No”, then contributions will be solicited indefinitely.
Enabled?	If this is unchecked, the campaign is not shown in the donation block.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Table of Contents