137 lines
5.0 KiB
Markdown
137 lines
5.0 KiB
Markdown
# Learning management system using django web framework
|
|
|
|
## Hosted at [adilmohak1.pythonanywhere.com](https://adilmohak1.pythonanywhere.com/)
|
|
|
|
### Access credentials:
|
|
- username: **admin**
|
|
- password: **securetest@123**
|
|
|
|
## Click here [if you need updates or additional features](https://adilmohak.github.io/dj-lms-starter/)
|
|
|
|
Feature-rich learning management system. You may want to build a learning management system(AKA school management system) for a school organization or just for the sake of learning the tech stack and building your portfolio, either way, this project would be a good kickstart for you.
|
|
|
|
Let's enhance the project by contributing! 👩💻👩💻
|
|
|
|
|
|
|
|
## Current features
|
|
|
|
- Dashboard: School demographics and analytics. Restricted to only admins
|
|
- News And Events: All users can access this page
|
|
- Admin manages students(Add, Update, Delete)
|
|
- Admin manages lecturers(Add, Update, Delete)
|
|
- Students can Add and Drop courses
|
|
- Lecturers submit students' scores: _Attendance, Mid exam, Final exam, assignment_
|
|
- The system calculates students' _Total, average, point, and grades automatically_
|
|
- Grade comment for each student with a **pass**, **fail**, or **pass with a warning**
|
|
- Assessment result page for students
|
|
- Grade result page for students
|
|
- Session/year and semester management
|
|
- Assessments and grades will be grouped by semester
|
|
- Upload video and documentation for each course
|
|
- PDF generator for students' registration slip and grade result
|
|
- Page access restriction
|
|
- Storing of quiz results under each user
|
|
- Question order randomization
|
|
- Previous quiz scores can be viewed on the category page
|
|
- Correct answers can be shown after each question or all at once at the end
|
|
- Logged-in users can return to an incomplete quiz to finish it and non-logged-in users can complete a quiz if their session persists
|
|
- The quiz can be limited to one attempt per user
|
|
- Questions can be given a category
|
|
- Success rate for each category can be monitored on a progress page
|
|
- Explanation for each question result can be given
|
|
- Pass marks can be set
|
|
- Multiple choice question type
|
|
- True/False question type
|
|
- Essay question type
|
|
- Custom message displayed for those that pass or fail a quiz
|
|
- Custom permission (view_sittings) added, allowing users with that permission to view quiz results from users
|
|
- A marking page which lists completed quizzes, can be filtered by quiz or user, and is used to mark essay questions
|
|
|
|
# Quick note for future contributors
|
|
|
|
If you would like to contribute, simply begin by implementing one from the list in the `TODO.md` file.
|
|
|
|
# Requirements:
|
|
|
|
> The following programs are required to run the project
|
|
|
|
- [Python3.8+](https://www.python.org/downloads/)
|
|
- [Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/)
|
|
|
|
# Installation
|
|
|
|
- Clone the repo with
|
|
|
|
```bash
|
|
git clone https://github.com/adilmohak/django-lms.git
|
|
```
|
|
|
|
- Create and activate a python virtual environment
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
- Create `.env` file inside the root directory
|
|
|
|
- Copy and paste everything in the `.env.example` file into the `.env` file. Don't forget to customize the variable values
|
|
|
|
```bash
|
|
python manage.py migrate
|
|
```
|
|
|
|
```bash
|
|
python manage.py createsuperuser
|
|
```
|
|
|
|
```bash
|
|
python manage.py runserver
|
|
```
|
|
|
|
Make sure your Redis server is running
|
|
|
|
```bash
|
|
redis-server
|
|
```
|
|
|
|
Start the celery worker
|
|
|
|
```bash
|
|
celery -A config.celery worker -l INFO
|
|
```
|
|
|
|
Last but not least, go to this address http://127.0.0.1:8000
|
|
|
|
# References
|
|
|
|
- Quiz part: https://github.com/tomwalker/django_quiz
|
|
|
|
# Professional help
|
|
|
|
[](https://adilmohak.github.io/dj-lms-starter/)
|
|
<br>
|
|
|
|
# Connect with me
|
|
|
|
<div>
|
|
<a href="https://www.linkedin.com/in/adilmohak" target="_blank">
|
|
<img src=https://img.shields.io/badge/linkedin-%231E77B5.svg?&style=for-the-badge&logo=linkedin&logoColor=white alt=linkedin style="margin-bottom: 5px;" />
|
|
</a>
|
|
<a href="https://github.com/adilmohak" target="_blank">
|
|
<img src=https://img.shields.io/badge/github-%2324292e.svg?&style=for-the-badge&logo=github&logoColor=white alt=github style="margin-bottom: 5px;" />
|
|
</a>
|
|
<a href="https://stackoverflow.com/users/12872688/adil-mohak" target="_blank">
|
|
<img src=https://img.shields.io/badge/stackoverflow-%23F28032.svg?&style=for-the-badge&logo=stackoverflow&logoColor=white alt=stackoverflow style="margin-bottom: 5px;" />
|
|
</a>
|
|
<a href="https://www.facebook.com/adilmohak1" target="_blank">
|
|
<img src=https://img.shields.io/badge/facebook-%232E87FB.svg?&style=for-the-badge&logo=facebook&logoColor=white alt=facebook style="margin-bottom: 5px;" />
|
|
</a>
|
|
</div>
|
|
|
|
### Help me improve the project and upgrade my trusty old laptop
|
|
|
|
<p><a href="https://www.buymeacoffee.com/adilmohak"> <img align="left" src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" height="36" width="160" alt="adilmohak" /></a></p><br><br>
|
|
|
|
#### Show your support by ⭐️ this project!
|