Plugin Homework - HeikoGr/MMM-Webuntis GitHub Wiki
Homework Plugin
The homework plugin shows homework entries with due date, subject, and description text.
Screenshot

Enable The Plugin
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.
All Configuration Options
| 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 |
Notes On Behavior
- 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.
Typical Config
plugins: {
homework: {
enabled: true,
config: {
nextDays: 14,
pastDays: 2,
dateFormat: 'EEE dd.MM.',
showSubject: true,
showText: false,
},
},
}