Django Email Learning
A Django package for creating email-based learning platforms with IMAP integration and React frontend components.
Sponsorship
Support our open-source work and community projects by sponsoring us through GitHub Sponsors. Depending on your sponsorship tier, we can feature your logo and link on the project’s README and documentation.
What is django-email-learning?
django-email-learning is an open-source Django app, designed to provide a complete email-based learning platform. It is inspired by the Darsnameh email-learning service, which unfortunately shut down in July 2017. This library aims to revive that concept and make it accessible to anyone who wants to launch a similar service.
If you find this project useful, a ⭐ on GitHub helps others discover it.
Want to try it online first? Create a free account on InboxAcademy, our hosted platform built on top of django-email-learning.
Why an email learning platform?
An email learning platform is a type of e-learning system where course content is delivered directly to learners’ inboxes. Platform admins can create courses, lessons, and quizzes, and configure the timing rules that determine when each next lesson or quiz is sent.
The system exposes management commands and/or API endpoints that can be triggered by cron jobs or cloud schedulers to:
-
Track learner progress
-
Send lessons and quizzes via email
-
Handle automated transitions between course steps
Additionally, the platform can issue online completion certificates that learners can verify using a QR code.
Why use email for e-learning?
While modern e-learning platforms often rely heavily on video content and complex web interfaces, email remains a powerful and inclusive channel. Some of the reasons:
-
Low bandwidth requirement: Email works well in regions with slow or unstable internet.
-
High accessibility: No need to install apps or log into a portal—lessons arrive directly in the inbox.
-
Resilience to censorship: Emails are often less likely to be blocked than certain websites or platforms under restrictive governments.
-
Simplicity: Email is universal, familiar, and works on virtually any device.
Documentation
Comprehensive documentation is available at django-email-learning.readthedocs.io, including:
- Installation Guide: Step-by-step setup instructions
- Platform Management: Creating organizations, courses, and managing learners
- Technical Reference: Management commands and configuration
- Usage Examples: Real-world implementation scenarios
Installation
Quick Start
The fastest way to get a working development environment is the interactive setup command:
pip install django-email-learning
django-email-learning-init
This sets up a new Django project with django_email_learning pre-configured — virtual environment, secrets, migrations, and a superuser — in one go. See the Installation Guide for the full walkthrough.
Manual Installation
For existing Django projects, follow these steps.
1. Install the Package
pip install django-email-learning
2. Add to INSTALLED_APPS
Add django_email_learning to your INSTALLED_APPS in the Django settings file:
INSTALLED_APPS = [
...
'django_email_learning',
]
3. Configure Settings
Add the required configuration for the site base URL in your Django settings:
DJANGO_EMAIL_LEARNING = {
"SITE_BASE_URL": "<YOUR_SITE_BASE_URL_STARTING_WITH_HTTP>",
"ENCRYPTION_SECRET_KEY": "<LONG_RANDOM_STRING>",
"JWT_SECRET_KEY": "<LONG_RANDOM_STRING>",
}
ENCRYPTION_SECRET_KEY should be a long random string used to protect sensitive values such as stored API Keys.
4. Configure Media Files
This app uses Django's MEDIA files to save organization logos. Ensure your media settings are configured correctly. See the MEDIA_URL setting for details.
5. Run Migrations
python manage.py migrate
6. Add URLs
Include the app URLs in your main Django URLs configuration:
from django.urls import path, include
from django_email_learning import urls as email_learning_urls
urlpatterns = [
...
path('your_preferred_path/', include(email_learning_urls, namespace='django_email_learning')),
]
The platform will be accessible at your_preferred_path/platform/.
Access Control Notes
- Platform Access: You need to be logged in to access the
/platformsub-URL, which is used for managing courses and viewing learner progress.
Usage
Newsletters
django-email-learning includes a built-in newsletter system. Platform admins can create newsletters per organisation, grow a subscriber list, and schedule email campaigns (sendouts) that are delivered automatically. See the Newsletter documentation for the full configuration reference and usage guide.
Optional: auto-subscribe on course enrollment
Link a newsletter to a course in the platform UI (or via API). When a learner enrolls in that course they are automatically subscribed to the linked newsletter. Learners have the option to opt out by unchecking the subscription checkbox during enrollment.
Content Delivery
This app uses the email backend defined in Django settings to deliver course content. Assuming you have active courses and enrollments, you need to schedule a job that runs the content delivery management command periodically (e.g., using cron or a cloud scheduler).
Execute the content delivery job using:
python manage.py deliver_contents
You can also trigger this job via API, which is useful when running from an external scheduler (for example, cloud scheduler services):
GET /your_preferred_path/api/jobs/deliver_contents/
Authorization: Bearer <API_KEY>
This endpoint requires an API key. You can generate and manage API keys from Platform Settings > API Keys in the platform UI.
Contributing
We welcome contributions! Please read our Contributing Guide to learn about our development process, how to set up the development environment, and how to submit pull requests.
License
This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for django-email-learning 7.16.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django_email_learning-7.16.1.tar.gz | 1.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_email_learning-7.16.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.2 MB
Release files / django_email_learning-7.16.1.tar.gz
| Download URL | django_email_learning-7.16.1.tar.gz |
|---|---|
| Size | 1.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
208e208de2be59999f6e928cb0371ac7118135e72e1dc2d0ac9bdb8e4a6b4b7a
|
|
BLAKE2b-256 checksum How to use checksums |
b5695515590e04d3b2d0dd9de263248e948b651996113506935a640ef872f18f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.3 Linux/5.15.167.4-microsoft-standard-WSL2
|
Release files / django_email_learning-7.16.1-py3-none-any.whl
| Download URL | django_email_learning-7.16.1-py3-none-any.whl |
|---|---|
| Size | 1.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
72f91a061e44105bc61d2c5c54d7161952a49927470a90008e1a2cff95841c3b
|
|
BLAKE2b-256 checksum How to use checksums |
89a4ad012a9cb1f4e25d64c1383505403a12eacc100509604b136e68ad8e2a61
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.3 Linux/5.15.167.4-microsoft-standard-WSL2
|
