1# �� DokuWiki Calendar Plugin v3.3 - Quick Reference
2
3**A sleek, modern calendar system with multi-namespace support, recurring events, and smart filtering.**
4
5---
6
7## �� Widgets
8
9### **{{calendar}}** - Full Interactive Calendar
10**The main calendar with month grid + event panel**
11
12### **{{eventpanel}}** - Event Panel Only
13**Just the scrolling event list, no calendar grid**
14
15### **{{eventlist}}** - Simple Event List
16**Lightweight 2-line display widget**
17
18---
19
20## ⚙️ Parameters
21
22### **namespace**
23- `namespace=work` - Single namespace
24- `namespace=work;personal` - Multiple namespaces (semicolon-separated)
25- `namespace=*` - All namespaces (wildcard)
26- `namespace=projects:*` - Wildcard within namespace
27
28### **range** *(eventlist only)*
29- `range=day` - Today only
30- `range=week` - Next 7 days
31- `range=month` - Current month
32
33### **daterange** *(eventlist only)*
34- `daterange=2026-01-01:2026-01-31` - Custom date range
35
36### **date** *(eventlist only)*
37- `date=2026-01-25` - Specific single date
38
39### **height** *(eventpanel only)*
40- `height=400px` - Custom panel height
41
42### **sidebar** *(eventlist only)*
43- Shows today through +1 month
44- Hides completed tasks
45- Highlights today/tomorrow
46
47### **today** *(eventlist only)*
48- Shows today's events only
49- Same as `range=day`
50
51---
52
53## �� Event Features
54
55### **Multi-day Events**
56- Spans across months automatically
57- Displays as continuous bar on calendar
58- Shows original start date in all months
59
60### **Recurring Events**
61- Daily, Weekly, Monthly options
62- End date optional
63- Generates all occurrences on save
64
65### **Tasks (Checkboxes)**
66- Toggle completion status
67- Auto-filtered in sidebar/day/week modes
68- Persistent state
69
70### **Time Picker**
71- 15-minute intervals
72- 12-hour format display
73- 24-hour storage
74
75### **Colors**
76- Blue, Green, Red, Orange, Purple, Pink, Teal
77
78---
79
80## �� Smart Features
81
82### **Namespace Filtering**
83- Click any namespace badge to filter
84- Badge appears in event panel header with ✕
85- New events auto-save to filtered namespace
86- Click ✕ or badge again to clear
87
88### **Date Defaults**
89- Start date: 1st of displayed month
90- End date picker: Opens on displayed month
91- Time: 15-min increments (00, 15, 30, 45)
92
93### **Auto-Highlighting**
94- **TODAY badge** - Purple, shown on current events
95- **Tomorrow** - Light yellow/green tint
96- **Past events** - Collapsed, click to expand
97
98### **Multi-Month Spanning**
99- Events stored in each month they appear
100- Proper date display across boundaries
101- Single delete removes from all months
102
103---
104
105## �� Quick Syntax
106
107```dokuwiki
108{{calendar}}
109{{calendar namespace=work}}
110{{calendar namespace=*}}
111{{calendar namespace=projects:website;work}}
112
113{{eventpanel height=500px}}
114{{eventpanel namespace=personal}}
115
116{{eventlist}}
117{{eventlist range=day}}
118{{eventlist range=week}}
119{{eventlist range=month}}
120{{eventlist range=week namespace=work}}
121{{eventlist sidebar}}
122{{eventlist today}}
123{{eventlist date=2026-02-15}}
124{{eventlist daterange=2026-02-01:2026-02-28}}
125```
126
127---
128
129## �� Data Storage
130
131**Location:** `/data/meta/[namespace]/calendar/YYYY-MM.json`
132
133**Structure:**
134```json
135{
136  "2026-01-25": [
137    {
138      "id": "abc123",
139      "title": "Meeting",
140      "time": "14:00",
141      "endDate": "2026-01-26",
142      "namespace": "work",
143      "color": "#3498db",
144      "isTask": false,
145      "completed": false,
146      "description": "**Bold** and //italic// supported"
147    }
148  ]
149}
150```
151
152---
153
154## �� UI Colors
155
156- **Primary:** Green (#008800)
157- **TODAY badge:** Purple (#c084fc)
158- **Tomorrow:** Light yellow (#fffbeb)
159- **Past events:** Muted gray
160- **Namespace badges:** Green background, white text
161
162---
163
164## �� Debug Tools
165
166**JSON Corruption Fixer:**
167```bash
168php fix_corrupted_json.php /path/to/dokuwiki
169```
170
171**Clear Cache:**
172```bash
173rm -rf /var/www/html/dokuwiki/data/cache/*
174```
175
176---
177
178## ✨ Pro Tips
179
1801. Use `namespace=*` for dashboard view, then filter by clicking badges
1812. `range=day` perfect for sidebar widgets
1823. `range=week` great for weekly planning pages
1834. Multi-day events: Just set end date, it handles the rest
1845. Recurring events: Set end date or leave blank for infinite
1856. DokuWiki formatting works in descriptions: **bold**, //italic//, [[links]]
186
187---
188
189**Version:** 3.3
190**Author:** Built with Claude
191**License:** Keep it free, keep it open ��
192
193�� **Happy Scheduling!** ��
194