PaypalDonationExtension

From PeacockWiki

LyricExtension is an extension for Mediawiki that provides features facilitating the notation of song lyrics in the wiki.

Contents 1 Details 1.1 Features 1.2 Design 1.2.1 Database 2 Usage 2.1 Example 3 Installation 4 Releases 4.1 Todo 4.2 RoadMap 4.2.1 0.2 No Date 4.3 History 4.3.1 0.1 9 April 2007 5 Source Code

Details

• Version 0.0
• Date 5 Apr 2007
• Tested on MediaWiki 1.7.1, PHP 5.1.6 (apache2handler), MySQL 5.0.24a-Debian_9ubuntu0.1-log

Features

• Allows users to complete a form allowing them to make a payment via PayPal.

Design

          +--------+
          | PayPal |
          +--------+
              |
+------+   +-----+    +=====+   +-----+   +=====+   +-----+
| Wiki |---| PPE |----= API =---| FRE |---= API =---| Ind |
+------+   +-----+    +=====+   +-----+   +=====+   +-----+
              |                    |
         +----------+         +----------+
         | Database |         | Database |
         +----------+         +----------+

• PPE Paypal Donation Extension
  • Facilitates paypal donations, and recording of transactions
  • Provides an API to allow access to donation info
• FRE Financial Reports Extension
  • Allows treasurer to enter financial details
  • Retrieves data from donations and provides (monthly) reports on financial status
  • Provides an API to allow information to be used for status indicators, other reporting engnes etc.
• Ind Indicators/progress bars etc.

Database

New table: Donations

• item_number - Autonumber, used for item number for paypal
• UserID - lyricwiki user id
• RequestTime - time donation form submitted
• firstname
• lastname
• address1
• address2
• city
• state
• zip
• email
• amount - amount to donate
• comment - donor comment
• anonymous - anonymous donation?
• Validated - true after sucessfull ipn from paypal
• IPNResults - All data from paypal - Filled in after transaction
• payment_date - Date of transaction - Filled in after transaction
• payment_gross - Total money sent - Filled in after transaction
• payer_email - email of paypal user - Filled in after transaction
• mc_fee - transfer fee - Filled in after transaction
• mc_gross - total recieved - Filled in after transaction

Usage

Example

see Special:Donate

This demo uses the PayPal sandbox. To sucessfully test the product you must register with a paypal developer account, and create a sandbox Business account with the email address tp@pt.com, as well as a personal account for testing.

Installation

copy files into place

Insert the following line into the end of 'LocalSettings.php' (before the '?>')

require("extensions/???.php");

To check to see if it is installed properly, visit your Version page, eg Special:Version.

You should see the following items:

• Extensions:
  • Other:
    • Paypal Donation Extension (version 0.0.1), Adds a special page allowing users to donate money to the wiki., by Trevor Ian Peacock
  • Extension functions:
    • LyricExtension and paypalSetup

Releases

Todo

• Interface to allow hiding of ads
• Donations in other currencies

Full Todo

RoadMap

0.2 No Date

• Interface to allow hiding of ads
• Donations in other currencies

Full RoadMap

History

0.1 9 April 2007

• Ability to make donations
• Recording of donors details, and receipt
• API to allow other extensions

Full History

Source Code