Toolbox - Administrator-Handbuch¶
Das Toolbox-Modul stellt verschiedene administrative Werkzeuge zur Verfügung, die bei der Verwaltung des Systems helfen.
Module¶
E-Mail-Automatisierung¶
Die E-Mail-Automatisierung ermöglicht es, automatische E-Mails zu konfigurieren, die basierend auf verschiedenen Triggern (Geburtstage, Arbeitseinsätze, etc.) versendet werden.
Navigation¶
Menüpunkt: Django-Administration → E-Mail-Automatisierung
In diesem Bereich finden Sie zwei miteinander verbundene Tabs: - Vorlagen - E-Mail-Vorlagen erstellen und verwalten - Zeitpläne - Automatischen Versand konfigurieren
E-Mail-Vorlagen¶
E-Mail-Vorlagen sind die Grundlage für personalisierte E-Mails an Mitglieder.
Zugriff¶
Tab: E-Mail-Automatisierung → Vorlagen
Vorlagen-Typen¶
Jede Vorlage hat einen Vorlagen-Typ, der den Verwendungszweck festlegt:
| Typ | Beschreibung | Verfügbare Platzhalter |
|---|---|---|
| Allgemein | Für tägliche E-Mails an alle/gefilterte Empfänger | Mitglieder-Platzhalter |
| Geburtstags-E-Mail | Für automatische Geburtstagswünsche | Mitglieder-Platzhalter |
| Arbeitseinsatz-Benachrichtigung | Für Erinnerungen zu Arbeitseinsätzen | Mitglieder- UND Event-Platzhalter |
Wichtig
Wählen Sie den richtigen Vorlagen-Typ! Eine Vorlage mit Typ "Geburtstags-E-Mail" kann nur für Geburtstags-Zeitpläne verwendet werden.
E-Mail-Vorlage erstellen¶
- Klicken Sie auf E-Mail-Vorlage hinzufügen
- Wählen Sie den Vorlagen-Typ (siehe oben)
- Geben Sie einen eindeutigen Namen für die Vorlage ein
- Formulieren Sie den Betreff der E-Mail
- Erstellen Sie den Inhalt (Textversion) der E-Mail
- Optional: Erstellen Sie eine HTML-Version mit dem Rich-Text-Editor
Platzhalter¶
Mitglieder-Platzhalter (alle Vorlagen-Typen)¶
| Platzhalter | Beschreibung | Beispiel |
|---|---|---|
{first_name} |
Vorname des Mitglieds | Max |
{last_name} |
Nachname des Mitglieds | Mustermann |
{full_name} |
Vollständiger Name | Max Mustermann |
{membership_number} |
Mitgliedsnummer | 12345 |
{membership_status} |
Status des Mitglieds | Aktivmitglied |
{address} |
Adresse | Musterstrasse 1 |
{zip} |
Postleitzahl | 8001 |
{city} |
Ort | Zürich |
{date_of_birth} |
Geburtsdatum | 15.03.1985 |
Event-Platzhalter (nur Arbeitseinsatz-Benachrichtigungen)¶
| Platzhalter | Beschreibung | Beispiel |
|---|---|---|
{event_title} |
Titel des Arbeitseinsatzes | Bachputzete |
{event_date} |
Datum des Einsatzes | 15.04.2025 |
{event_time} |
Startzeit | 08:00 |
{event_end_date} |
Enddatum | 15.04.2025 |
{event_end_time} |
Endzeit | 12:00 |
{event_location} |
Ort des Einsatzes | Vereinshaus |
{event_description} |
Beschreibung | Jährliche Bachputzete... |
Beispiel für Geburtstags-E-Mail:
Betreff: Herzlichen Glückwunsch, {first_name}!
Liebe(r) {first_name} {last_name},
der Fischereiverein wünscht Dir alles Gute zum Geburtstag!
Mit freundlichen Grüssen
Dein Fischereiverein
Beispiel für Arbeitseinsatz-Erinnerung:
Betreff: Erinnerung: {event_title} am {event_date}
Liebe(r) {first_name},
wir möchten Dich an den Arbeitseinsatz "{event_title}" erinnern.
Datum: {event_date}
Zeit: {event_time} - {event_end_time}
Ort: {event_location}
{event_description}
Mit freundlichen Grüssen
Dein Fischereiverein
Empfänger-Filter konfigurieren¶
Die Filter bestimmen, welche Mitglieder die E-Mail erhalten sollen:
Nur aktive Mitglieder Aktivieren Sie diese Option, um E-Mails nur an aktive Mitglieder zu senden.
Mitgliedsstatus filtern Wählen Sie spezifische Mitgliedsstatus aus, um nur Mitglieder mit diesen Status zu erreichen.
Gruppenzugehörigkeit filtern Wählen Sie Benutzergruppen aus, um nur Mitglieder zu erreichen, die diesen Gruppen angehören.
Hinweis
Die verschiedenen Filter werden additiv angewendet. Ein Mitglied muss alle ausgewählten Kriterien erfüllen, um die E-Mail zu erhalten.
Verwaltung¶
E-Mail-Vorlage bearbeiten¶
- Wählen Sie die gewünschte Vorlage aus der Liste
- Klicken Sie auf den Vorlagen-Namen
- Nehmen Sie die gewünschten Änderungen vor
- Klicken Sie auf Sichern
E-Mail-Vorlage löschen¶
- Markieren Sie die zu löschende(n) Vorlage(n) in der Liste
- Wählen Sie aus dem Dropdown Ausgewählte E-Mail-Vorlagen löschen
- Klicken Sie auf Ausführen
- Bestätigen Sie die Löschung
Achtung
Das Löschen einer E-Mail-Vorlage ist endgültig. Verknüpfte Zeitpläne verlieren ihre Vorlage und müssen neu konfiguriert werden.
Geplante E-Mails (Zeitpläne)¶
Zeitpläne definieren, wann und an wen E-Mails automatisch versendet werden.
Zugriff¶
Tab: E-Mail-Automatisierung → Zeitpläne
Trigger-Typen¶
Der Trigger-Typ bestimmt, wann und an wen die E-Mails gesendet werden:
| Trigger-Typ | Beschreibung | Benötigter Vorlagen-Typ |
|---|---|---|
| Alle Empfänger (gemäss Vorlage) | Täglicher Versand an alle Empfänger, die den Filter-Kriterien der Vorlage entsprechen | Allgemein |
| Geburtstag heute | Versand nur an Mitglieder, die heute Geburtstag haben | Geburtstags-E-Mail |
| Arbeitseinsatz-Benachrichtigung | Versand relativ zu Arbeitseinsätzen (X Tage vorher/nachher) | Arbeitseinsatz-Benachrichtigung |
Automatische Filterung
Bei der Auswahl einer Vorlage werden nur Vorlagen angezeigt, die zum gewählten Trigger-Typ passen.
Zeitplan erstellen¶
Grundkonfiguration (alle Trigger-Typen)¶
- Klicken Sie auf Geplante E-Mail hinzufügen
- Geben Sie einen Namen ein (z.B. "Geburtstagswünsche", "Arbeitseinsatz-Erinnerung")
- Wählen Sie den Trigger-Typ
- Wählen Sie die E-Mail-Vorlage (nur passende Vorlagen werden angezeigt)
- Stellen Sie die Versandzeit ein (z.B. 08:00)
- Aktivieren Sie Aktiv, um den automatischen Versand zu starten
Zusätzliche Einstellungen für Arbeitseinsatz-Benachrichtigungen¶
Wenn Sie "Arbeitseinsatz-Benachrichtigung" als Trigger-Typ wählen, erscheinen zusätzliche Felder:
Zeitoffset konfigurieren:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Tage | Anzahl Tage vor/nach dem Event | 1 |
| Stunden | Zusätzliche Stunden (0-23) | 0 |
| Minuten | Zusätzliche Minuten (0-59) | 0 |
| Richtung | Ob vor oder nach dem Event | "vorher" |
Beispiel: "1 Tag, 0 Stunden, 0 Minuten, vorher" → E-Mail wird 24 Stunden vor dem Arbeitseinsatz versendet.
Empfänger-Filter:
| Option | Beschreibung |
|---|---|
| Nur registrierte Teilnehmer | E-Mail nur an Mitglieder, die sich für den Arbeitseinsatz angemeldet haben |
| Deaktiviert | E-Mail an alle Empfänger gemäss Vorlagen-Filter |
Status-Anzeige¶
In der Listenansicht sehen Sie den Status jedes Zeitplans:
| Status | Bedeutung |
|---|---|
| ✅ Aktiv | Automatischer Versand läuft |
| ⏸️ Pausiert | Zeitplan ist deaktiviert |
| ⚠️ Vorlage fehlt | Die verknüpfte Vorlage wurde gelöscht |
Tracking-Informationen¶
Für jeden Zeitplan werden automatisch erfasst:
- Letzter Versand: Zeitpunkt des letzten erfolgreichen Versands
- Anzahl letzter Versand: Wie viele E-Mails beim letzten Mal gesendet wurden
- Letztes Versanddatum: Zur Vermeidung von Doppelversand am selben Tag
Verwaltung¶
Zeitplan bearbeiten¶
- Klicken Sie auf den Zeitplan-Namen in der Liste
- Nehmen Sie die gewünschten Änderungen vor
- Klicken Sie auf Sichern
Zeitplan pausieren¶
- Öffnen Sie den Zeitplan
- Deaktivieren Sie Aktiv
- Klicken Sie auf Sichern
Zeitplan löschen¶
- Markieren Sie die zu löschenden Zeitpläne
- Wählen Sie Ausgewählte Geplante E-Mails löschen
- Klicken Sie auf Ausführen
Best Practices für E-Mail-Automatisierung¶
Geburtstagswünsche einrichten¶
- Vorlage erstellen:
- Vorlagen-Typ: Geburtstags-E-Mail
- Betreff: "Herzlichen Glückwunsch zum Geburtstag, {first_name}!"
-
Filter: Nur aktive Mitglieder (empfohlen)
-
Zeitplan erstellen:
- Trigger-Typ: Geburtstag heute
- Versandzeit: 08:00 (morgens)
- Vorlage auswählen
- Aktivieren
Arbeitseinsatz-Erinnerungen einrichten¶
- Vorlage erstellen:
- Vorlagen-Typ: Arbeitseinsatz-Benachrichtigung
- Betreff: "Erinnerung: {event_title} am {event_date}"
-
Event-Platzhalter verwenden
-
Zeitplan erstellen:
- Trigger-Typ: Arbeitseinsatz-Benachrichtigung
- Zeitoffset: z.B. 1 Tag vorher
- Nur registrierte Teilnehmer: Ja (empfohlen)
- Aktivieren
Tipp
Sie können mehrere Erinnerungen einrichten, z.B. eine Woche vorher und einen Tag vorher, indem Sie zwei verschiedene Zeitpläne mit derselben Vorlage erstellen.
Dokumente¶
Das Dokumentenmanagement ermöglicht die zentrale Verwaltung von Dateien verschiedener Formate.
Zugriff¶
Menüpunkt: Django-Administration → Toolbox → Dokumente
Unterstützte Dateiformate¶
Bilder: JPG, JPEG, PNG, GIF Dokumente: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX Text: TXT, MD, CSV
Funktionen¶
Dokument hochladen¶
- Klicken Sie auf Dokument hinzufügen
- Geben Sie einen Titel für das Dokument ein
- Wählen Sie die Datei über den Browse-Button aus
- Klicken Sie auf Sichern
Sicherheit
Aus Sicherheitsgründen werden die ursprünglichen Dateinamen durch UUID-basierte Namen ersetzt.
Dokument anzeigen¶
- In der Dokumentenliste werden Titel, Dateityp, Dateigröße und Upload-Datum angezeigt
- Die Dateigröße wird automatisch in einem lesbaren Format angezeigt (B, KB, MB, GB)
Verwaltung¶
Dokument bearbeiten¶
- Klicken Sie auf den Dokumententitel in der Liste
- Ändern Sie den Titel nach Bedarf
- Optional: Ersetzen Sie die Datei durch eine neue
- Klicken Sie auf Sichern
Aktualisierung
Das Feld Aktualisiert am wird automatisch bei jeder Änderung aktualisiert.
Dokument löschen¶
- Markieren Sie das/die zu löschende(n) Dokument(e)
- Wählen Sie Ausgewählte Dokumente löschen aus dem Dropdown
- Klicken Sie auf Ausführen
- Bestätigen Sie die Löschung
Achtung
Das Löschen eines Dokuments entfernt sowohl den Datenbankeintrag als auch die physische Datei vom Server. Diese Aktion ist nicht umkehrbar.
App-Versionen¶
Die App-Versionsverwaltung ist ein systemweites Tool zur Verwaltung von App-Updates.
Zugriff¶
Menüpunkt: Django-Administration → Toolbox → App-Versionen
Zugriffsbeschränkung
Dieses Modul ist nur für Superadministratoren im öffentlichen Schema sichtbar und zugänglich.
Funktionen¶
App-Version anlegen¶
- Klicken Sie auf App-Version hinzufügen
- Wählen Sie die Plattform (iOS, Android, Web oder Alle Plattformen)
- Geben Sie die Version ein (z.B. 1.2.3)
- Optional: Setzen Sie eine Mindestversion für zwingend notwendige Updates
- Optional: Geben Sie Release Notes ein
- Optional: Aktivieren Sie Erzwungenes Update, wenn Benutzer nicht ohne Update fortfahren können
- Klicken Sie auf Sichern
Konfigurationsoptionen¶
Plattform - iOS: Nur für iOS-Apps - Android: Nur für Android-Apps - Web: Nur für Web-Anwendungen - Alle Plattformen: Gilt für alle App-Versionen
Mindestversion Definiert die niedrigste akzeptable App-Version. Benutzer mit älteren Versionen erhalten eine Update-Aufforderung.
Erzwungenes Update Verhindert, dass Benutzer die App ohne Update verwenden können.
Verwaltung¶
Version bearbeiten¶
- Klicken Sie auf die gewünschte Version in der Liste
- Nehmen Sie die erforderlichen Änderungen vor
- Klicken Sie auf Sichern
Version löschen¶
- Markieren Sie die zu löschende(n) Version(en)
- Wählen Sie Ausgewählte App-Versionen löschen
- Klicken Sie auf Ausführen
- Bestätigen Sie die Löschung
Systemweite Auswirkung
Änderungen an App-Versionen wirken sich auf alle Vereine (Tenants) im System aus.
Allgemeine Hinweise¶
Suche¶
Alle Module bieten eine Suchfunktion über das Suchfeld am oberen Rand der Listen.
Filter¶
Verwenden Sie die Filter am rechten Rand, um die Anzeige nach verschiedenen Kriterien einzuschränken.
Bulk-Aktionen¶
Viele Aktionen können auf mehrere Einträge gleichzeitig angewendet werden: 1. Markieren Sie die gewünschten Einträge mit den Checkboxen 2. Wählen Sie die gewünschte Aktion aus dem Dropdown 3. Klicken Sie auf Ausführen
Wichtig
Löschaktionen sind in der Regel endgültig. Überprüfen Sie Ihre Auswahl sorgfältig, bevor Sie eine Löschaktion bestätigen.
Tab-Navigation¶
Bei einigen Modulen (z.B. E-Mail-Automatisierung, Mitglieder) können Sie über Tabs zwischen zusammengehörigen Bereichen wechseln, ohne ins Hauptmenü zurückkehren zu müssen.