FREIZEIT

Wofür ist das?

FREIZEIT ist das umfangreichste Plugin in Allesda und unterstützt die komplette Organisation von Freizeiten / Camps:

• Events (eine Freizeit / ein Camp im Kalender)
• Teilnehmer (Personen, ggf. mit Custom-Feldern, Import aus CSV)
• Listen (z.B. Anwesenheitsliste, Workshop-Listen, Themenlisten)
• Packlisten mit Kisten und Items (was muss eingepackt werden)
• Einkaufslisten (was muss noch besorgt werden)
• Zelte mit Kartenansicht und Belegung
• ein eigener Kalender mit Kategorien und Drag-&-Drop
• ein Shopping-Modul, ein Schema-Service, einfache User-/Account-Hilfen

Sie wechseln über das Menü und einen Event-Selector zwischen den Events – die meisten Funktionen beziehen sich immer auf das aktuell gewählte Event.

---

Schritt-für-Schritt nach Bereich

A) Events

1. Freizeit → Events (/freizeit/events).
2. Neu: /freizeit/events/new → speichern (POST /freizeit/events/save).
3. Bearbeiten: /freizeit/events/{id}/edit.
4. Aktivieren: POST /freizeit/events/{id}/activate – wählt das Event als aktuell.
5. Löschen: POST /freizeit/events/{id}/delete.

B) Kalender

1. Freizeit → Kalender (/freizeit/kalender).
2. Drag&Drop, Kategorien anlegen, Termin verschieben:

• GET /freizeit/kalender/api/events
• POST /freizeit/kalender/api/events
• POST /freizeit/kalender/api/events/{id}
• POST /freizeit/kalender/api/events/{id}/move
• POST /freizeit/kalender/api/events/{id}/delete
• Kategorien: /freizeit/kalender/api/categories (GET, POST, /{id}, /{id}/delete)

3. Teilnehmer pro Event abrufen:

• GET /freizeit/kalender/api/events/{id}/participants
• GET /freizeit/kalender/api/events/{id}/participant-names

C) Teilnehmer

1. Freizeit → Teilnehmer (/freizeit/teilnehmer).
2. Neu: /freizeit/teilnehmer/new → POST /freizeit/teilnehmer.
3. Bearbeiten: /freizeit/teilnehmer/{id}/edit → POST /freizeit/teilnehmer/{id}.
4. Detail: /freizeit/teilnehmer/{id}.
5. Löschen: POST /freizeit/teilnehmer/{id}/delete.
6. CSV-Import in vier Schritten:
1. GET /freizeit/teilnehmer/import – Startseite
2. POST /freizeit/teilnehmer/import/upload – Datei hochladen
3. GET /freizeit/teilnehmer/import/mapping – Spalten zuordnen
4. POST /freizeit/teilnehmer/import/execute – Import ausführen
5. ggf. GET /freizeit/teilnehmer/import/duplicates und POST .../confirm zur Duplikatbehandlung.

#### Custom-Felder & Pflichtfelder (Admin)

• POST /settings/admin/freizeit/teilnehmer/custom-fields/add
• POST /settings/admin/freizeit/teilnehmer/custom-fields/delete
• POST /settings/admin/freizeit/teilnehmer/required-fields
• POST /settings/admin/freizeit/teilnehmer/table-fields – Spalten in der Tabelle

D) Listen

1. Freizeit → Listen (/freizeit/listen).
2. Liste öffnen: /freizeit/listen/{id}.
3. Teilnehmer hinzufügen / entfernen:

• POST /freizeit/listen/{id}/add
• POST /freizeit/listen/{id}/remove

#### Listen verwalten (Admin)

• GET /settings/admin/freizeit/listen
• POST /settings/admin/freizeit/listen/create – Liste anlegen
• POST /settings/admin/freizeit/listen/rename – umbenennen
• POST /settings/admin/freizeit/listen/delete – löschen

E) Packlisten & Kisten

1. Freizeit → Packlisten (/freizeit/packlisten).
2. Packliste anlegen: POST /freizeit/packlisten/create.
3. Detail einer Packliste: /freizeit/packlisten/{id}.
4. Kisten anlegen / umbenennen / löschen:

• POST /freizeit/packlisten/{id}/kisten/create
• POST /freizeit/packlisten/{packlistId}/kisten/{boxId}/rename
• POST /freizeit/packlisten/{packlistId}/kisten/{boxId}/delete

