Changeset 3748373 for dienstplan/trunk/docs/hooks-reference.md

Timestamp:

10/15/2026 11:59:50 AM (2 days ago)

Author:

wpdienstplan

Message:

Update to version 3.10.0 from GitHub

File:

• dienstplan/trunk/docs/hooks-reference.md (modified) (5 diffs)

dienstplan/trunk/docs/hooks-reference.md

@@ -1 +1 @@
 # Hook-Referenz — WP Dienstplan
 
-**Stand:** 2026-06-01 (Mengen-Limits entfernt; Gruppen-Storage + Access-Control nach Premium)
+**Stand:** 2026-10-15 (Schichtleiter-Filter #187; Mengen-Limits entfernt; Gruppen-Storage + Access-Control nach Premium)
 
 Diese Datei listet alle WordPress-Hooks (Filter und Actions), die das
@@ -53 +53 @@
 ### `dienstplan_assignable_members`
 
-**Default:** alle Nutzer mit `dienstplan_member` / `dienstplan_admin`
+**Default:** alle Nutzer mit `dienstplan_member` / `dienstplan_shift_leader` / `dienstplan_admin`
 **Parameter:** `array $members`, `int $planId`, `array $shiftTypes`
 **Gefeuert in:** `CalendarShortcode::loadMembers()`
 
-Free zeigt in der Admin-Zuweisen-Liste alle Dienstplan-Rollen. Premium
+Free zeigt in der Zuweisen-Liste alle Dienstplan-Rollen. Premium
 reduziert die Liste bei gruppenbeschränkten Plänen auf Nutzer, die einer
 der Plan-Gruppen angehören. Pläne ohne Gruppen-Zuordnung bleiben unverändert
 (alle Mitglieder).
+
+### `dienstplan_user_assignable_to_plan`
+
+**Default:** `true`
+**Parameter:** `bool $assignable`, `int $userId`, `int $planId`
+**Gefeuert in:** `ShiftController::handleAdminSignup()`
+
+Serverseitige Entsprechung zu `dienstplan_assignable_members` für einen
+einzelnen Nutzer. Free: immer `true`. Premium: gleiche Plan-Gruppen-Logik
+wie das Dropdown (gemeinsame Methode in `GroupIntegration`). Gilt für
+Admin und Schichtleiter.
+
+### `dienstplan_user_can_manage_plan`
+
+**Default:** `false`
+**Parameter:** `bool $allowed`, `int $userId`, `int $planId`
+**Gefeuert in:** `Roles::userCanManagePlan()` (nur wenn der Nutzer `dienstplan_lead` hat und kein `dienstplan_manage`)
+
+Ob ein Schichtleiter den angegebenen Plan verwalten darf (Belegung,
+Schichtvorlagen). Free liefert immer `false` (Fail-Closed) — die Rolle
+`dienstplan_shift_leader` verhält sich dann wie ein Mitglied. Premium
+gibt `true`, wenn Feature Schichtleiter aktiv ist und der Nutzer dem Plan
+in `dienstplan_plan_leaders` zugeordnet ist. Admins werden vor dem Filter
+durchgelassen.
+
+### `dienstplan_managed_plan_ids`
+
+**Default:** `[]`
+**Parameter:** `array $planIds`, `int $userId`
+**Gefeuert in:** `Roles::managedPlanIds()` (nur wenn der Nutzer kein `dienstplan_manage` hat)
+
+Liste der Plan-IDs, die der Nutzer verwalten darf. Free: leeres Array.
+Premium: IDs aus `plan_leaders` für den Nutzer (bei inaktivem Feature `[]`).
+`Roles::managedPlanIds()` gibt für Admins `null` zurück (= alle Pläne)
+ohne den Filter zu befragen; der Filter liefert nur die eingeschränkte
+Menge für Schichtleiter.
+
+### `dienstplan_user_can_manage_event`
+
+**Default:** `false`
+**Parameter:** `bool $allowed`, `int $userId`, `int $eventId`
+**Gefeuert in:** `Roles::userCanManageEvent()` (nur bei `dienstplan_lead` ohne `dienstplan_manage`)
+
+Ob ein Schichtleiter den Termin verwalten darf. Free: immer `false`.
+Premium: `true`, wenn der Termin mindestens einem Plan zugeordnet ist und
+**alle** zugeordneten Pläne vom Nutzer geleitet werden. Globale Termine
+(keine Plan-Zuordnung) bleiben Admin-Sache.
+
+### `dienstplan_event_visible_in_plan`
+
+**Default:** `true`
+**Parameter:** `bool $visible`, `int $eventId`, `int $planId`
+**Gefeuert in:** `EventCalendarService::getForRange()` (wenn `$planId > 0`)
+
+Steuert, ob ein Termin im Schichtkalender eines konkreten Plans erscheint.
+Free: immer `true` (alle Termine in allen Plänen). Premium: Termine mit
+Plan-Zuordnung nur in diesen Plänen; ohne Zuordnung (= global) überall.
+
+Action `dienstplan_event_form_plan_fields( ?array $editEvent )` im
+Termin-Modal: Premium rendert die Mehrfachauswahl „Erscheint in Dienstplänen“.
+
+### `dienstplan_plan_modal_fields` / `dienstplan_plan_saved`
+
+**Action** `dienstplan_plan_modal_fields( ?array $plan )` — zusätzliches Feld
+im Plan-Modal (Premium: Schichtleiter-Combobox). `$plan` ist im Create-Markup
+`null`; Auswahl beim Bearbeiten setzt JS über `data-leaders`.
+
+**Action** `dienstplan_plan_saved( int $planId, array $post )` — nach Create/
+Update in `PlanAdminController::handlePlanForm`. Premium speichert
+`leader_ids[]` via `PlanLeaderRepository::setLeadersForPlan()`.
+
+### `dienstplan_calendar_plan_meta`
+
+**Action** `dienstplan_calendar_plan_meta( int $planId, int $userId )`
+**Gefeuert in:** `week-calendar.php`, `month-calendar.php` (unter den Plan-Tabs)
+
+Premium rendert den Kontaktblock „Schichtleitung“ (Name, `mailto:`, optional
+`tel:`). Ohne zugeordnete Leiter: kein Output.
+
+### `dienstplan_leader_phone`
+
+**Default:** User-Meta `dienstplan_phone`
+**Parameter:** `string $phone`, `int $userId`
+
+Erlaubt Sites mit bestehendem Telefonfeld (z. B. WooCommerce `billing_phone`),
+einen Wert für die Schichtleitungs-Anzeige zu liefern.
+
+### `dienstplan_plan_leader_ids`
+
+**Default:** `[]`
+**Parameter:** `array $ids`, `int $planId`
+
+User-IDs der Leiter eines Plans (für `data-leaders` am Rename-Button).
 
 ### `dienstplan_feature_enabled`
@@ -89 +182 @@
 | `FEATURE_AUDIT_LOG`                | `audit_log`           | Pro               |
 | `FEATURE_STATISTICS`               | `statistics`          | Pro               |
+| `FEATURE_MULTIPLE_PLANS`           | `multiple_plans`      | Basis             |
+| `FEATURE_SHIFT_LEADERS`            | `shift_leaders`       | Basis             |
 | `FEATURE_SHIFT_TRADE`              | `shift_trade`         | Basis             |
 | `FEATURE_WEEKDAY_RESTRICTION`      | `weekday_restriction` | Basis             |
@@ -403 +498 @@
 `$_POST['dienstplan_statistik_plans']`). Free invalidiert danach zentral den
 Statistik-Cache.
