Django Donations
Reusable django app to receive & track donations on charitable sites
Documentation
The full documentation is at https://django-donations.readthedocs.io.
Quickstart
Install Django Donations:
pip install django-donations
Add it to your INSTALLED_APPS:
INSTALLED_APPS = (
...
'donations.apps.DonationsConfig',
...
)Add Django Donations's URL patterns:
from donations import urls as donations_urls
urlpatterns = [
...
url(r'^', include(donations_urls)),
...
]Just Giving Configuration
The app needs to be configured with your JustGiving API settings:
# Ability to point to Production or Sandbox URLs
JUST_GIVING_WEB_URL = 'http://v3-sandbox.justgiving.com'
JUST_GIVING_API_URL = 'http://api-sandbox.justgiving.com'
# Replace below with your personal details
JUST_GIVING_CHARITY_ID = '123456'
JUST_GIVING_APP_ID = 'changeme'
# Add a list of all the currencies you need to support
CURRENCIES = ['GBP']TODO
- Update the documentation and readme
- integrate with readthedocs or pythonhosted or both!
- tests - unit/integration
- task to periodically verify pending donations
(* dashboard - track/view donations from the business side - kpis etc * views/urls? - provide an api hook into the system (/donations - dashboard))
v2 and beyond
- (other providers (paypal etc))
- tasks.py - recurring donation handling - this is not possible right now as SDI is not an API to be automated
Supported Providers
- Just Giving SDI
Credits
Tools used in rendering this package:
