improve: email config UI add field descriptions and default placeholders
linuztx committed
Mar 17, 2026 at 00:05 UTC
ca97b3f72e77da2150ad488c445c3c89fd6fc439
1 file changed
+12
-3
plugins/_email_integration/webui/config.html
+12
-3
@@ -91,6 +91,7 @@
91
<div class="field">
92
<div class="field-label">
93
<div class="field-title">Handler Name</div>
94
+ <div class="field-description">Unique identifier for this email handler</div>
95
</div>
96
<div class="field-control">
97
<input type="text" x-model="handler.name" placeholder="e.g. support" />
@@ -100,6 +101,7 @@
101
<div class="field">
102
<div class="field-label">
103
<div class="field-title">Account Type</div>
104
+ <div class="field-description">IMAP for most providers, Exchange for Microsoft Exchange/Office 365</div>
105
</div>
106
<div class="field-control">
107
<select x-model="handler.account_type">
@@ -112,6 +114,7 @@
114
<div class="field">
115
<div class="field-label">
116
<div class="field-title">IMAP Server</div>
117
+ <div class="field-description">Incoming mail server hostname</div>
118
</div>
119
<div class="field-control">
120
<input type="text" x-model="handler.imap_server" placeholder="imap.gmail.com" />
@@ -121,15 +124,17 @@
124
<div class="field">
125
<div class="field-label">
126
<div class="field-title">IMAP Port</div>
127
+ <div class="field-description">SSL port for incoming mail, usually 993</div>
128
</div>
129
<div class="field-control">
126
- <input type="number" x-model.number="handler.imap_port" />
130
+ <input type="number" x-model.number="handler.imap_port" placeholder="993" />
131
</div>
132
</div>
133
134
<div class="field">
135
<div class="field-label">
136
<div class="field-title">SMTP Server</div>
137
+ <div class="field-description">Outgoing mail server hostname. Defaults to IMAP server if empty</div>
138
</div>
139
<div class="field-control">
140
<input type="text" x-model="handler.smtp_server" placeholder="smtp.gmail.com" />
@@ -139,15 +144,17 @@
144
<div class="field">
145
<div class="field-label">
146
<div class="field-title">SMTP Port</div>
147
+ <div class="field-description">TLS port for outgoing mail, usually 587</div>
148
</div>
149
<div class="field-control">
144
- <input type="number" x-model.number="handler.smtp_port" />
150
+ <input type="number" x-model.number="handler.smtp_port" placeholder="587" />
151
</div>
152
</div>
153
154
<div class="field">
155
<div class="field-label">
156
<div class="field-title">Username</div>
157
+ <div class="field-description">Email account login, usually the full email address</div>
158
</div>
159
<div class="field-control">
160
<input type="text" x-model="handler.username" placeholder="user@domain.com" />
@@ -157,6 +164,7 @@
164
<div class="field">
165
<div class="field-label">
166
<div class="field-title">Password</div>
167
+ <div class="field-description">Account password or app-specific password</div>
168
</div>
169
<div class="field-control">
170
<input type="password" x-model="handler.password" />
@@ -166,6 +174,7 @@
174
<div class="field">
175
<div class="field-label">
176
<div class="field-title">Poll Mode</div>
177
+ <div class="field-description">How to schedule inbox checks</div>
178
</div>
179
<div class="field-control">
180
<select x-model="handler.poll_mode">
@@ -198,7 +207,7 @@
207
<div class="field">
208
<div class="field-label">
209
<div class="field-title">Process Unread (days)</div>
201
- <div class="field-description">On first run, process unread emails from the last N days. 0 = skip existing emails.</div>
210
+ <div class="field-description">Process unread emails from the last N days on every startup. 0 = only track new emails</div>
211
</div>
212
<div class="field-control">
213
<input type="number" x-model.number="handler.process_unread_days" min="0" placeholder="0" />