Fehlerbehebung

Das FUNCKGROUP-Menü erscheint nicht

Mögliche Ursache

• includes/fg-core/bootstrap.php wurde nicht geladen.
• Das Core-Manifest fehlt oder ist ungültig.
• Der ausgewählte Runtime-Einstieg ist nicht lesbar.
• Die erforderliche Capability für das Hauptmenü fehlt.

Lösung

1. Prüfen, ob includes/fg-core/bootstrap.php und includes/fg-core/manifest.php vorhanden und lesbar sind.
2. Prüfen, ob die PHP-Version mindestens der Anforderung des Manifests entspricht.
3. Prüfen, ob der aktuelle Benutzer standardmäßig manage_options besitzt oder ob fg_core_parent_capability verändert wurde.

Prüfung

Nach erfolgreichem Bootstrap erscheint im WordPress-Admin das Menü FUNCKGROUP.

Ein Plugin erscheint nicht unter FUNCKGROUP

Mögliche Ursache

Die Registrierung wurde von FG Core abgelehnt. Das geschieht unter anderem, wenn der slug leer ist oder weder ein gültig definierter Seiten-Callback noch mindestens ein gültiger Tab vorhanden ist.

Lösung

Die Rückgabe von fg_core_register_plugin() prüfen und sicherstellen, dass slug sowie callback oder tabs korrekt gesetzt sind.

Prüfung

fg_core_register_plugin() gibt true zurück, und das Plugin erscheint für berechtigte Benutzer im Untermenü.

Ein Tab fehlt

Mögliche Ursache

• der Tab besitzt keinen gültigen Slug
• der Callback ist nicht gültig definiert
• die Tab-Capability fehlt dem aktuellen Benutzer

Lösung

Tab-Schlüssel, Callback-Definition und optionale capability prüfen.

Prüfung

Der Tab erscheint in der Navigation und sein Callback wird beim Aufruf ausgeführt.

Der falsche Standard-Tab wird geöffnet

Mögliche Ursache

default_tab verweist auf keinen nach der Normalisierung vorhandenen Tab.

Lösung

Einen gültigen Tab-Slug als default_tab setzen.

Prüfung

Beim Öffnen der Plugin-Seite ohne tab-Parameter wird der gewünschte Tab aktiv. Ist der Wert ungültig, verwendet FG Core automatisch den ersten gültigen Tab.

Eine andere FG-Core-Version ist aktiv als erwartet

Mögliche Ursache

Mehrere installierte FUNCKGROUP-Plugins liefern unterschiedliche eingebettete Core-Versionen aus. FG Core wählt die höchste verfügbare kompatible Version.

Lösung

Die manifest.php-Dateien der installierten FUNCKGROUP-Plugins vergleichen und eingebettete Core-Versionen bei Bedarf synchronisieren.

Prüfung

Im Referenz-Plugin zeigt der Diagnose-Tab die aktive Version, den Provider und die gefundenen Core-Kandidaten.

Die Statusmeldung wird nicht gesendet

Mögliche Ursache

• FG_CORE_STATUS_REPORTING ist false
• fg_core_status_reporting_enabled liefert false
• der Status-Endpunkt ist leer oder nicht erreichbar
• WP-Cron wird nicht ausgeführt
• der Zielserver antwortet nicht mit HTTP 2xx

Lösung

1. Konfiguration der Statusmeldung prüfen.
2. Erreichbarkeit des Endpunkts aus WordPress prüfen.
3. WP-Cron prüfen.
4. Die FG-Core-Übersicht auf den letzten Fehler kontrollieren.

Prüfung

Nach erfolgreichem Versand enthält fg_core_status_last_report einen sent_at-Zeitstempel und fg_core_status_last_http_code einen 2xx-Statuscode.

Die Statusmeldung zeigt einen HTTP-Fehler

Mögliche Ursache

Der konfigurierte Endpunkt hat mit einem Status außerhalb von 200–299 geantwortet.

Lösung

Endpunkt, Serverantwort und gegebenenfalls die serverseitige Status-API prüfen.

Prüfung

Nach dem nächsten erfolgreichen Versand wird fg_core_status_last_error gelöscht und der neue HTTP-Statuscode gespeichert.

Das Entwicklungs-Sync-Skript findet FG Core nicht

Mögliche Ursache

Keine der unterstützten Quellen enthält bootstrap.php und manifest.php.

Lösung

FG Core über Composer installieren oder FG_CORE_SOURCE auf den Runtime-Ordner setzen:

FG_CORE_SOURCE=/pfad/zu/fg-core/includes/fg-core composer fg-core:sync

Prüfung

Das Skript meldet die synchronisierte FG-Core-Version und den Quell- sowie Zielpfad.