Admidio Anforderungen-Plugin — Wiederkehrende Anforderungen und die Aktivitäten, die sie erfüllen, verfolgen

Plugin für Admidio 6.0 und neuer, das wiederkehrende Anforderungen verfolgt, die Mitglieder erfüllen müssen – etwa Weiterbildung (CPD), Sicherheitsschulungen, regelmäßige Zertifizierungen oder Prüfungen – sowie die Aktivitäten (Kurse, Seminare, Prüfungen), die dafür zählen.

Mitglieder erfassen ihre Aktivitäten und die Punkte, die jede einbringt. Für den laufenden und die früheren Zeiträume zeigt das Plugin, ob die Anforderungen erfüllt sind, die für ihre Rollen gelten. Prüfer kontrollieren das Angegebene und können die anerkannten Punkte korrigieren.

Gehe als Administrator zum Plugin-Manager von Admidio (Admidio 6.0 oder neuer und PHP 8.2 oder neuer erforderlich), wähle „Plugin hinzufügen“, lade die Plugin-ZIP-Datei hoch und aktiviere das Plugin. Die Tabellen werden bei der Installation angelegt. Beim Deinstallieren werden die Einstellungen entfernt, auf Wunsch auch die Tabellen. Das Plugin hat einen eigenen Menüpunkt; seine Texte gibt es auf Deutsch und Englisch.

• Anbieter: die Organisationen, die Schulungen anbieten. Eine Aktivität behält den Namen des Anbieters, auch wenn dieser später gelöscht wird.
• Aktivitäten: Ein Mitglied erfasst einen Kurs, ein Seminar oder eine Prüfung mit Terminen, Ort, Teilnahme, Link und Anmerkungen. Eine Aktivität ist ein Entwurf, bis das Mitglied sie zur Prüfung einreicht; eine eingereichte Aktivität kann zurückgezogen werden. Ein normales Mitglied sieht nur seine eigenen Aktivitäten.
• Punkte: Eine Aktivität kann Punkte für mehrere Anforderungen einbringen, zum Beispiel 6 CPD- und 3 Sicherheitspunkte, jeweils einem Zeitraum zugeordnet. Der von einem Prüfer anerkannte Wert überschreibt den angegebenen; ein anerkannter Wert von 0 bedeutet daher „nichts anerkannt“.
• Anforderungsarten: ein Name, eine Beschreibung und ein Zeitraum: eine Anzahl von Kalendereinheiten (Jahr, Quartal, Monat oder Woche) oder ein Zeitraum, der nach der letzten Erfüllung wiederkehrt. Qualifiziert sich ein Mitglied über mehrere Rollen, legt die Anforderungsart fest, ob die höchste, die niedrigste oder die Summe der Rollenverpflichtungen gilt.
• Rollenregeln: die Punkte, die eine Rolle für eine Anforderungsart erreichen muss, mit optionalen Gültigkeitsdaten, damit eine geänderte Anforderung nicht für ältere Zeiträume gilt. Eine Regel verlangt entweder den vollen Betrag oder einen anteiligen Betrag entsprechend der Mitgliedschaft, gerechnet nach Monat, Woche oder Tag. Frühere Zeiträume verwenden die historischen Rollenmitgliedschaften von Admidio.
• Anforderungsseite: eine Seite für die Anforderungen der Organisation und die eigenen des Mitglieds. Administratoren legen dort die Anforderungen und Rollenregeln der Organisation fest; ein Mitglied sieht schreibgeschützt jene, die für es über seine aktuellen Rollen gelten.
• Eigene Anforderungen und eigene Ziele: Jedes Mitglied kann eigene Anforderungen definieren, zum Beispiel die Schulungspflicht seines Arbeitgebers, mit Ziel und Beginn der Gültigkeit. Ein Mitglied kann auch ein eigenes Ziel für eine Anforderung der Organisation festlegen, die keine seiner Rollen vorsieht. Beides wird wie die Anforderungen der Organisation berechnet und erscheint in der Übersicht des Mitglieds. Andere Mitglieder sehen sie nie, Administratoren nur als Punkte bei den Aktivitäten des Mitglieds, und die Prüfung sowie die Kommandozeile lassen sie aus.
• Erfüllungsübersicht: oberhalb der Aktivitätenliste für jede geltende Anforderung die erreichten Punkte im Verhältnis zu den geforderten, für den laufenden und eine einstellbare Anzahl früherer Zeiträume, mit Schaltflächen zum Zurückblättern. Eine Anforderung, die nach der letzten Erfüllung wiederkehrt, zeigt jede Erneuerung als das Zeitfenster, in dem sie gültig ist. Dieselbe Übersicht gibt es als Widget der Übersichtsseite, mit eigener Einstellung, wer es sieht und wie viele frühere Zeiträume es zeigt.
• Administrative Prüfung: je Anforderung und Zeitraum die Abdeckung jedes Mitglieds, mit direkt bearbeitbaren anerkannten Punkten (nur Administratoren).
• Import: Ein Assistent liest eine CSV- oder Tabellendatei mit Aktivitäten und deren Punkten ein (Datei, Spaltenzuordnung, Vorschau, Import, Ergebnis). Bereits früher importierte Zeilen werden erkannt und übersprungen.
• Nachweisdateien: Optional hängen Mitglieder das erhaltene Zertifikat an eine Aktivität an. Die Dateien werden unterhalb von adm_my_files/ gespeichert und können nur über das Plugin gelesen werden, das die Berechtigung prüft.
• Änderungshistorie: Alle Tabellen schreiben in die Änderungshistorie von Admidio.
• Kommandozeile: Alles Obige steht auch als Befehle admidio requirements:… zur Verfügung (Anbieter, Aktivitäten, Punkte, Nachweisdateien, Anforderungsarten, Rollenregeln, report und import). Der Import meldet nur, was geschehen würde, solange –commit nicht angegeben ist.

Administration → Einstellungen → Inhalt → Anforderungen

Das Plugin verwendet die Tabellen req_providers, req_activities, req_requirement_types, req_requirement_role_rules, req_activity_credits und req_activity_files mit dem Tabellenpräfix der Installation.

Der Quellcode ist auf GitHub verfügbar.