5. Items in der Kiste:

• POST /freizeit/packlisten/{packlistId}/kisten/{boxId}/items/create
• POST /freizeit/packlisten/{packlistId}/kisten/{boxId}/items/{itemId}/update
• POST /freizeit/packlisten/{packlistId}/kisten/{boxId}/items/{itemId}/delete

6. Abhaken & Drucken:

• POST /freizeit/packlisten/{packlistId}/kisten/{boxId}/check
• GET /freizeit/packlisten/{packlistId}/kisten/{boxId}/print
• GET /freizeit/packlisten/{packlistId}/kisten/{boxId}/items/json (Daten z.B. für Etikettendruck)

#### Vorlagen verwalten (Admin)

• GET /settings/admin/freizeit/packlisten – Vorlagenliste
• Anlegen / Umbenennen / Archivieren / Löschen / Item-Pflege analog zu oben unter /settings/admin/freizeit/packlisten/...

F) Einkaufslisten

1. Freizeit → Einkaufslisten (/freizeit/einkaufslisten).
2. Liste anlegen: POST /freizeit/einkaufslisten/create.
3. Liste öffnen: /freizeit/einkaufslisten/{id}.
4. Items:

• anlegen, ändern, abhaken, löschen – auch als AJAX (-ajax-Endpunkte) für reaktives UI
• alles erledigte aufräumen: POST /freizeit/einkaufslisten/{id}/clear-checked

G) Zelte (Belegungsplanung)

1. Freizeit → Zelte (/freizeit/zelte).
2. Detail eines Zeltes: /freizeit/zelte/{id}.
3. Modus / Belegung pflegen:

• POST /freizeit/zelte/{id}/mode
• POST /freizeit/zelte/{id}/assign-user / unassign-user
• POST /freizeit/zelte/{id}/gender
• POST /freizeit/zelte/{id}/assign / unassign

4. Karte / Layout:

• POST /freizeit/zelte/map/upload – Karte hochladen
• POST /freizeit/zelte/map/delete
• POST /freizeit/zelte/map/position
• POST /freizeit/zelte/map/reset
• POST /freizeit/zelte/map/properties
• POST /freizeit/zelte/map/create

#### Zelte-Stammdaten (Admin)

• GET /settings/admin/freizeit/zelte
• POST /settings/admin/freizeit/zelte/create
• POST /settings/admin/freizeit/zelte/update
• POST /settings/admin/freizeit/zelte/delete

---

Häufige Fragen / Probleme

„Funktion ist nicht da“

• Ein Event muss aktiv sein (Event-Selector). Viele Daten sind eventbezogen.

„Import findet keine Spalten“

• CSV mit korrekter Kopfzeile? UTF-8?
• Im Mapping-Schritt manuell zuordnen.

„Packliste lässt sich nicht drucken“

• Liste muss Items haben.
• Browser-Druckdialog vs. PDF-Druck testen.

„Zelt-Belegung passt nicht“

• Geschlechtsmodus (gender) und Zuweisungen prüfen.
• Bei Konflikten ggf. Belegung zurücksetzen und neu vergeben.

---

Technische URLs (Kurzreferenz, Auszug)

Events: /freizeit/events…
Kalender: /freizeit/kalender…
Teilnehmer: /freizeit/teilnehmer…
Listen: /freizeit/listen… + Admin /settings/admin/freizeit/listen…
Packlisten: /freizeit/packlisten… + Admin /settings/admin/freizeit/packlisten…
Einkaufslisten: /freizeit/einkaufslisten…
Zelte: /freizeit/zelte… + Admin /settings/admin/freizeit/zelte…
Allgemeine Admin-Seite: /settings/admin/freizeit

(Jeweils GET für Anzeige, POST für Aktion. Vollständige Liste siehe Quellcode der *Controller.java Dateien.)

Hinweise

• FREIZEIT ist das größte Plugin und hat viele Unter-Module. Es lohnt sich, Schritt für Schritt zu konfigurieren (zuerst Events anlegen, dann Teilnehmer, dann Listen / Packlisten / Zelte).
• Mehrere Module wirken zusammen: Listen können sich auf Teilnehmer beziehen, Zelte auf Teilnehmer, Packlisten auf Events.
• Die Custom-Felder bei Teilnehmern sind sehr mächtig – legen Sie sie früh an, sonst sind importierte Daten unstrukturiert.