| | 1 | == Accepting donations through !PayPal == |
| | 2 | |
| | 3 | BOINC offers a donation system based on [http://www.paypal.com PayPal]. It is disabled by default; to enable it, add the following code to your `project/project.inc` file: |
| | 4 | |
| | 5 | define("PAYPAL_ADDRESS", "paypal@example.com");[[BR]] |
| | 6 | define("DONATION_CURRENCY", "EUR"); |
| | 7 | |
| | 8 | '''PAYPAL_ADDRESS''':: |
| | 9 | Email address, associated with !PayPal account that will receive money |
| | 10 | '''DONATION_CURRENCY''':: |
| | 11 | Currency in which donations are accepted. Can be one of the following values: EUR, CAD, GBP, USD, JPY, AUD, NZD, CHF, HKD, SGD, SEK, DKK, PLN, NOK, HOF, CZK. |
| | 12 | |
| | 13 | The project can display donation targets by adding data into ''donation_items'' database table. This allows donators to choose specific donation target when donating, and will also show current donation progress using progress bars. |
| | 14 | |
| | 15 | To automatically update progress bars and transaction table (''donation_paypal''), Instant Payment Notification (IPN) has to be enabled in !PayPal account. To activate Instant Payment Notification, you will need to enter the URL to your Profile to which automatic notification requests will be send. In order to use the script provided by BOINC, the URL has to be set to BASE_URL/donation_ipn.php, where BASE_URL is project's HTML dir. |
| | 16 | |
| | 17 | It should be clearly stated where donation money is going to be used; therefore, a function named `donations_intro()` should be defined in `project/project.inc` file. It should use PHP ''echo()'' command to display generic information about donations. |
| | 18 | |
| | 19 | Once the donation system has been enabled, a link to BASE_URL/donations.php should be added to project front page. |
