Handbuch für Admins – FCE Mannschaftsverwaltung
Stand: 11. Mai 2026
Zielgruppe: Admin / Superuser mit vollständigen Verwaltungsrechten
✨ Neu im Mai 2026: Design-Update + Nav-Restruktur
Admin-Bereich ist jetzt ein eigenes Menü
Der „Admin-Bereich" sitzt nicht mehr unter „Mehr → Admin", sondern als eigener Hauptmenü-Eintrag „Admin ▾" (nur sichtbar wenn is_admin in deiner Session). Das Dropdown ist in drei Sektionen gegliedert:
Vereinsverwaltung
- Admin-Übersicht — Trainer-Anträge, Pässe, etc. (
/admin) - Offene Punkte — Spieler ohne Mitgliedsnummer, Dokumente etc. (
/admin/uebersicht) - Vereins-Einstellungen — Logo, Farben, SMTP, Module (
/admin/verein-konfiguration) - Module — Feature-Flags an-/abschalten (
/admin/module)
Trainer & Mannschaften
- Trainer-Verwaltung — Freischaltungen, Rollen, Deaktivierungen
- Neuzugänge / Uploads — neue Unterlagen überprüfen
- Unstimmigkeiten — Fehler bei Import/Sync
- Namen-Review — Korrekturen in Spielerdaten
Eltern & Spieler
- Eltern-Konten (
/admin/eltern) - Spieler-Accounts (
/admin/spieler-accounts) - Mannschafts-Einladungen (
/admin/mannschaftseinladungen)
System
- Cron-Jobs + Lauf-Log (
/admin/cron) - Bug-Reports / Tickets (
/tickets)
Platzvergabe-Dropdown vollständig
Alle 9 Platzvergabe-Funktionen aus dem alten Burger-Menü stehen jetzt im „Platzvergabe ▾"-Dropdown:
- Wochenplan, Verfügbarkeit, Spiel eintragen, Spiele ohne Platz, Spielplan-Konflikte
- Verwaltung: Plätze, Kabinen, DFBnet-Abgleich, FDE-Teams zuordnen
Dunkelmodus, Account-Menü, Hilfe-Icon
Siehe Trainer-Handbuch — gleiches Verhalten.
Cron-Setup für FDE-Sync
Der frühere „fussball.de-Sync"-Button im UI ist jetzt ein Cron-Job. So richtest du ihn ein:
- Admin → System → Cron-Jobs öffnen
- Token kopieren
- Auf der Hetzner-VM:
sudo crontab -e - Eintrag einfügen (z.B. dreimal täglich):
0 6,12,18 * * * curl -fsS "https://fcerheine.kickdesk.de/cron/spielplan-sync?token=DEIN_TOKEN" > /dev/null 2>&1
- Lauf-Log unter
/admin/cronzeigt dir nach jeder Ausführung Status + Ausgabe.
FDE-Sync-Bugfix
Der frühere Bug, der bei jedem Sync Duplikat-Einträge ohne Mannschaftszahl ('E', 'F', 'C' statt 'E4', 'F6', 'C1') angelegt hat, ist behoben. Beim ersten Live-Sync nach dem 04.05.2026 wurden ~57 Altlasten in der Live-DB aufgeräumt (Backup unter /data/backups/mannschaften.before-cleanup-*.db).
Theme-Persistenz: neue DB-Spalte
auto_migrate() legt beim nächsten Container-Start die Spalte user.theme_preference VARCHAR(10) DEFAULT 'system' an. Falls sie fehlt: einmal docker compose restart. Wenn auch das nicht greift, manuell:
docker exec kickdesk-fcerheine python3 -c "
import sqlite3
con = sqlite3.connect('/data/mannschaften.db')
con.execute(\"ALTER TABLE user ADD COLUMN theme_preference VARCHAR(10) NOT NULL DEFAULT 'system'\")
con.commit()
print('OK')
"
Inhaltsverzeichnis
- Einstieg & Übersicht
- Rollen & Berechtigungen
- Vereinskonfiguration
- Mannschaftsverwaltung
- Trainer-Verwaltung
- Saisonwechsel
- Passwesen & Neuanmeldungen
- DFBnet & fussball.de Integration
- Platzvergabe & Trainingsplan
- Plätze & Halbplatz-Teilung
- Kalender & Plan-Ansichten
- AppModule (Feature-Flags) & Modul-Verwaltung
- Nachrichten-Vorlagen für Trainer
- Vereinsnachrichten versenden
- Eltern-Portal & Spiele-Synchronisation
- Spieler-Accounts verwalten
- Test-Mannschaften & Beta-Features
- SMTP-Konten & Mail-Rollen
- Tickets-Übersicht
- Trainer-Anleitungen verwalten
- DSGVO Spieler-Unterschriften
- Wartelisten verwalten
- Werbung & AdSense
- Lokale Sponsoren
- Backups & Datenschutz
- Häufige Fragen
1. Einstieg & Übersicht
Die Admin-Übersicht ist das Kommandozentrum für Vereinsverwaltung. Sie finden hier auf einen Blick:
- Offene Trainer-Registrierungen – Wer wartet auf Freischaltung?
- Neue Unterlagen (Uploads) – Dateien, die hochgeladen wurden
- Offene Neuanmeldungen – Wie viele Spieler warten noch?
- Spieler ohne Mitgliedsnummer – Lücken im DFB-Abgleich
So greifen Sie aufs Admin-Dashboard zu
Nach dem Login: Admin (Hamburger-Menü rechts oben) → Übersicht
Hier sehen Sie alle offenen Aufgaben als farbig gekennzeichnete Karten:
- 🟡 Gelb = Registrierungen warten
- 🔴 Rot = Neue Unterlagen
- 🔵 Blau = Neuanmeldungen
- ⚫ Grau = Fehlende Mitgliedsnummern
Alle Zahlen sind anklickbar und führen direkt zur Detailseite.
2. Rollen & Berechtigungen
Die App unterscheidet fünf Trainer-Rollen:
| Rolle | Berechtigungen | Verwendung |
|-------|---|---|
| Trainer | Spielerlisten verwalten, Neuanmeldungen freigeben | Standard für alle aktiven Trainers |
| Cheftrainer | + Textvorlagen bearbeiten | Verbandsverantwortlicher pro Mannschaft |
| Sportl. Leiter Jugend | + Alle Jugend-Mannschaften sehen | Koordination aller U-Teams |
| Sportleiter Senioren | + Alle Senioren-Mannschaften sehen | Koordination aller Herren-Teams |
| Admin | + System-Befugnisse | Vereinsverwaltung, Saisonwechsel, DFB-Import |
Super-User vs. Admin
- Admin = Normale Admin-Rechte (Vereinskonfiguration, Mannschaften, Trainer)
- Super-User = Kann Saisonwechsel ausführen und Trainer zu Admin machen (Superuser benötigen Admin-Rechte)
Rollen zuweisen
Admin → Trainer-Verwaltung → Trainer auswählen → Rollen bearbeiten
- Checkboxen für die gewünschten Rollen setzen
- Speichern
Hinweis: Ein Trainer mit einer Rolle (z.B. Cheftrainer) sieht automatisch alle Mannschaften, die diese Rolle erfordern.
3. Vereinskonfiguration
Logo & Farben
Admin → Vereinskonfiguration → Logo & Farben
Logo hochladen
- PNG mit transparentem Hintergrund vorbereiten (mind. 192×192 px)
- Datei hochladen
- Das Logo wird verwendet als:
- Browser-Tab-Icon (Favicon)
- Home-Screen-Icon auf Smartphones (Apple-Touch-Icon)
- Branding in der App-Navigation
Vereinsfarben anpassen
- Primärfarbe wählen (Navigation, Buttons, Header)
- Sekundärfarbe setzen (Akzente)
- Speichern
- Browser-Tab neu laden, um Änderungen zu sehen
⚠️ Die Farben beeinflussen das gesamte Design – testen Sie, ob Kontraste ausreichend sind.
Vereinsdaten & fussball.de Integration
Admin → Vereinskonfiguration → Vereinsdaten
- Vereinsname (z.B. „FC Eintracht Rheine")
- Vereinskürzel (z.B. „FCE")
- fussball.de Verein-ID (numerisch, z.B.
123456) - fussball.de Verein-Slug (aus URL, z.B.
fc-eintracht-rheine) - Saison (Formatierung
25/26)
Diese Daten sind Voraussetzung für:
- DFBnet-CSV-Import
- fussball.de-Spielplan-Sync
- Automatische Team-ID-Zuordnung
4. Mannschaftsverwaltung
Neue Mannschaft anlegen
Admin → Übersicht → + Neue Mannschaft (oder direkt über Mannschaftsseite)
Felder:
- Name (z.B. „U14 Juniorinnen")
- Kürzel (z.B. „U14w")
- Bereich (Kategorie: Jugend/Senioren)
- Saison (automatisch aktuell, änderbar für historische Einträge)
- Ansprechpartner Passwesen (Trainer mit Passwesen-Verantwortung)
- Trainers (zum Verwalten zuweisung)
Speichern.
⚠️ Vorsicht beim Löschen: Eine gelöschte Mannschaft löscht auch alle zugehörigen Spieler, Neuanmeldungen und Platzvergaben. Dies kann nicht rückgängig gemacht werden. Nutzen Sie stattdessen Deaktivieren.
Mannschaft deaktivieren (statt löschen)
- Mannschaftsseite öffnen
- Deaktivieren klicken
- Mannschaft ist weiterhin in der Historie sichtbar, neue Spieler können nicht hinzugefügt werden
Trainer zur Mannschaft zuweisen
Admin → Trainerverwaltung → Trainer → Mannschaften verwalten
Hier können Sie dem Trainer Mannschaften zuweisen, für die er verantwortlich ist.
5. Trainer-Verwaltung
Neue Trainer freischalten
Trainer registrieren sich selbst über einen Einladungslink. Sie erscheinen dann unter Admin → Übersicht → Ausstehende Trainer-Registrierungen.
Freischaltung:
- Trainer in der Liste auswählen
- Freischalten klicken
- Trainer erhält automatisch eine E-Mail mit Bestätigung
⚠️ Duplikate: Wenn ein Trainer mit gleicher E-Mail bereits existiert (aber in anderem Status), warnt die App Sie. Sie können die E-Mail dann zusammenführen (alt mit neu zusammenmergen und delete).
Trainer bearbeiten / deaktivieren
Admin → Trainerverwaltung → Trainer auswählen
Sie können hier:
- Rollen ändern (Trainer, Cheftrainer, Sportl. Leiter …)
- Passwort zurücksetzen (Trainer erhält E-Mail mit Link)
- Trainer deaktivieren (Mannschaften werden nicht mehr angezeigt, Login funktioniert nicht)
- JV-Status entfernen (Falls Trainer versehentlich als Jugendverbands-Mitglied importiert wurde)
- Trainer löschen (⚠️ Kann nicht rückgängig gemacht werden)
Trainer-Anschreiben (Batch-E-Mail)
Admin → Trainer-Anschreiben
Sie können einer Gruppe von Trainern eine E-Mail schreiben (z.B. alle Cheftrainer oder alle einer Mannschaft). Die App generiert automatisch Beiträge mit [MID-X]-Token für Antwort-Tracking.
6. Saisonwechsel
⚠️ Nur für Super-User freigegeben – ein sehr sensitiver Prozess!
Ablauf beim Saisonwechsel
- Alte Saison umbenennen – z.B.
2024/25→2024/25 (archiviert) - Neue Saison aktivieren – z.B.
2025/26wird zur aktuellen Saison - Spieler hochziehen – Optionalweise automatisch zur nächsthöheren Altersgruppe verschieben
- Alte Saison archivieren – In die Historie verschieben, Read-Only
So führen Sie einen Saisonwechsel aus:
Admin → Saisonwechsel
Schritt 1: Alte Saison umbenennen
- Saison-Name ändern (z.B.
2024/25→2024/25 (archiviert)) - Speichern
Schritt 2: Neue Saison aktivieren
- Neue Saison-ID / Name angeben
- Aktivieren klicken
Schritt 3: Spieler hochziehen (optional)
- Alle aktiven Spieler der vorigen Saison können automatisch zur neuen Altersgruppe verschoben werden
- Wählen Sie aus, welche Mannschaften hochgezogen werden sollen
Schritt 4: Alte Saison archivieren
- Historische Daten bleiben erhalten, können aber nicht mehr bearbeitet werden
⚠️ Vorsicht: Ein Saisonwechsel kann nicht rückgängig gemacht werden. Erstellen Sie vorher ein Backup (siehe Kapitel 12).
7. Passwesen & Neuanmeldungen
Workflow einer Neuanmeldung
Eine typische Neuanmeldung durchläuft folgende Status:
neu– Gerade erfasst, Trainer wird benachrichtigtpassantrag– Eltern haben Passantrag eingereicht (Upload)unterlagen_erhalten– Trainers haben Unterlagen erhaltenabgeschlossen– DFB-Abgleich bestätigt, Spieler ist freigegeben
Neuanmeldung erfassen
Admin oder Trainer → Neuanmeldungen → + Neue Anmeldung
Felder:
- Spieler-Daten (Name, Vorname, Geburt …)
- Mannschaft
- Eltern-Kontakt
Status wird automatisch auf neu gesetzt.
Unterlagen verwalten
Admin → Upload-Verwaltung
Hier sehen Sie alle hochgeladenen Dateien:
- Neue Dateien haben Status
neu - Klicken Sie auf einen Upload, um ihn einer Neuanmeldung oder einem Spieler zuzuordnen
- Markieren Sie als Gesehen, wenn die Unterlagen überprüft wurden
⚠️ Dateien werden automatisch umbenannt nach Schema: Nachname Vorname - Beschreibung.ext
Email-Notifikationen für Neuanmeldungen
Wenn eine Neuanmeldung erfasst wird, erhalten berechtigte Trainer automatisch E-Mails. Die E-Mail enthält einen Token wie [NID-123], womit sie antworten können.
Textvorlagen verwalten:
Admin → Textvorlagen
Vorlagen steuern den Inhalt von Benachrichtigungs-E-Mails:
| Vorlagen-Titel | Auslöser | Platzhalter |
|---|---|---|
| neuanmeldung_neu | Neue Anmeldung | {name}, {vorname}, {mannschaft} |
| neuanmeldung_passantrag | Status → passantrag | {name}, {vorname}, {mannschaft} |
| neuanmeldung_unterlagen | Status → unterlagen_erhalten | {name}, {vorname}, {mannschaft} |
| neuanmeldung_genehmigt | Nach DFBnet-Abgleich | {name}, {vorname}, {mannschaft}, {passnummer}, {spielrecht_pflicht}, {spielrecht_freundschaft} |
8. DFBnet & fussball.de Integration
DFBnet-CSV-Import
Mit diesem Feature importieren Sie eine CSV-Liste mit Mitgliedsnummern vom DFB direkt in die App.
Admin → DFBnet / Import
- CSV-Datei mit folgendem Format bereithalten:
Mitglieds-Nr; Nachname; Vorname; Geburtsdatum; ...
- Datei hochladen
- Die App matched Spieler automatisch:
Nachname Vorname→ gefundener Spieler in der DB - Zuordnungen überprüfen – Manuell korrigieren, falls nötig
- Speichern – Mitgliedsnummern werden zugewiesen
⚠️ Die App zeigt Duplikate und Fehler-Matches an – bitte vor dem Speichern überprüfen.
fussball.de Team-IDs zuordnen
Mit dieser Funktion verlinken Sie Ihre Mannschaften mit den entsprechenden Team-IDs auf fussball.de (für Spielplan-Sync).
Admin → DFBnet / Import → fussball.de Team-Zuordnung
- Auf fussball.de die Vereinsseite öffnen
- Browser-Quelltext kopieren (Strg+U)
- Quelltext hier einfügen und URLs erkennen klicken
- Die App extrahiert automatisch Team-IDs und URLs
- Zuordnung bestätigen – Mannschaften mit Team-IDs matchen
- Speichern
⚠️ Die automatische Erkennung erfasst nur Herren-Teams. Jugend-Teams (A1, B1 …) müssen Sie per URL-Paste manuell ergänzen.
Spielplan-Sync von fussball.de
Admin → DFBnet / Import → Spielplan-Sync
- Alle Team-IDs müssen vorher zugeordnet sein (siehe oben)
- Sync starten klicken
- Die App ruft den Spielplan von fussball.de ab und importiert Spiele automatisch
⚠️ Konflikt-Handling: Falls ein Spiel bereits existiert (Zeit/Gegner unterscheidet sich), wird es als Konflikt markiert. Sie können dann entscheiden: Übernehmen (neue Daten) oder Ignorieren (behalten Alt).
9. Platzvergabe & Trainingsplan
Plätze verwalten
Admin → Platzverwaltung
Sie können hier alle verfügbaren Plätze definieren:
- Name (z.B. „Naturrasenplatz 1")
- Kapazität / Anzahl der Felder
- Ausstattung (Kabinen, Flutlicht …)
Spiele zu Plätzen zuordnen
Spielplan-View → Spiel klicken → Platz zuordnen
- Beleuchtung / Zeit berücksichtigen
- Verfügbarkeit checken (überschneidungsfreie Zeiten)
Trainingsplan
Trainer → Trainingsplan
Jede Mannschaft kann einen wöchentlichen Trainingsplan haben:
- Tag und Uhrzeit
- Platz / Ort
- Trainingsfokus (optional)
Der Plan ist in der Trainer-App für Spieler sichtbar.
10. Plätze & Halbplatz-Teilung
Neu in Mai 2026: Plätze können jetzt in Hälften (A/B) oder Drittel (A/B/C) aufgeteilt werden – ideal, wenn E/F/G-Teams zur gleichen Zeit auf demselben Platz trainieren oder spielen.
Platz-Konfiguration erweitern
Admin → Platzvergabe ▾ → Plätze verwalten
Beim Anlegen oder Bearbeiten eines Platzes:
- Name – z.B. „Naturrasenplatz 1"
- Adresse & GPS – für Maps
- Max. gleichzeitig (neu!) – Dropdown mit drei Optionen:
- 1 = Vollfeld (Standardwert, nicht teilbar)
- 2 = Teilbar in A/B (für 2 Mannschaften zur gleichen Zeit)
- 3 = Teilbar in A/B/C (für 3 Mannschaften)
- Ausstattung – Kabinen, Flutlicht, etc.
Diese Einstellung steuert, ob in Spiel- und Trainings-Formularen das Halbplatz-Dropdown sichtbar ist.
Halbplatz-Zuweisungen bei Trainings & Spielen
Wenn ein Platz als teilbar konfiguriert ist (Max. gleichzeitig = 2 oder 3):
- In Trainings-Formularen erscheint ein Dropdown: „Ganzer Platz / Teil A / Teil B / Teil C"
- In Spiel-Formularen (Platzvergabe) gleiches Dropdown
- Option C ist nur sichtbar, wenn
Max. gleichzeitig = 3
So können Sie zwei E-Teams parallel auf demselben Naturrasen trainieren, ohne Konflikte zu erzeugen.
Auto-Halbplatz-Zuweisung beim FDE-Sync
Neu: Wenn Sie Spiele vom fussball.de importieren (Spielplan-Sync) und mehrere E/F/G-Spiele zur exakt gleichen Zeit auf dem gleichen teilbaren Platz landen, verteilt die App sie automatisch auf freie Hälften:
- Team E → Teil A
- Team F → Teil B
- Team G → Teil C (falls vorhanden)
Wichtig:
- Nur E/F/G-Spiele werden automatisch verteilt (nicht U-13+)
- Greedy-Algorithmus: „earliest finish first" (wer zuerst fertig ist, wird bevorzugt)
- Bestehende manuelle Halbplatz-Zuweisungen werden NICHT überschrieben – nur freie Slots werden befüllt
Der Sync läuft sowohl beim manuellen Button (/admin/dfbnet-import → „Spielplan-Sync starten") als auch beim automatischen Cron-Job alle Stunden.
11. Kalender & Plan-Ansichten
Neu: Trainer sehen nicht nur eine Wochenliste, sondern auch eine interaktive Plan-Ansicht im Kalender und in Training/Platzvergabe-Bereichen.
Kalender-Plan-Ansicht
Kalender (Hauptmenü) → Plan-Ansicht (Standard)
Die neue Standard-Ansicht ist ein Tages-Raster:
- Y-Achse: Alle Plätze (sortiert)
- X-Achse: Stunden des Tages
- Tages-Tabs oben: Mit Terminzahl und Konflikt-Badges pro Tag
- Rechts Sidebar:
- Wochen-Auslastungs-Heatmap (visuell: welche Tage sind voll?)
- Tages-Agenda (Termine gelistet)
- Wochen-Übersicht nach Typ (wie viele Trainings, Spiele, etc.)
Auf Mobile: Nur Sidebar wird angezeigt (Platz-Grid ist zu groß).
Konflikt-Erkennung: Die App zeigt automatisch an, wenn 2+ Trainings/Spiele auf gleichem Platz + gleicher Zeit stattfinden. Wichtig: A und B eines geteilten Platzes gelten NICHT als Konflikt (das ist Absicht).
Training & Platzvergabe Plan-Ansichten
Training ▾ → Plan-Ansicht (oder Wochenplan für alte List-View)
Platzvergabe ▾ → Plan-Ansicht (oder Wochenliste für alte List-View)
Beide zeigen das gleiche Raster-Layout, aber gefiltert:
- Training: nur Trainings
- Platzvergabe: nur Spiele
Toolbar oben:
- + Neue Zeit / + Neues Spiel – schnell hinzufügen
- Plätze, PDF (Spielplan-Export), etc.
- Plan ↔ Woche Toggle
Click-to-Edit & Drag & Drop
Trainer mit passender Berechtigung (kann_training, kann_platzvergabe) können:
- Click-to-Edit: Auf ein Training/Spiel klicken → Pop-up öffnet sich zum Bearbeiten (Zeit, Platz, Halbplatz, etc.)
- Drag & Drop:
- Innerhalb des gleichen Tages: Platz/Halbplatz/Uhrzeit ändern (15-Min-Snap)
- Über mehrere Tage: Neuer Wochentag + Uhrzeit
Das spart Zeit bei der Platzvergabe!
12. AppModule (Feature-Flags) & Modul-Verwaltung
Mit AppModulen können Sie Funktionen global aktivieren/deaktivieren – ohne Code zu ändern. Das System ermöglicht es Ihnen, neue Features schrittweise einzuführen und als Beta zu markieren.
Modul-Verwaltung öffnen
Admin → Vereinsverwaltung → Module
Hier sehen Sie alle verfügbaren Module (z.B. Eltern-Portal, Spielplan-Sync, Passwesen, Trainer-Anleitungen).
"Was ist neu"-Banner nach Updates
Wenn Ihr Admin-Team ein Update mit neuen Features deployed, erscheint automatisch ein gelbes Banner auf dem Admin-Dashboard:
✨ Neu: X Module verfügbar
Dieses Banner zeigt an, dass neue Features hinzugekommen sind. Es funktioniert folgendermaßen:
- Oben im Admin-Dashboard – Gelber Hinweis mit "Was ist neu"-Link
- Admin → Module – Oben auf dieser Seite eine separate gelbe „Was ist neu"-Sektion mit allen neuen Modulen
- Pro Modul: Sie sehen zwei Buttons:
- Aktivieren – Feature für berechtigte Trainer freischalten
- Gesehen – Nur den Hinweis für dieses Modul wegklicken (ohne Aktivierung)
- Alle gesehen-Button – Klick hier, um alle "Was ist neu"-Hinweise auf einmal zu löschen
Ein Modul verwalten
Für jedes Modul in der Liste haben Sie diese Kontrollen:
| Element | Erklärung |
|---------|-----------|
| Global aktiv (✓/✗) | Modul an- oder ausschalten. Wenn deaktiviert, verschwinden zugehörige Menü-Einträge (z.B. Anleitungen-Link). |
| Beta-Badge (🔶/–) | Zeigt im Menü einen "⚠️ BETA"-Hinweis, um Trainer zu warnen. |
| Alle aktivieren | Schaltet das Modul für alle berechtigten Trainer ein (nicht nur Admin-Sicht). |
| Schlüssel (Code) | Interne Kennzeichnung, z.B. trainer_anleitungen. |
Beispiel: Trainer-Anleitungen-Modul
Das erste Modul, das mit diesem System verwaltet wird:
- Schlüssel:
trainer_anleitungen - Was es macht: Trainer können zentral Dokumente (PDFs, Anleitungen, Regelwerke) hochladen und verwalten
- Sichtbarkeit: Wenn Global aktiv = Ein, sehen Trainer einen „Anleitungen"-Link in der Navigation
- Wenn deaktiviert: Der Link verschwindet aus der Navigation – Trainer sehen die Funktion nicht mehr
- Admin sieht: Immer alle Module, unabhängig vom Aktivitätsstatus (zum Verwalten und Debuggen)
So können Sie Tests durchführen oder Features gezielt für bestimmte Zeit abschalten, ohne Code zu ändern.
Workflow: Neues Feature mit Vorsicht einführen
- Nach Update → Gelbes "Was ist neu"-Banner erscheint
- In Admin → Module: Neues Modul ist dort sichtbar
- Testen:
- „Alle aktivieren" klicken ✓
- Über „Als Trainer einloggen" testen
- Bei Problemen: Modul schnell Global aktiv = Aus setzen
- Nach Test: Trainer sehen die Funktion im Menü; Sie können später „Gesehen" klicken, um den Hinweis zu löschen
Verwendungsfall: Sie möchten das Eltern-Portal für bestimmte Mannschaften testen, bevor es für alle freigegeben wird. Sie aktivieren das Modul global, aber nur ausgewählte Trainer erhalten das Feature-Flag. Admin sieht immer alles.
13. Nachrichten-Vorlagen für Trainer
Neu Mai 2026: Admins können jetzt zentrale Nachrichtensevorlagen verwalten, die alle Trainer verwenden können — ideal um einheitliche, vorgefertigte Inhalte bereitzustellen.
Vorlagen verwalten
Admin → Vereinsverwaltung → Nachrichten-Vorlagen (oder direkt /admin/nachrichten-vorlagen)
Hier sehen Sie alle Vereins-Vorlagen (zentral vom Admin gepflegte Templates) und können diese bearbeiten oder löschen.
Neue Vorlage erstellen
Klick auf + Neue Vorlage:
| Feld | Erklärung |
|------|-----------|
| Titel | Kurzer Name (z.B. „Training fällt aus") — wie Trainer die Vorlage im Dropdown finden |
| Betreff | Vorgefertigter Mail-Betreff (z.B. „Training Montag fällt aus wegen {grund}") |
| Text | Vorlage-Text mit Platzhaltern (z.B. „Liebe Eltern,\n\ndas Training am {datum} entfällt.\n\n{grund}\n\nViele Grüße,\n[Trainername]") |
| Standard-Audience | Wer ist die Zielgruppe? „Eltern", „Spieler" oder „Beide" — wird als Vorauswahl im Trainer-Formular angezeigt |
| Sortierung | Zahlenwert — Vorlagen mit niedriger Zahl stehen oben in der Liste |
Platzhalter, die Trainer später ersetzen können:
{datum}– Termin-Datum{uhrzeit}– Uhrzeit{ort}– Ort/Platz{grund}– Grund (Krankheit, Rasenreparatur, etc.){mannschaft}– Mannschaftsname
Speichern.
Vorlage bearbeiten / löschen
- Vorlage in der Liste auswählen
- Bearbeiten klicken — Felder ändern und speichern
- Oder Löschen — Vorlage wird sofort entfernt (nicht aus historischen Nachrichten!)
Hinweis: Das Löschen betrifft nur die Vorlage selbst, nicht bereits versendete Nachrichten.
Trainer-Sicht
Trainer sehen alle Vereins-Vorlagen (diese) und zusätzlich ihre eigenen persönlichen Vorlagen (die sie selbst angelegt haben) — gruppiert im Dropdown beim Nachrichten-Versenden.
14. Vereinsnachrichten versenden
Neu Mai 2026: Admins/Superuser können jetzt vereinsweit an Eltern & Spieler eine Nachricht versenden — gefiltert nach Altersgruppe.
Wann brauchst du das?
- Vereins-weite Infos (z.B. Saisonstart-Termin)
- Altersgruppen-spezifische Mitteilungen (z.B. nur an Bambini-Eltern)
- Wichtige Regelwerks-Updates
- Ankündigungen für Vereinsfeste, Turniere
Vereinsnachricht senden
Admin → Vereinsnachricht versenden (oder direkt /admin/vereinsnachricht/neu)
Das Formular funktioniert ähnlich wie Trainer-Nachrichten, hat aber zusätzlich Altersgruppen-Filter:
Schritt 1: Vorlage (optional)
- Wähle eine der zentral verwalteten Vorlagen oder schreib frei
Schritt 2: Empfänger filtern
- Audience: Eltern / Spieler / Beide
- Altersgruppe (neu!): Optional
- Keine Altersgrenze → alle Spieler
- Von/Bis: z.B. 10–14 Jahre → nur diese Altersgruppe
- Die App berechnet Live-Zähler: wie viele Empfänger betroffen sind
Beispiel: Du stellst „Alter von 6, Alter bis 12" ein → nur Bambini-Spieler mit Eltern erhalten die Nachricht.
Schritt 3: Betreff & Text
- Notwendige Felder — Text mit oder ohne Platzhalter
Schritt 4: Versenden
- ✉️ Senden klicken
- Die App versendet Push-Benachrichtigungen an alle Empfänger
- Mail-Fallback für Spieler ohne Push
- Bestätigung: „Vereinsnachricht an X Empfänger gesendet"
Wichtig: DSGVO bei Push-Notifications
⚠️ Datenschutz-Hinweis:
Push-Benachrichtigungen setzen voraus, dass:
- Eltern/Spieler die App als PWA installiert haben (Home Screen auf iPhone/Android)
- Push-Berechtigung am Gerät erteilt haben (Pop-up beim ersten Besuch)
Falls Push nicht verfügbar/deaktiviert ist → Fallback auf E-Mail (automatisch).
Dokumentiere, dass Vereinsnachrichten per Push + Mail versendet werden (für DSGVO-Compliance).
15. Eltern-Portal & Spiele-Synchronisation
Das Eltern-Portal wurde erheblich erweitert. Eltern sehen jetzt ihre Spiele und Trainings direkt im Dashboard und können diese als iCalendar (.ics) abonnieren.
Spielplan-Synchronisation zum Dashboard
Neu: Wenn Spiele in der Platzbelegung eingetragen sind, werden diese automatisch im Eltern-Dashboard angezeigt:
Admin → Platzvergabe (oder Spielplan-Sync)
- Alle Spiele mit
mannschaft_idoderfce_team-Kürzel werden automatisch den Eltern gezeigt - Das System filtert nur zukünftige Spiele (bis 30.06. Saisonende)
- Heim/Auswärts-Unterscheidung: Automatisch erkannt (basierend auf
is_heim-Flag) - Daten: Gegner, Uhrzeit, Platz, Adresse (von Platz-Verwaltung)
Trainingszeiträume anzeigen
Trainings werden aus der Trainingszeiten-Tabelle pro Mannschaft angezeigt:
Trainer → Mannschaftsseite → Trainingszeiten verwalten
- Wochentag & Uhrzeit: Werden expandiert (z.B. jeden Montag 18:00 Uhr)
- Gültig von / bis: Trainings können zeitlich begrenzt sein (z.B. nur Winter)
- Platz: Wird in der Eltern-Ansicht mit Maps-Link angezeigt
iCal-Abo für Eltern
Neu: Eltern können ihre Spiele & Trainings direkt ins Handy-Kalender importieren:
- Im Eltern-Dashboard unter „Kalender-Abo"
- Eltern wählen: Spiele + Training / Nur Spiele / Nur Training
- URL oder QR-Code → in Handy-Kalender einfügen
- Automatische Updates alle 2 Stunden
Technisch:
- iCal-Feed unter:
/kalender/<token>.ics - Eltern-spezifisch (per Session-Token)
- Standard iCalendar-Format (RFC 5545)
Zugriff überwachen
Admin → Übersicht → Eltern-Portal Status
Sie sehen:
- Wie viele Einladungslinks aktiv sind
- Wie viele Eltern sich angemeldet haben
- Letzte Aktivitäten
- Neu: Wie viele iCal-Abos aktiv sind
Multi-Kind-Konsolidierung (automatisch)
Wichtig: Das System erkennt automatisch, wenn mehrere Kinder die gleiche E-Mail-Adresse verwenden und konsolidiert sie zu einem Account:
- Trainer schickt Einladungslink für Kind 1
- Eltern registrieren sich mit E-Mail xyz@example.com
- Trainer schickt späteren Einladungslink für Kind 2 (gleiche Familie, gleiche E-Mail)
- Portal erkennt: E-Mail ist bereits da → Kind 2 wird automatisch hinzugefügt
- Eltern sehen im nächsten Login: „Meine Kinder (2)" mit separaten Karten
Voraussetzung: Beide Einladungslinks müssen die gleiche E-Mail-Adresse haben. Das funktioniert am besten, wenn der Trainer beide Kinder in der Eltern-Registrierung hinterlegt.
Einladungslinks verwalten
Admin → Mannschaftseinladungen (oder über Mannschaftsseite)
- Link generieren – für eine oder mehrere Mannschaften
- Link zurückziehen – Deaktivieren wenn nicht mehr nötig
- Zielgruppe: Ist standardmäßig auf alle Spieler einer Mannschaft
16. Spieler-Accounts verwalten
Neu: Eine zentrale Übersicht für alle Spieler, die einen Elternteil-Account oder Spieler-Selbst-Account haben.
Admin → Spieler-Accounts (falls sichtbar)
Was Sie sehen
Eine Tabelle mit:
- Spieler-Name – Link zur Spielerseite
- Mannschaft(en) – In welchen Teams der Spieler aktiv ist
- Elternteil-Accounts – E-Mail(s) der Eltern, die diesem Kind zugeordnet sind
- Spieler-Selbst-Account – Falls der Spieler selbst angemeldet ist (ältere Jugendliche)
- Status – Aktiv / Inaktiv / Gelöscht
- Letzter Login – Wann hatte der Elternteil/Spieler zuletzt Zugriff
Funktionen
Konto-Übersicht
- Klick auf eine Zeile → Detailseite des Spielers mit allen verknüpften Konten
- Sehen Sie alle E-Mail-Adressen, über die man sich anmelden kann
Probleme beheben
- Doppelte Accounts: Zeigt an, wenn mehrere Eltern-Konten für denselben Spieler existieren
- Verwaiste Konten: Spieler ohne Elternteil-Account (selbst angemeldet? vergessen?)
- E-Mail-Duplikate: Warnung wenn mehrere Spieler die gleiche Eltern-Mail haben (sollte nicht passieren)
Aktionen
- Konto verknüpfen – Falls zwei Spieler-Konten zusammengehören
- Konto trennen – Falls Eltern sich unterscheiden
- Account deaktivieren – Eltern/Spieler kann sich nicht mehr anmelden (Daten bleiben erhalten)
17. Test-Mannschaften & Beta-Features
Neu: Admins können Mannschaften als Test-Mannschaften markieren.
Was ist eine Test-Mannschaft?
Eine Mannschaft, die nicht im öffentlichen Anmelde-Wizard angezeigt wird:
- Ideal für: Interne Tests, Trainingsteams, versteckte Mannschaften
- Sichtbar für: Nur Admin & Superuser
- Auswirkung: Eltern, die sich im Standalone-Wizard anmelden, sehen diese Mannschaft nicht
Test-Mannschaft aktivieren
- Gehe zu Admin → Mannschaftsverwaltung
- Wähle die Mannschaft
- Im Mannschafts-Detail-Formular: Checkbox „Test-Mannschaft" aktivieren
- Speichern
Die Mannschaft ist jetzt versteckt aus:
- Öffentlichem Anmelde-Wizard (https://fce.hoffknecht.de)
- Eltern-Dashboard für neue Benutzer
- Öffentlichen Listen
Aber sichtbar für:
- Trainer dieser Mannschaft (normal)
- Admins (überall)
- Existierenden Eltern (im Dashboard, wenn ihr Kind dort ist)
Beta-Features verwalten
Admin → Module verwalten
Für einzelne Mannschaften oder Trainer können Sie Beta-Funktionen testen:
- Beta-Flag setzen → Funktion zeigt „⚠️ BETA" im Menü
- Alle aktivieren → Schaltet Feature für berechtigte Trainer ein
- Pro Trainer: Feature kann selektiv für einzelne Trainer aktiviert/deaktiviert werden
18. SMTP-Konten & Mail-Rollen
Admin → Vereins-Einstellungen → SMTP-Konten
Rollen erweitert (Issue #37)
Jedes Mail-Konto kann eine spezifische Rolle haben, die steuert, welche automatischen E-Mails über dieses Postfach versendet werden:
| Rolle | Verwendung |
|-------|-----------|
| Passwesen | Neuanmeldungs-Benachrichtigungen an Trainer |
| Platzvergabe | Platzanfrage-Mails, Spielplan-Updates |
| Abmeldungen | Abmelde-Workflow-E-Mails (NEU) |
| Spielverlegung | Verlegungsmitteilungen (NEU) |
| Vorstand | Allgemeine Vereins-Kommunikation |
| Kasse / Buchhaltung | Finanzielle Mitteilungen |
So richten Sie ein Mail-Konto mit Rolle ein
- SMTP-Konto hinzufügen oder bearbeiten
- Im Feld Rolle die gewünschte Funktion auswählen
- Speichern
Hinweis: Pro Rolle darf es nur ein aktives Konto geben. Falls Sie ein zweites Konto für die gleiche Rolle setzen, wird das vorherige Konto automatisch aktualisiert.
Mail-Sync aktivieren
Kontrollkästchen „Eingehende Mails dieses Postfachs als Todos importieren" aktivieren, wenn:
- Trainer oder Eltern E-Mails an dieses Postfach senden sollen
- Die App eingehende Mails als Aufgaben/Tickets erfassen soll
Beispiel: Das Passwesen-Konto empfängt Fragen von Eltern zu Neuanmeldungen — diese werden als Todos gelistet.
19. Tickets-Übersicht
Admin → System → Tickets oder direkt /tickets
Neues Standard-Filter (Issue #27)
Die Tickets-Liste zeigt standardmäßig nur offene Tickets. Das reduziert das Chaos und konzentriert auf aktuelle Aufgaben.
Status einer Neuanmeldungen im Ticket-Workflow:
offen– neue oder beantwortete Tickets, noch nicht bearbeitetbeantwortet– Admin hat geantwortet, wartet auf Feedbackerledigt– abgeschlossen, in die Historie verschobenarchiviert– alte Tickets, nicht mehr relevant
Alle Status anzeigen
Um alle Tickets unabhängig vom Status zu sehen, nutzen Sie den Filter:
- Button „Alle Status" oben in der Filter-Leiste klicken, oder
- URL-Parameter:
?status=alle
So können Sie historische Tickets suchen oder abgeschlossene Fälle nochmal ansehen.
Tickets als Admin bearbeiten
- Ticket öffnen
- Antwortet der Admin, wird Status →
beantwortetgesetzt - Trainer/Nutzer können replizieren
- Wenn erledigt: Status → erledigt setzen
- Ticket verbleibt in der Liste, kann aber später sortiert/archiviert werden
20. Trainer-Anleitungen verwalten
Admin → Vereinsverwaltung → Trainer-Anleitungen oder direkt /admin/anleitungen
Neue Funktion (Issue #13)
Trainer können zentral Anleitungen, Vorlagen und Regelwerke hochladen und verwalten. Alle Trainer sehen diese Dokumente unter Anleitungen in der Kopfleiste (oder Anleitungen im mobilen Drawer).
Dokument hochladen
- Auf der Seite + Neue Anleitung hochladen klicken
- Felder ausfüllen:
- Titel (z.B. „Rahmenspielplan U13") — Pflichtfeld
- Kategorie (z.B. „Rahmenspielplan", „Anleitung", „Vorlage") — Optional, wird gruppiert angezeigt
- Beschreibung — Optional, kurze Erklärung des Inhalts
- Datei — PDF, DOCX, XLS oder andere (Pflichtfeld)
- Sortierung — Zahlenwert (niedriger = oben in der Liste)
- Hochladen klicken
Die Datei wird im System abgelegt und sofort allen Trainern zugänglich.
Dokumente verwalten
Bestehende Dokumente sind in Kategorien gruppiert. Jedes Dokument hat:
- Titel & Beschreibung – sichtbar für Trainer
- Download-Button – Trainer können sofort herunterladen
- Bearbeitungs-Formular (unter Details) – Titel, Kategorie, Beschreibung, Sortierung ändern
- Löschen-Button – ⚠️ Datei wird unwiederbringlich gelöscht
Hinweis: Die Änderungen an Metadaten sind sofort sichtbar. Wenn Sie Titel ändern, sehen Trainer beim nächsten Laden die neue Bezeichnung.
Trainer-Sicht
Trainer sehen die Anleitungen unter:
- Navigation: Oben in der Kopfleiste das 📚-Icon „Anleitungen"
- Mobile: Im Drawer (Hamburger-Menü) unter „Anleitungen"
Dokumente sind nach Kategorie gruppiert und sortierbar. Trainer klicken einfach ⬇ Download um die Datei zu speichern.
21. DSGVO Spieler-Unterschriften
Hintergrund
Ab 14 Jahren benötigen Spieler eine eigene Unterschrift unter DSGVO-Erklärungen (Datenschutzerklärung, Einwilligung zu Foto-Veröffentlichung, etc.). Diese Funktion ermöglicht es dir, digitale Unterschriften einzusammeln — ohne dass Spieler in die App eingeloggt sein müssen. Die App speichert Unterschrift, IP-Adresse und Browser-Informationen für Compliance.
Spieler-Unterschrift-Übersicht
Admin → Vereinsverwaltung → DSGVO Spieler (oder direkt /admin/dsgvo-spieler)
Diese Seite zeigt alle aktiven Spieler ab 14 Jahren mit ihrem Unterschriftsstatus:
| Spalte | Inhalt |
|--------|--------|
| Name | Vor- und Nachname des Spielers |
| Alter | Berechnet aus Geburtsdatum |
| Mannschaft | Aktuelle Mannschaft |
| Status | ✅ Unterschrieben / ❌ Nicht unterschrieben |
| Datum | Wann wurde unterschrieben (falls ja) |
Filter oben:
- Alle Spieler / Nicht unterschrieben — standardmäßig nur die ohne Unterschrift
- Nach Mannschaft filtern
- Nach Altersgruppe filtern
Erinnerung senden
Wenn ein Spieler noch nicht unterschrieben hat:
- Spieler markieren (Checkbox links) oder einzelnen Spieler auswählen
- "✉️ Erinnern"-Button klicken
- Die App generiert einen einmaligen Magic-Token
- Eine E-Mail wird an den Spieler/Eltern gesendet mit Link zur Signatur-Pad-Seite
Der Link sieht aus wie:
https://dein-verein.de/spieler-signatur/XXXXXXXXXXXX
Der Link ist zeitlich unbegrenzt und funktioniert ohne Login — ideal für Eltern mit kleinen Handy-Hilfskräften.
Signatur-Prozess (Spieler-Sicht)
Der Spieler öffnet den Link:
- Seite zeigt: Name, Mannschaft, DSGVO-Text (oder Bild)
- Signatur-Pad: Großes Feld zum Unterschreiben (mit Handy-Stift oder Touchpad)
- „Speichern"-Button klicken
Die App speichert automatisch:
- ✅ Unterschrift (PNG)
- 🕐 Zeitstempel
- 📍 IP-Adresse
- 🖥️ Browser + Device-Info (UA)
Der Spieler erhält eine Bestätigung: „Unterschrift erfolgreich gespeichert"
Unterschrift revalidieren
Falls eine Unterschrift ungültig ist oder der Spieler noch mal unterschreiben soll:
- Admin-Seite → Spieler auswählen
- "Unterschrift löschen"-Button (oder direkt auf Spieler-Seite)
- Neuer "✉️ Erinnern"-Mail wird versendet
22. Wartelisten verwalten
Hintergrund
Die Wartelisten sind global pro Altersklasse (nicht pro Mannschaft). Wenn Interessenten anmelden, aber keine Plätze frei sind, kommen sie auf die Warteliste. Die Altersklasse wird automatisch aus Geburtsdatum + DFB-Saison berechnet (Stichtag 01.07.).
Wartelisten-Übersicht
Admin → Vereinsverwaltung → Wartelisten (oder direkt /admin/wartelisten)
Die Seite zeigt eine große Tabelle mit allen Kategorien:
| Kategorie | Einträge |
|-----------|----------|
| A | Jahrgang 2010 (U14) |
| B | Jahrgang 2011 (U13) |
| C | Jahrgang 2012 (U12) |
| D | Jahrgang 2013 (U11) |
| E | Jahrgang 2014 (U10) |
| F | Jahrgang 2015 (U9) |
| G | Jahrgang 2016 (U8) |
Klick auf eine Kategorie um die Details-Seite zu öffnen.
Einzelne Wartelisten-Kategorie
Admin → Wartelisten → „A" (oder andere Kategorie)
Hier siehst du:
Liste aller Wartelisten-Einträge:
- Name des Interessenten
- Geburtsdatum
- Kontakt (E-Mail, Telefon)
- Datum der Eintragung
- Status (Aktiv / Übernommen / Storniert)
Oben: Filter nach Status + Sortierungs-Optionen
Neuen Wartelisten-Eintrag hinzufügen
"+ Neuer Eintrag" Button
Felder ausfüllen:
| Feld | Erklärung |
|------|-----------|
| Vorname, Nachname | Spieler-Name (Pflichtfeld) |
| Geburtsdatum | YYYY-MM-DD (Pflichtfeld — bestimmt Altersklasse) |
| E-Mail Eltern | Kontakt für Benachrichtigungen |
| Telefon | Optional, für schnelle Rücksprache |
| Notiz | Spezielle Wünsche, z.B. „Will mit Kumpel zusammen spielen" |
Speichern → Eintrag erscheint sofort auf der Liste.
Von Warteliste zu Neuanmeldung
Wenn ein Platz in einer Mannschaft frei wird:
- Auf der Wartelisten-Seite → „Übernehmen"-Button klicken
- Ein Formular öffnet sich:
- Spieler-Name + Geburtsdatum sind vorausgefüllt
- Du wählst: Welche Mannschaft? (Dropdown, nur Mannschaften der gleichen Altersklasse)
- "Zu Neuanmeldung umwandeln" klicken
Was passiert dann:
- Der Wartelisten-Eintrag wird als
übernommenmarkiert (bleibt in der Historie) - Ein neuer Neuanmeldungs-Eintrag wird erstellt
- Eltern erhalten eine E-Mail: „Dein Kind wurde in der Mannschaft XY angenommen! Hier geht's zur Anmeldung..."
- Der Neuanmeldungs-Workflow läuft normal: Pass-Antrag → Unterlagen → fertig
Wartelisten-Eintrag stornieren
Falls ein Interessent absagt oder nicht mehr interessiert ist:
- „Stornieren"-Button klicken
- Eintrag wird als
storniertmarkiert - Der Spieler wird aus der aktiven Liste ausgeblendet (aber nicht gelöscht — für Archiv)
Saisonwechsel-Vorschau
Feature (noch in Entwicklung): Am Ende einer Saison zeigt die App:
- Welche Spieler wechseln die Altersklasse am 01.07.? (z.B. F → E)
- Empfehlung: Vorausplanung für Trainingsgruppen
23. Werbung & AdSense
Zweck
Mit dieser Funktion können Sie einen Werbe-Slot im Footer einrichten — ideal für AdSense-Codes, Banner-Netzwerke oder Sponsoren-HTML. Nutzer müssen Cookie-Consent erteilen, bevor Werbung angezeigt wird (falls gewünscht).
Konfiguration
Admin → Vereins-Einstellungen → Scrolle zu 📢 Werbung / AdSense
Felder:
- HTML/Snippet: Ihr AdSense-Code oder Custom-Banner-HTML (z.B.
<script async src="..."></script>) - Cookie-Consent erforderlich: Checkbox. Wenn aktiviert:
- Banner erscheint zuerst dunkel mit Cookie-Consent-Frage
- Nutzer muss „Akzeptieren" klicken
- Zustimmung wird in
localStorage['kd_werbung_consent']gespeichert - Werbung wird daraufhin angezeigt
Aktivierung
Das Modul „Werbung / AdSense" ist standardmäßig deaktiviert. So schalten Sie es ein:
- Admin → Module
- Suchen Sie „Werbung / AdSense"
- „Alle aktivieren" klicken
- Der Werbe-Slot wird ab sofort im Footer aller Seiten angezeigt
Demo-Stack
Auf https://demo.kickdesk.de wird automatisch ein Platzhalter-Banner mit kickdesk.de-Promo angezeigt (zur Demonstration).
Hinweise
- Nur Admin sieht das Modul in den Einstellungen; Trainer sehen nichts davon
- JavaScript-Sicherheit: Achten Sie darauf, dass Ihr AdSense/Banner-Code legitim ist (XSS-Risiko!)
- Mobile-Optimierung: Banners sollten responsiv sein (Footer ist auf Handys schmal)
24. Lokale Sponsoren
Zweck
Verwalten Sie Vereins-eigene Sponsoren mit automatischer Banner-Anzeige im Footer und Click-Tracking. Sehen Sie Statistiken: wie oft wurde der Banner angezeigt, wie viele Klicks erhielt er?
Verwaltung öffnen
Admin → Sponsoren (oder direkt /admin/sponsoren)
Hier sehen Sie eine Tabelle aller Sponsoren mit:
- Name
- Aktiv-Status
- Aktueller Stand: Einblendungen / Klicks
- Bearbeitungsoptionen
Neuen Sponsor hinzufügen
+ Neuer Sponsor klicken
Felder ausfüllen:
| Feld | Erklärung |
|------|-----------|
| Name | Firmenname oder Sponsoren-Bezeichnung (Pflichtfeld) |
| Logo/Bild | JPG, PNG (hochladen) – wird im Banner angezeigt |
| Link-URL | Ziel-URL (z.B. https://example.com). Wird angeklickt, leitet die App weiter + zählt den Klick. Optional. |
| Aktiv-von | Startdatum des Sponsoring-Vertrags (YYYY-MM-DD). Optional. |
| Aktiv-bis | Enddatum des Vertrags. Nach diesem Datum wird der Banner nicht mehr angezeigt. Optional. |
| Position | Footer (Standard). Später auch Login oder Sidebar möglich. |
| Sortierung | Zahlenwert (0 = oben). Sponsoren mit kleineren Zahlen stehen vorn. |
| Aktiv | Schalter. Nur aktive Sponsoren werden angezeigt. |
| Notiz | Intern: Vertragsbedingungen, Kontaktperson, etc. |
Speichern.
Statistik & Click-Tracking
Nach dem Speichern sehen Sie in der Sponsors-Liste:
- Einblendungen: Wie oft der Banner im Footer geladen wurde (Auto-Zähler)
- Klicks: Wie oft Nutzer auf den Banner geklickt haben (linke auf die Link-URL)
Jeder Klick auf den Banner wird über /sponsor/<id>/klick registriert und der Nutzer zur Link-URL weitergeleitet.
Sponsor bearbeiten / deaktivieren
- In der Liste „Bearbeiten" klicken
- Felder ändern (z.B. Laufzeit vorbei → Aktiv-bis-Datum setzen)
- Speichern
Oder Schalter auf „Inaktiv" setzen — der Banner wird sofort aus dem Footer entfernt (Statistik bleibt erhalten).
Aktivierung
Das Modul „Lokale Sponsoren" ist standardmäßig deaktiviert:
- Admin → Module
- Suchen Sie „Lokale Sponsoren"
- „Alle aktivieren" klicken
- Alle aktiven Sponsoren werden im Footer angezeigt
Hinweise
- Nur Sponsor-Verwaltung ist Admin-Funktion — Trainer sehen die Sponsoren-Kachel nicht
- Spamschutz: Einblendungs-Counter zählt nicht jeden Page-Load (Cache), aber grobe Trends sind sichtbar
- Mehrere Sponsoren: Falls Sie mehrere haben, werden sie als zentrierte Banner-Reihe im Footer angezeigt
- Vertragsende: Setzen Sie „Aktiv-bis" auf das Enddatum — ab nächstem Tag wird der Banner automatisch ausgeblendet
25. Backups & Datenschutz
Automatische Backups
Die App erstellt automatisch täglich um 02:00 Uhr ein Backup der Datenbank. Es werden die letzten 14 Versionen gespeichert.
Manuelles Backup erstellen
Admin → Backup
- Neues Backup erstellen klicken
- Sofortiges Backup wird erstellt und in die Backup-Liste aufgenommen
- Download ist sofort verfügbar
Backup herunterladen
- Gewünschtes Backup in der Liste auswählen
- Herunterladen klicken
- SQLite-Datenbankdatei wird heruntergeladen
Speichern Sie Backups extern (Cloud, externe Festplatte) zur Disaster-Recovery.
Datenschutz & DSGVO
Die App erfasst:
- Spieler-Personaldaten (Name, Geburt, Adresse)
- Trainer-Kontaktdaten (E-Mail, Telefon)
- Scan-Unterlagen (PDFs, Passdokumente)
Wichtig:
- Nur berechtigte Trainer können persönliche Daten sehen
- Abgemeldete Spieler werden mit
+Prefix markiert (nicht gelöscht) - Alte Saisonendaten können archiviert werden
- Alle Änderungen werden im Audit-Log festgehalten
26. Häufige Fragen
F: Wie setze ich das Passwort eines Trainers zurück?
Admin → Trainerverwaltung → Trainer auswählen → Passwort zurücksetzen
Der Trainer erhält eine E-Mail mit einem Resetlink.
F: Ein Spieler erscheint nicht in der Spielerliste. Warum?
Mögliche Gründe:
- Spieler hat Status
passantrag→ wird automatisch ausgeblendet - Spieler ist deaktiviert oder abgemeldet
- Spieler wurde aus einer anderen Mannschaft zu dieser hinzugefügt, aber noch nicht durch
auto_migrate()aktualisiert
→ Admin → Spieler durchsuchen und Status überprüfen.
F: Kann ich einen Spieler zwischen Mannschaften verschieben (gleiche Saison)?
Ja, über Spieler bearbeiten → Mannschaft ändern. Der alte Trainer erhält automatisch eine E-Mail mit [MID-X]-Tracking-Token.
F: Was passiert, wenn ich eine Mannschaft lösche?
⚠️ Achtung: Alle Spieler, Neuanmeldungen, Spiele und Platzierungen dieser Mannschaft werden unwiederbringlich gelöscht. Nutzen Sie stattdessen Deaktivieren, um die Mannschaft zu archivieren.
F: Wie lange speichert die App alte Daten?
Standard:
- Backup-Archiv: 14 Tage (automatisch gelöscht)
- Audit-Log: 90 Tage
- Abgemeldete Spieler: Unbegrenzt (mit
+Prefix) - Historische Saisonen: Unbegrenzt (schreibgeschützt nach Archivierung)
F: Muss ich beim Saisonwechsel Spieler manuell hochziehen?
Nein. Der Saisonwechsel-Prozess bietet eine optionale Funktion zum automatischen Hochziehen. Sie können Spieler auch manuell verschieben oder neue Spieler für die neue Saison erfassen.
F: Wie überprüfe ich, ob E-Mails versendet werden?
Admin → Übersicht → Kommentare & Notifikationen
Hier sehen Sie alle per imap_poller eingegangenen Antworten mit [KID-X], [MID-X], [NID-X]-Tokens.
F: Wie viele iCal-Abos sind aktiv?
Admin → Übersicht → Eltern-Portal Status
Sie sehen hier auch die Anzahl aktiver iCal-Subscriptions. Falls zu viele aktiv sind, können Sie einzelne deaktivieren (unter Eltern verwalten).
F: Was ist der Unterschied zwischen "Trainer-iCal" und "Eltern-iCal"?
- Trainer-iCal (
/kalender/<trainer_token>.ics) – Der Trainer sieht alle seine Mannschaften & Trainings - Eltern-iCal – Der Elternteil sieht nur die Spiele/Trainings seiner Kinder (pro Kind ein separater Token)
F: Wie stelle ich sicher, dass Eltern ihre Spiele sehen?
- Spiele eintragen: In Platzvergabe (oder Spielplan-Sync von fussball.de) die Spiele anlegen
- Mannschaft-ID zuordnen: Sicherstellen, dass die Platzbelegung die
mannschaft_idhat (nicht nurfce_team) - Eltern einladen: Einladungslink an Eltern schicken
- iCal prüfen: Eltern können im Dashboard die iCal-URL kopieren
Falls Spiele nicht sichtbar sind → Logs checken (siehe Support).
F: Können Eltern mehrere Kinder auf einem Account haben, wenn diese unterschiedliche E-Mails haben?
Nein. Ein Account = eine E-Mail. Falls zwei Kinder unterschiedliche E-Mails haben, brauchen die Eltern zwei Accounts (oder müssen eine E-Mail vereinheitlichen).
Das System erkennt automatisch nur gleiche E-Mail-Adressen und konsolidiert diese.
F: Was passiert mit Test-Mannschaften bei der Saison-Migration?
Test-Mannschaften behalten ihr Flag. Das heißt, auch in der neuen Saison sind sie versteckt. Falls Sie eine Test-Mannschaft öffentlich machen möchten, müssen Sie das Flag manuell entfernen.
Kontakt & Support
Bei Fragen oder Problemen:
📧 E-Mail: martin@hoffknecht.de
🔗 App: https://fcerheine.kickdesk.de
Version: 1.5 | Stand: 11. Mai 2026