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.

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

  1. Klicken Sie auf E-Mail-Vorlage hinzufügen
  2. Wählen Sie den Vorlagen-Typ (siehe oben)
  3. Geben Sie einen eindeutigen Namen für die Vorlage ein
  4. Formulieren Sie den Betreff der E-Mail
  5. Erstellen Sie den Inhalt (Textversion) der E-Mail
  6. 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
  1. Wählen Sie die gewünschte Vorlage aus der Liste
  2. Klicken Sie auf den Vorlagen-Namen
  3. Nehmen Sie die gewünschten Änderungen vor
  4. Klicken Sie auf Sichern
E-Mail-Vorlage löschen
  1. Markieren Sie die zu löschende(n) Vorlage(n) in der Liste
  2. Wählen Sie aus dem Dropdown Ausgewählte E-Mail-Vorlagen löschen
  3. Klicken Sie auf Ausführen
  4. 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)
  1. Klicken Sie auf Geplante E-Mail hinzufügen
  2. Geben Sie einen Namen ein (z.B. "Geburtstagswünsche", "Arbeitseinsatz-Erinnerung")
  3. Wählen Sie den Trigger-Typ
  4. Wählen Sie die E-Mail-Vorlage (nur passende Vorlagen werden angezeigt)
  5. Stellen Sie die Versandzeit ein (z.B. 08:00)
  6. 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
  1. Klicken Sie auf den Zeitplan-Namen in der Liste
  2. Nehmen Sie die gewünschten Änderungen vor
  3. Klicken Sie auf Sichern
Zeitplan pausieren
  1. Öffnen Sie den Zeitplan
  2. Deaktivieren Sie Aktiv
  3. Klicken Sie auf Sichern
Zeitplan löschen
  1. Markieren Sie die zu löschenden Zeitpläne
  2. Wählen Sie Ausgewählte Geplante E-Mails löschen
  3. Klicken Sie auf Ausführen

Best Practices für E-Mail-Automatisierung

Geburtstagswünsche einrichten

  1. Vorlage erstellen:
  2. Vorlagen-Typ: Geburtstags-E-Mail
  3. Betreff: "Herzlichen Glückwunsch zum Geburtstag, {first_name}!"
  4. Filter: Nur aktive Mitglieder (empfohlen)

  5. Zeitplan erstellen:

  6. Trigger-Typ: Geburtstag heute
  7. Versandzeit: 08:00 (morgens)
  8. Vorlage auswählen
  9. Aktivieren

Arbeitseinsatz-Erinnerungen einrichten

  1. Vorlage erstellen:
  2. Vorlagen-Typ: Arbeitseinsatz-Benachrichtigung
  3. Betreff: "Erinnerung: {event_title} am {event_date}"
  4. Event-Platzhalter verwenden

  5. Zeitplan erstellen:

  6. Trigger-Typ: Arbeitseinsatz-Benachrichtigung
  7. Zeitoffset: z.B. 1 Tag vorher
  8. Nur registrierte Teilnehmer: Ja (empfohlen)
  9. 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

  1. Klicken Sie auf Dokument hinzufügen
  2. Geben Sie einen Titel für das Dokument ein
  3. Wählen Sie die Datei über den Browse-Button aus
  4. 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

  1. Klicken Sie auf den Dokumententitel in der Liste
  2. Ändern Sie den Titel nach Bedarf
  3. Optional: Ersetzen Sie die Datei durch eine neue
  4. Klicken Sie auf Sichern

Aktualisierung

Das Feld Aktualisiert am wird automatisch bei jeder Änderung aktualisiert.

Dokument löschen

  1. Markieren Sie das/die zu löschende(n) Dokument(e)
  2. Wählen Sie Ausgewählte Dokumente löschen aus dem Dropdown
  3. Klicken Sie auf Ausführen
  4. 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

  1. Klicken Sie auf App-Version hinzufügen
  2. Wählen Sie die Plattform (iOS, Android, Web oder Alle Plattformen)
  3. Geben Sie die Version ein (z.B. 1.2.3)
  4. Optional: Setzen Sie eine Mindestversion für zwingend notwendige Updates
  5. Optional: Geben Sie Release Notes ein
  6. Optional: Aktivieren Sie Erzwungenes Update, wenn Benutzer nicht ohne Update fortfahren können
  7. 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

  1. Klicken Sie auf die gewünschte Version in der Liste
  2. Nehmen Sie die erforderlichen Änderungen vor
  3. Klicken Sie auf Sichern

Version löschen

  1. Markieren Sie die zu löschende(n) Version(en)
  2. Wählen Sie Ausgewählte App-Versionen löschen
  3. Klicken Sie auf Ausführen
  4. 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.