1=== EventList Range Parameter ===
2
3The {{eventlist}} widget now supports a simple "range" parameter!
4
5== Syntax ==
6
7{{eventlist range=day}}
8{{eventlist range=week}}
9{{eventlist range=month}}
10{{eventlist range=day namespace=personal}}
11{{eventlist range=week namespace=work}}
12
13== Options ==
14
15**range=day**
16  * Shows: Today's events only
17  * Header: "Today"
18  * Example: {{eventlist range=day}}
19
20**range=week**
21  * Shows: Next 7 days (today + 6 days)
22  * Header: "This Week"
23  * Example: {{eventlist range=week}}
24
25**range=month**
26  * Shows: Current month (1st to last day)
27  * Header: "February 2026" (current month name)
28  * Example: {{eventlist range=month}}
29
30== Combining with Namespace ==
31
32{{eventlist range=day namespace=work}}
33  → Today's work events
34
35{{eventlist range=week namespace=personal}}
36  → This week's personal events
37
38{{eventlist range=month namespace=*}}
39  → This month's events from all namespaces
40
41== Legacy Options (Still Work) ==
42
43**today** - Same as range=day
44{{eventlist today}}
45
46**sidebar** - Shows today through +1 month
47{{eventlist sidebar}}
48
49**date=YYYY-MM-DD** - Specific date
50{{eventlist date=2026-02-15}}
51
52**daterange=YYYY-MM-DD:YYYY-MM-DD** - Custom range
53{{eventlist daterange=2026-02-01:2026-02-28}}
54
55== Examples ==
56
57**Dashboard sidebar:**
58{{eventlist range=day namespace=*}}
59{{eventlist range=week namespace=work}}
60
61**Project page:**
62{{eventlist range=month namespace=projects:website}}
63
64**Quick view:**
65{{eventlist range=day}}  ← Today
66{{eventlist range=week}} ← This week
67{{eventlist range=month}} ← This month
68
69== Version ==
70Added in v3.2.7
71