v2.2.0: 3-Stufen-Sichtbarkeit, UX-Verbesserungen, Auto-Erkennung
- 3 Sichtbarkeitsstufen für Vorlagen: Persönlich / Abteilung / Alle
- Persönliche Vorlagen werden in _benutzer/{email}/ synchronisiert
- Sichtbarkeit direkt in der Liste per Dropdown änderbar
- Warnung beim Verringern der Sichtbarkeit (Server-Löschung)
- Auto-Erkennung von Abteilung + E-Mail via _config/abteilungen.json
- Toast-Benachrichtigungen statt unsichtbare Status-Badges
- Lade-Spinner bei Sync-Operationen
- Sync-Dots mit Symbolen (nicht nur Farbe) für Barrierefreiheit
- Custom Delete-Modal statt browser confirm()
- Collapsible-Sections visuell als klickbar erkennbar
- Token-Feld mit Show/Hide-Toggle
- Inline-Validierung für Template-Namen
- Checkbox-Klickflächen vergrößert + Label-Klick
- Offline-Erkennung mit Banner
- Font-Dropdown Viewport-Fix
- Popup: Prefix-Dropdown verständlicher
- Signaturen: erste Identität automatisch ausgewählt
- README komplett neu geschrieben
This commit is contained in:
Kendrick Bollens
130
README.md
130
README.md
@@ -1,38 +1,92 @@
|
||||
# Templates Reply
|
||||
## Mozilla Thunderbird Add-On
|
||||
|
||||
Templates Reply is a completely free and open-source Thunderbird extension that helps you create, manage, and reuse message templates directly from your compose window.
|
||||
It is designed for speed, simplicity, and convenience — no sign-ups, no limits, and absolutely no data collection.
|
||||
|
||||
This add-on does not track, store, or transmit any personal information.
|
||||
All templates and settings are saved locally on your device and never leave your computer.
|
||||
No analytics, telemetry, or remote servers are involved — your privacy is 100% respected.
|
||||
|
||||
You can freely use, modify, and distribute the source code under the terms of the MIT License.
|
||||
## Screenshots
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Install Locally (Temporary / Developer Mode)
|
||||
```
|
||||
Open Thunderbird
|
||||
Go to Tools → Add-ons and Themes
|
||||
Click the ⚙️ (gear icon) in the top-right corner
|
||||
Select “Debug Add-ons”
|
||||
Click “Load Temporary Add-on…”
|
||||
Choose the manifest.json file from your add-on directory
|
||||
|
||||
⚠️ Note: This installation is temporary and will be removed when Thunderbird is restarted.
|
||||
```
|
||||
|
||||
## OR via Thunderbird Add-on Manager
|
||||
```
|
||||
Open Thunderbird
|
||||
Go toTools → Add-ons and Themes
|
||||
Search for the Templates Reply add-on by name
|
||||
Click Add to Thunderbird
|
||||
Confirm installation
|
||||
```
|
||||
# HPS Vorlagen & Signaturen
|
||||
|
||||
Thunderbird-Plugin (v2.2.0) zur zentralen Verwaltung von E-Mail-Vorlagen und Signaturen für Hotel Park Soltau. Vorlagen und Signaturen werden über ein Gitea/Forgejo-Repository synchronisiert und stehen so allen Mitarbeitern zur Verfügung.
|
||||
|
||||
## Features
|
||||
|
||||
- **E-Mail-Vorlagen** erstellen, bearbeiten und per Klick in Compose-Fenster einfügen
|
||||
- **3 Sichtbarkeitsstufen** pro Vorlage:
|
||||
- **Persönlich** — nur für den eigenen Account, gesynct in `_benutzer/{email}/`
|
||||
- **Abteilung** — für alle in der Abteilung, gesynct in den Abteilungsordner
|
||||
- **Alle Abteilungen** — firmenweit, gesynct in `_gemeinsam/`
|
||||
- **Signaturen-Verwaltung** mit persönlichem Kopfbereich + gemeinsamer Fußzeile pro Abteilung
|
||||
- **Git-Sync** über Gitea/Forgejo API (Pull + Push, automatisch alle 15 Min.)
|
||||
- **Auto-Erkennung** von Abteilung und Benutzer via `_config/abteilungen.json`
|
||||
- **WYSIWYG-Editor** mit Schriftart, Farben, Listen, Bildern, Links
|
||||
- **Sichtbarkeit direkt änderbar** per klickbarem Badge in der Vorlagenliste
|
||||
|
||||
## Repository-Struktur (Gitea)
|
||||
|
||||
```
|
||||
repo/
|
||||
├── _gemeinsam/ # Vorlagen für alle Abteilungen
|
||||
│ └── beispiel-vorlage.html
|
||||
├── _benutzer/ # Persönliche Vorlagen pro User
|
||||
│ ├── max@hotel-park-soltau.de/
|
||||
│ └── anna@hotel-park-soltau.de/
|
||||
├── _config/
|
||||
│ └── abteilungen.json # E-Mail → Abteilung Mapping
|
||||
├── Rezeption/ # Abteilungsvorlagen
|
||||
├── IT/
|
||||
├── signatures/
|
||||
│ ├── headers/ # Persönliche Signatur-Köpfe
|
||||
│ │ └── max@hotel.de.max-mustermann.html
|
||||
│ └── footers/ # Gemeinsame Fußbereiche
|
||||
│ └── Rezeption.html
|
||||
```
|
||||
|
||||
### `_config/abteilungen.json`
|
||||
|
||||
Mapping von Abteilungs-E-Mail-Adressen zu Ordnernamen. Wird vom Plugin gelesen, um Abteilung und persönliche E-Mail automatisch zu erkennen:
|
||||
|
||||
```json
|
||||
{
|
||||
"info@hotel-park-soltau.de": "Rezeption",
|
||||
"veranstaltungs@hotel-park-soltau.de": "Veranstaltungsbuero",
|
||||
"it@hotel-park-soltau.de": "IT",
|
||||
"haustechnik@hotel-park-soltau.de": "Haustechnik"
|
||||
}
|
||||
```
|
||||
|
||||
## Plugin-Aufbau
|
||||
|
||||
| Datei | Funktion |
|
||||
|---|---|
|
||||
| `manifest.json` | Extension-Manifest (Thunderbird WebExtension v2) |
|
||||
| `background.js` | Template-Insertion ins Compose-Fenster |
|
||||
| `popup.html` / `popup.js` | Popup beim Klick auf "Vorlagen" im Compose |
|
||||
| `lib/gitea-sync.js` | Gitea-API-Client + Sync-Manager |
|
||||
| `lib/mdi/` | Material Design Icons (Subset) |
|
||||
| `templates_options/` | Einstellungsseite (Vorlagen, Signaturen, Verbindung) |
|
||||
|
||||
## Installation
|
||||
|
||||
### Lokal (Entwicklung)
|
||||
|
||||
1. Thunderbird öffnen
|
||||
2. Extras → Add-ons und Themes
|
||||
3. Zahnrad-Icon → Add-on aus Datei installieren
|
||||
4. `templates-reply-hotel.xpi` auswählen
|
||||
|
||||
### XPI bauen
|
||||
|
||||
```bash
|
||||
7z a templates-reply-hotel.xpi manifest.json background.js popup.html popup.js lib/ templates_options/ icons/
|
||||
```
|
||||
|
||||
## Einrichtung
|
||||
|
||||
1. **Verbindung konfigurieren**: Einstellungen-Tab (⚙) → Server-URL, Repository, Token eingeben → Verbindung speichern
|
||||
2. **Abteilung wählen** (oder automatisch erkannt via `abteilungen.json`)
|
||||
3. **Vorlagen erstellen**: Vorlagen-Tab → Neue Vorlage → Sichtbarkeit wählen → Speichern
|
||||
4. **Signaturen einrichten**: Signaturen-Tab → Identität wählen → Kopfbereich bearbeiten → Speichern
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
- Mozilla Thunderbird >= 109.0
|
||||
- Gitea/Forgejo-Server mit API-Zugang
|
||||
- API-Token mit Repository-Schreibrechten
|
||||
|
||||
## Lizenz
|
||||
|
||||
MIT License
|
||||
|
||||
Reference in New Issue
Block a user