- Plugins nach WordPress-Prinzip: plugin.json-Manifest mit Versions- und Abhängigkeitsprüfung, eigenes PSR-4-Autoloading, register()/boot(), activate()/deactivate()/uninstall(), Migrationen, Routen und Views je Plugin - plugins-core/ (mitgeliefert, aktiv bis zur Deaktivierung) und plugins/ (Kunden-Plugins, geschützt vor Updates, inaktiv bis zur Aktivierung) - Zustand in storage/app/plugins.json – Laden ohne Datenbankabfrage - Wiederherstellungsmodus: Ausnahmen und Fatal Errors beim Laden deaktivieren das Plugin, das Portal bleibt erreichbar - Hooks (Actions/Filter mit Prioritäten) und Registries für Navigation, Startseiten-Kacheln, Rechte und Admin-Seiten (Filament-Discovery) - Admin-Seite „Plugins“: aktivieren, deaktivieren, per ZIP installieren (ZIP-Slip-Schutz), löschen mit oder ohne Daten; abschaltbar per INHAUS_DISALLOW_FILE_MODS - Startseite komplett aus Kacheln; Plugin-Seiten als „slug::Seite“ - Version 0.3.0 Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
87 lines
2.9 KiB
PHP
87 lines
2.9 KiB
PHP
<?php
|
||
|
||
namespace App\Support;
|
||
|
||
/**
|
||
* Registry der Rechte (Abilities). Kern und Plugins melden hier an, welche
|
||
* Rechte es gibt – das Rollen-Formular und der Rechte-Prüfer bauen darauf auf.
|
||
*
|
||
* Globale Rechte gelten überall („Benutzer verwalten“). Objekt-Rechte gelten für
|
||
* einzelne Objekte eines Typs („Beiträge schreiben in Kategorie MAV-Info“).
|
||
*/
|
||
class Abilities
|
||
{
|
||
/** @var array<string, array{label: string, group: string, resource: string|null}> */
|
||
private array $abilities = [];
|
||
|
||
/** @var array<string, array{label: string, options: callable}> */
|
||
private array $resourceTypes = [];
|
||
|
||
public function __construct()
|
||
{
|
||
$this->define('admin.access', 'Administrationsbereich öffnen', 'System');
|
||
$this->define('users.manage', 'Benutzer verwalten', 'System');
|
||
$this->define('roles.manage', 'Rollen und Rechte verwalten', 'System');
|
||
$this->define('plugins.manage', 'Plugins verwalten und installieren', 'System');
|
||
$this->define('appearance.manage', 'Erscheinungsbild und Schnellzugriffe', 'System');
|
||
$this->define('updates.manage', 'Aktualisierungen, Lizenz und Systemzustand', 'System');
|
||
$this->define('feedback.send', 'Rückmeldungen an den Hersteller senden', 'System');
|
||
}
|
||
|
||
public function define(string $ability, string $label, string $group, ?string $resource = null): void
|
||
{
|
||
$this->abilities[$ability] = ['label' => $label, 'group' => $group, 'resource' => $resource];
|
||
}
|
||
|
||
/**
|
||
* Objekttyp, auf den sich Rechte beziehen können (z. B. „news_category“).
|
||
*
|
||
* @param callable(): array<int|string, string> $options ID => Bezeichnung
|
||
*/
|
||
public function resourceType(string $type, string $label, callable $options): void
|
||
{
|
||
$this->resourceTypes[$type] = ['label' => $label, 'options' => $options];
|
||
}
|
||
|
||
/**
|
||
* @return array<string, array{label: string, group: string, resource: string|null}>
|
||
*/
|
||
public function all(): array
|
||
{
|
||
return $this->abilities;
|
||
}
|
||
|
||
/**
|
||
* @return array<string, array{label: string, group: string, resource: string|null}>
|
||
*/
|
||
public function global(): array
|
||
{
|
||
return array_filter($this->abilities, fn (array $a) => $a['resource'] === null);
|
||
}
|
||
|
||
/**
|
||
* @return array<string, array{label: string, group: string, resource: string|null}>
|
||
*/
|
||
public function forResource(string $type): array
|
||
{
|
||
return array_filter($this->abilities, fn (array $a) => $a['resource'] === $type);
|
||
}
|
||
|
||
/**
|
||
* @return array<string, array{label: string, options: callable}>
|
||
*/
|
||
public function resourceTypes(): array
|
||
{
|
||
return $this->resourceTypes;
|
||
}
|
||
|
||
public function exists(string $ability): bool
|
||
{
|
||
return isset($this->abilities[$ability]);
|
||
}
|
||
|
||
public function label(string $ability): string
|
||
{
|
||
return $this->abilities[$ability]['label'] ?? $ability;
|
||
}
|
||
}
|