Kapitel 5

WebshopRadar-Plugin

Das WebshopRadar-Plugin ist eine kleine, kostenlose Shopware-6-Erweiterung, die Sie in Ihrem Shop installieren. Es ist optional — für den Grundbetrieb reicht die Shopware-Integration. Wer aber Bulk-Plugin-Updates, Remote-CLI oder erweiterte System-Diagnostik nutzen will, braucht das Plugin.

Wofür wird das Plugin gebraucht?

FeatureMit PluginOhne Plugin
Shop-Status (Plugin-Liste, Version)
PageSpeed-Tests
Uptime-Monitoring
Plugin-Updates (Bulk, sequenziell)
Remote-CLI (cache:clear, plugin:refresh)
Erweiterte System-Diagnostik
Detaillierte Fehler-Logs nach Plugin-Updates

Kurz: Plugin = Plugin-Updates + Diagnostik. Alles andere geht auch ohne.

Auswirkungen auf Ihren Shop

  • Kein Eingriff ins Frontend oder Theme — das Plugin läuft ausschließlich im Admin-Bereich.
  • Kein Page-Rendering-Impact — Frontend-PageSpeed, Time-to-First-Byte, Cache-Verhalten: alles unverändert.
  • Read-Only-API — Daten werden gelesen, nicht geschrieben (Ausnahme: plugin:update, wenn Sie ein Update aktiv auslösen).
  • Eigene Authentifizierung — Endpoints sind über die Shopware-Integration abgesichert; optional zusätzlicher Agent-Token.

Installation

Option A — Shopware Store

  1. Shopware-Admin → ErweiterungenStore
  2. „Webshop Radar" suchen
  3. Installieren und aktivieren

Option B — Manuell (ZIP-Upload)

  1. Webshop-Radar Dashboard → ZIP-Download (im Installation-Detail-Modal, wenn das Plugin noch nicht installiert ist)
  2. Shopware-Admin → ErweiterungenMeine ErweiterungenErweiterung hochladen
  3. ZIP auswählen → Hochladen → Installieren → Aktivieren

Nach der Installation

  • Im Webshop-Radar Dashboard auf Status aktualisieren klicken
  • Im Detail-Modal verschwindet die gelbe „Plugin nicht installiert"-Warnung
  • Plugin-Update-Buttons werden aktiviert

Konfiguration

In den meisten Fällen sind die Defaults gut. Optional in den Plugin-Einstellungen anpassbar:

  • CLI-Befehle erlauben: Standard = aktiviert. Wenn deaktiviert, kann Webshop-Radar cache:clear und plugin:refresh nicht auslösen.
  • Agent-Token (optional): zusätzlicher Auth-Token. Wenn gesetzt, muss derselbe Token im Installations-Formular eingetragen werden.

Versionen & Updates

Das Plugin meldet seine Version selbst an Webshop-Radar. Beim Login sehen Sie, falls eine neuere Version verfügbar ist. Updaten Sie das Plugin am besten wie jedes andere Shopware-Plugin: über den Store oder via ZIP-Upload.

Sicherheit

  • Read-Only-Endpoints (System-Info, Diagnostik) sind nur über die Shopware-Integration erreichbar — keine offene API.
  • CLI-Endpoint ist auf eine Whitelist beschränkt: cache:clear, plugin:refresh, plugin:update. Andere Befehle werden abgelehnt.
  • Plugin löschen: jederzeit möglich. Webshop-Radar wechselt dann in den „Read-Only-Modus" (ohne Plugin-Updates).

Siehe auch: Kapitel 4 — Shopware-API-Integration (Voraussetzung) und Kapitel 7 — Plugin-Updates (Hauptanwendungsfall).