Repository navigation
Plugin Homework
github-actions[bot] edited this page Sep 24, 2026
·
3 revisions
The homework plugin shows homework entries with due date, subject, and description text.

Simple activation via displayMode:
displayMode: 'homework'Canonical activation via plugins.homework:
plugins: {
homework: {
enabled: true,
config: {
nextDays: 28,
},
},
}The old top-level namespace homework: { ... } is still accepted for compatibility, but plugins.homework.config is the canonical form.
| Option | Type / Values | Default | Effect |
|---|---|---|---|
nextDays |
number >= 0
|
28 |
Future homework window in days |
pastDays |
number >= 0
|
0 |
Keeps recent homework visible for that many days |
dateFormat |
string | EEE dd.MM. |
Date format for due dates |
showSubject |
boolean | true |
Shows the homework subject label |
showText |
boolean | true |
Shows the homework description text |
- Homework is sorted by due date and then by subject.
- If a student has no homework entries, the plugin renders a
no homeworkplaceholder row. -
showText: falseis useful when you only want a compact reminder list. -
excludeLessons(module or student level) also hides homework whose subject matches, see Hiding and Adding Lessons.
plugins: {
homework: {
enabled: true,
config: {
nextDays: 14,
pastDays: 2,
dateFormat: 'EEE dd.MM.',
showSubject: true,
showText: false,
},
},
}