Reusable django app to receive & track donations on charitable sites
Project description
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:
History
Unreleased
0.5.0 (2017-27-01)
Migrate to Django’s DurationField (#8). You need to upgrade your DONATION_FREQUENCIES setting. Values should now be python timedelta.
0.4.0 (2017-27-01)
Fix bug with urllib import on Python 3 #4
Remove dependency on django-autoconfig
Regenerate with cookie cutter for Django standalone app, resulting in: * Cleanup a few unused files * Remove the example project which isn’t kept up to date * Add a changelog * Switch testing to use tox * Switch from coveralls to codecov.io
Test views
0.3.0 (2016-10-20)
Drop support for Django 1.6 and 1.7
Support Django 1.9
Prepare Django 1.10
0.2.7 (2015-12-17)
Add the app config for Django 1.7+
0.2.6 (2015-12-07)
Some Python 3 compatibilty fixes
Prepare for Django 1.9 compatibility
0.2.5 (2015-11-23)
Django 1.8 compatibility
Fix a few issues with Python 3
0.2.4 (2015-11-12)
Doc improvements
Django 1.7 compatibility
0.2.3 (2015-10-23)
Fix a crash with anonymous donor
0.2.2 (2015-10-22)
Mostly tests improvements
0.2.0 (2015-10-19)
Fix various unicode crashes
Fix that prevented the server from starting when config was being loaded before the tables were created.
Capture Donor name from JustGiving
0.1.3 (2016-10-16)
Fix a Unicode crash in models and providers
Revert erroneous change in setup.py
0.1.2 (2015-10-16)
Admin improvements
Installation fixes
0.1.1 (2015-10-13)
Fix packaging on PyPI
Docs improvements
0.0.2 (2015-10-12)
Squash South migrations
Autoconfig enhancements
0.0.1 (2015-10-12)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_donations-0.5.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 790d0170f7fab0fb231ee936e2c9ffe3e1aab9314fdc4b266007c6d5d43e0778 |
|
MD5 | c96701dc85610787d453e97082ebce99 |
|
BLAKE2b-256 | d09f17a09189a3af111aa97ab7c6a1815fc7de4e85921f20fee0e59f9061f642 |