fuhrmanator / course-activity-planner

Tool for instructors to plan course activities and synchronize the data with syllabus, LMS, etc.
GNU General Public License v3.0
30 stars 262 forks source link

This project is affiliated with the Maison du logiciel libre (ML2) at ETS.

Table of Contents generated with DocToc

course-activity-planner

Build status Coverage Status

Tool for instructors to plan course activities and synchronize the data with syllabus, LMS, etc.

Moodle courses can be cloned and updated with new activity dates from a calendar. Why?

How to use

General principle

Moodle activities can be planned relative to Seminars, Practica and Laboratories. Each activity adapts its start and end dates with the calendar of specific dates.

<activity to plan> <start at activity> <end at activity>

Ex: Quiz 1 is opened on Seminar 1 and closed right before Practicum 2 would be possible with this line: Q1 S1 P2

Generic activites which are not linked to Moodle content can also be created.

By default, Quizzes and Exams can be planned without any Moodle file.

Start/End of activities

Adding F to an activity will read the finishing time of the activity. Adding nothing or S will read the start time.

Ex: Quiz 1 is opened right after Seminar 1 and closed right after Practicum 1 would be Q1 S1F P1F

Relative date or time modifiers

Amounts of time can be subtracted or added to activities.

Supports + or - combined with

Ex: 1 hour after Seminar 1 would be S1+1h.

Ex: 15 minutes before Practicum 2 would be P2-15m.

Ex: Quiz 1 is opened 1 hour after Seminar 1 and closed 15 minutes before Practicum 2 would be Q1 S1+1h P2-15m

Absolute time modifier

The exact hours can be set to an activity.

Ex: the day of Seminar 1 at 23:55 would be S1@23:55.

This can be used along with relative date or time modifiers.

Ex: the day before Seminar 1 at 23:55 would be S1-1d@23:55.

Please Note when used with a relative modifier, the time modifier must be last.

S1-1d@23:55 is valid

S1@23:55-1d is invalid

Defining new activities

Activities can be configured by the administrator. Please refer to examples in python/config/activities.

Development setup

Run unit tests

Run the linter

pep8 && flake8

Production setup

Please see deploy/README.md

Screen shots