Fundraising Plugin

Show a fundraising message with a progress bar

Introduction

This plugin defines %FUNDRAISINGMESSAGE%, using a few variables defined on FundraisingPlugin; this can be used as %BROADCASTMESSAGE% on Main.TWikiPreferences.

Example

Behavior

%FUNDRAISINGMESSAGE% is not defined when one of the following conditions is verified:

• %ENDDATE% is in the past;
• %GOAL% has already been reached;
• the configuration variables (defined below) values are not consistent.

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %FUNDRAISINGPLUGIN_SHORTDESCRIPTION%

• One line description, is shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Show a fundraising message with a progress bar

• Debug plugin: (See output in data/debug.txt)
  • Set DEBUG = 0

• End date of the fundraising:
  • Set ENDDATE = 2012-10-28

• Total amount to raise:
  • Set GOAL = 1000

• Amount already pledged:
  • Set PLEDGED = 200

• Message to display before the progress bar
  • Set PREMSG = TWiki needs money:
  • #Set PREMSG = TWiki a besoin d'argent:

• How to display the already pledged amount
  • Set PLEDGEDMSG = $%FUNDRAISINGPLUGIN_PLEDGED%
  • #Set PLEDGEDMSG = %FUNDRAISINGPLUGIN_PLEDGED% â�¬

• How to display the amount to raise in the progress bar (TOGO will be replaced by the missing amount)
  • Set TOGOMSG = $TOGO to go
  • #Set TOGOMSG = manque TOGO â�¬

• Message to display after the progress bar
  • Set POSTMSG = before %FUNDRAISINGPLUGIN_ENDDATE%; visit http://this-ngo.org/
  • #Set POSTMSG = avant le %FUNDRAISINGPLUGIN_ENDDATE% : http://this-ngo.org/

Plugin Installation Instructions

• Download the ZIP file from the Plugin web (see below)
• Unzip FundraisingPlugin.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/FundraisingPlugin.txt	Plugin topic
  lib/TWiki/Plugins/FundraisingPlugin.pm	Plugin Perl module

• Edit FundraisingPlugin to suit your needs.
• Write-protect FundraisingPlugin against modifications (with bullet * Set ALLOWTOPICCHANGE = Main.TWikiAdminGroup).
  • #Set ALLOWTOPICCHANGE = TWikiAdminGroup
• To enable it on all pages, set %BROADCASTMESSAGE% to %FUNDRAISINGMESSAGE% in Main.TWikiPreferences topic.

Plugin Info

Related Topics: TWikiPreferences, TWikiPlugins