+
+### `dienstplan_shift_type_saved`
+
+**Parameter:** `int $typeId`, `array $post`
+**Gefeuert in:** `AdminPages::handleShiftTypeForm()` (create/update)
+
+Nach Speichern einer Schichtvorlage. Premium synchronisiert Gruppen und
+Angebotsfelder nur, wenn die jeweiligen Schlüssel im `$post` stehen
+(`group_ids` / `group_ids_present`, `weekdays_mask`, …).
+
+### `dienstplan_shift_type_toggled`
+
+**Parameter:** `int $typeId`, `bool $active`
+**Gefeuert in:** `AdminPages::handleShiftTypeToggle()`
+
+Nach Aktivieren/Deaktivieren. Bewusst **nicht** `dienstplan_shift_type_saved`
+mit leerem POST — das würde Qualifikationen und Wochentagsmaske zurücksetzen.
 
 ### `dienstplan_shift_type_deleted`
@@ -511 +623 @@
   Action-Namen auf Plugin-Slug-Präfix umgestellt; behebt 40 Plugin-Check-
   Findings `WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound`).
+- Issue #187 — Schichtleiter-Rolle: Filter `dienstplan_user_can_manage_plan`,
+  `dienstplan_managed_plan_ids`, `dienstplan_user_can_manage_event`,
+  `dienstplan_user_assignable_to_plan`, `dienstplan_event_visible_in_plan`
+  (Free-Naht; Premium liefert die Plan-Zuordnung).