- Python 3.8 to 3.12
- Django 4.2, or 5.0
Additionally, if you are planning on developing, and/or building the JS bundles yourself:
- Node (only LTS versions are officially supported, currently 16 and 18)
yarn(npm i -g yarn)pre-commit(pip install pre-commit)
If you need to isolate your development environment, some combination of direnv, pyenv, nvm, and/or asdf will be
very helpful.
This app shouldn't require any special treatment to deploy, though depending on which feature set you are using, extra steps will be required. You should be able to install it with pip, either from GitHub, or locally. e.g.
pip install git+https://github.com/GamesDoneQuick/donation-tracker.git@master
Or after downloading or checking out locally:
pip install ./donation-tracker
For further reading on what else your server needs to look like:
- Deploying Django
- Deploying Django Channels
- Configuring Post Office (needed to send emails)
- Using Celery with Django (optional)
- Daemonizing Celery (optional)
Docker should also work but support is still in the experimental phases.
The Donation Tracker adds a few configuration options.
Type: bool
Default: False
Controls whether or not to try and use Celery. Certain tasks will be queued up as asynchronous if this setting is turned on, but it requires extra setup and for smaller events the performance impact is pretty minor.
Type: str
Default: ''
Used for the cache_giantbomb_info management command. See that command for further details.
Type: str
Default: ''
If present, shown on the Donation page. You should probably have one of these, but this README is not legal advice.
Type: str
Default: ''
If present, shown in several prize-related pages. This is REQUIRED if you offer any prizes from your events, and will disable a lot of prize functionality if it's not set. This is for legal reasons because it's very easy to run afoul of local sweepstakes laws. This README is not legal advice, however, so you should contact a lawyer before you give away prizes.
Type: int
Default: 500
Allows you to override the number of results a user can fetch from the API at a single time, or will be returned by
default. Attempting to set a limit= param in a search higher than this value will return an error instead.
Type: str
Default: ''
Allows you to place a logo asset in the navbar for public facing pages.
Type: bool
Default: settings.DEBUG
Allows you to enable or disable the DRF browsable API renderer on the v2 endpoints. By default, it's disabled in production mode and enabled in development.
This can potentially override DRF's own explicit or default settings, but only in that it will remove the renderer in question if it's in the list.
- PayPal currently requires the receiver account to have IPNs turned on so that payment can be confirmed
- The sandbox sends IPNs, so you should not need to use the IPN simulator unless you really want to
- There is a Diagnostics page on the admin, accessible if you are a Django superuser, it will let you test or monitor various pieces of Tracker functionality, which can give you early hints that something isn't working right
Clone the Git repo and install it in edit mode:
git clone [email protected]:GamesDoneQuick/donation-trackerpip install -e donation-tracker
Start up a new Django Project like the Django Tutorial.
pip install django~=5.0(if you need a specific version of Django)django-admin startproject tracker_development
Install remaining development dependencies:
cd donation-trackeryarnpre-commit installpre-commit install --hook-type pre-push
Add the following apps to the INSTALLED_APPS section of tracker_development/settings.py:
'channels',
'post_office',
'paypal.standard.ipn',
'tracker',
'rest_framework',
'timezone_field',
'ajax_select',
'mptt',
To enable analytics tracking, add the following to the MIDDLEWARE section of tracker_development/settings.py:
'tracker.analytics.middleware.AnalyticsMiddleware',
NOTE: The analytics middleware is only a client, and does not track any information locally. Instead, it expects an analytics server to be running and will simply send out HTTP requests to it when enabled. More information is available in tracker/analytics/README.md.
Add the following chunk somewhere in settings.py:
from tracker import ajax_lookup_channels
AJAX_LOOKUP_CHANNELS = ajax_lookup_channels.AJAX_LOOKUP_CHANNELS
ASGI_APPLICATION = 'tracker_development.routing.application'
CHANNEL_LAYERS = {'default': {'BACKEND': 'channels.layers.InMemoryChannelLayer'}}
# Only required if analytics tracking is enabled
TRACKER_ANALYTICS_INGEST_HOST = 'http://localhost:5000'
TRACKER_ANALYTICS_NO_EMIT = False
TRACKER_ANALYTICS_TEST_MODE = False
TRACKER_ANALYTICS_ACCESS_KEY = 'someanalyticsaccesskey or None'Create a file next called routing.py next to settings.py and put the following in it:
from channels.auth import AuthMiddlewareStack
from channels.routing import ProtocolTypeRouter, URLRouter
from channels.security.websocket import AllowedHostsOriginValidator
from django.urls import path
import tracker.routing
application = ProtocolTypeRouter({
'websocket': AllowedHostsOriginValidator(
AuthMiddlewareStack(
URLRouter(
[path('tracker/', URLRouter(tracker.routing.websocket_urlpatterns))]
)
)
),
})Edit the tracker_development/urls.py file to look something like this:
from django.contrib import admin
from django.urls import path, include
import tracker.urls
import ajax_select.urls
urlpatterns = [
path('admin/lookups/', include(ajax_select.urls)),
path('admin/', admin.site.urls),
path('tracker/', include(tracker.urls, namespace='tracker')),
]In the main project folder:
python manage.py runserver
In a separate shell, in the donation-tracker folder:
yarn start
If everything boots up correctly, you should be able to visit the Index Page. Additionally, you should be able to open the Websocket Test Page and see the heartbeat. If the page loads but the pings don't work, Channels isn't set up correctly. The Channels Documentation may be helpful.
This project uses pre-commit to run linters and other checks before every commit.
If you followed the instructions above, pre-commit should run the appropriate hooks every time you commit or push.
Note: You can bypass these checks by adding --no-verify when you commit or push, though this is highly
discouraged in most cases. CI runs the same checks as the hooks do, and will cause pipeline to fail if you bypass
a genuine failure.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent