Module DE

Module

🌐 English · Deutsch

Der Modul-Manager (/extensions, nur Admin) installiert und verwaltet Module, die MediaForge erweitern — mit eigenen Seiten, Einstellungs-Karten, Sidebar-Links oder Providern. Sidebar-Einträge, die von einem Modul stammen, tragen ein kleines „M“-Badge (Tooltip: „Module: <Name>“), sodass eingebaute Funktionen immer von Modul-Funktionen unterscheidbar bleiben. Die Seite ist vollständig für Mobilgeräte optimiert.

Modul-Store

Der Store ist direkt in die /extensions-Seite integriert: Der Katalog lädt automatisch im Browser, der Button Aktualisieren umgeht den ~15-Minuten-Cache. Die Store-URL und die vertrauenswürdigen Signaturschlüssel sind fest in den Build kompiliert und lassen sich nicht über die Oberfläche ändern (nur lesend angezeigt). Admins können jedoch zusätzliche Repository-URLs hinterlegen — eine http(s)-URL pro Zeile.

Vertrauensstufen

Die Vertrauensstufe wird durch kryptografische Signaturprüfung bestimmt — nicht durch die Angabe im Store-Index:

Stufe	Bedeutung
Official	Mit dem Schlüssel des MediaForge-Teams signiert
Verified	Drittanbieter-Code, der von einem Maintainer geprüft, neu paketiert und signiert wurde
Unverified	Unsigniert, mit unbekanntem Schlüssel signiert oder nach dem Signieren verändert

Zusätzlich markiert ein Unreviewed-Badge Einreichungen, die noch niemand gelesen hat. Unverifizierte und ungeprüfte Module sind standardmäßig ausgeblendet und erscheinen erst, wenn der Schalter „Unverifizierte und ungeprüfte Module erlauben“ aktiviert ist.

⚠️ Ein Modul läuft innerhalb von MediaForge mit vollem Zugriff auf deine Daten. Aktiviere unverifizierte/ungeprüfte Module nur, wenn du der Quelle vertraust.

Installation und Updates

• Das Paket wird zunächst in einen Staging-Bereich heruntergeladen und dort signaturgeprüft — Pakete, die die Prüfung nicht bestehen, erreichen den Live-Ordner nie.
• Neue Module gehen sofort, ohne Neustart live: Blueprint, Einstellungs-Karte, Sidebar-Einträge und Übersetzungen stehen ab der nächsten Anfrage bereit.
• Ein Upgrade eines bereits geladenen Moduls bleibt im Staging und zeigt ein Banner „Neustart erforderlich“; die Oberfläche bietet einen eingebauten Selbst-Neustart.

Abhängigkeiten

Module können eigene Python-Abhängigkeiten deklarieren. Der Button Abhängigkeit installieren (Admin) installiert ausschließlich die deklarierten Anforderungen von PyPI nach ~/.mediaforge/module_deps/ — MediaForges eigene Abhängigkeiten haben beim Import stets Vorrang. Derselbe Button funktioniert auch für Store-Module vor deren Installation.

Sensible Einstellungen

Module können Einstellungs-Schlüssel deklarieren, deren Werte verschlüsselt in der Datenbank abgelegt werden. Felder vom Typ secret in Einstellungs-Karten werden automatisch verschlüsselt.

Backup

Module können eigene Backup-Kategorien registrieren, die dann im Export/Import-Dialog erscheinen — siehe Backup.