Django integration for Web Monetization
Project description
Django Web Monetization
A Django package that makes it easy to integrate the Web Monetization specification into web applications. It enables developers to monetize their websites through real-time payments using the Interledger Protocol (ILP).
Features
- 🚀 Middleware to automatically add the payment pointer to HTTP headers
- 🎯 Template tag to insert the monetization meta tag in templates
- ⚙️ Simple configuration through settings.py
- 🔒 Compatible with Django 3.2+
- 📦 Easy installation with pip
Resources
Installation
pip install django-webmonetization
Configuration
- Add 'django_webmonetization' to INSTALLED_APPS in settings.py:
INSTALLED_APPS = [
...
'django_webmonetization',
]
- Configure your payment pointer in settings.py:
WEBMONETIZATION_PAYMENT_POINTER = '$ilp.example.com/your-payment-pointer'
- (Optional) Add the middleware to MIDDLEWARE in settings.py:
MIDDLEWARE = [
...
'django_webmonetization.middleware.WebMonetizationMiddleware',
]
Usage
In Django Templates
{% load webmonetization %}
<!DOCTYPE html>
<html>
<head>
{% webmonetization_meta %}
<title>My Monetized Website</title>
</head>
<body>
<h1>Welcome to my website</h1>
<p>This site is monetized with Web Monetization</p>
</body>
</html>
HTTP Headers Verification
The middleware automatically adds the Web-Monetization-Pointer header to all HTTP responses. You can verify it with curl:
curl -I https://your-site.com
You should see something like:
HTTP/1.1 200 OK
...
Web-Monetization-Pointer: $ilp.example.com/your-payment-pointer
Integration Examples
1. Basic Monetization
# settings.py
WEBMONETIZATION_PAYMENT_POINTER = '$ilp.example.com/basic'
# views.py
from django.shortcuts import render
def home(request):
return render(request, 'home.html')
<!-- templates/home.html -->
{% load webmonetization %}
<!DOCTYPE html>
<html>
<head>
{% webmonetization_meta %}
</head>
<body>
<h1>Home Page</h1>
</body>
</html>
Requirements
Main Dependencies
- Python 3.7+
- Django 3.2+
Development Dependencies
- pytest>=7.0.0
- pytest-cov>=4.0.0
Contributing
Contributions are welcome! Please feel free to submit a pull request.
License
MIT License - see the LICENSE file for details.
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_webmonetization_martinm10-0.1.0.tar.gz.
File metadata
- Download URL: django_webmonetization_martinm10-0.1.0.tar.gz
- Upload date:
- Size: 8.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c66c7db7b31fea159e0f91645b64aefd812608c66dcca847830ad409cae578f7
|
|
| MD5 |
e74b68ca41baf9d0677e13f330bc5794
|
|
| BLAKE2b-256 |
5250ce0716090310520b16d50454dbc22f4594d58a89b6b5854eef9848e052f1
|
File details
Details for the file django_webmonetization_martinm10-0.1.0-py3-none-any.whl.
File metadata
- Download URL: django_webmonetization_martinm10-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f7da47abef35d5d83b90ed982489492bfc9308988474b94b3c29dab9e744be66
|
|
| MD5 |
4d3d290248d72d08eef75ab6acc1b66e
|
|
| BLAKE2b-256 |
83cbfa1e267f1a423e5e15d0ad83489dd2d304297575b5dd8057d8f024d0fe69
|
