Pimcore-Plugin einrichten – Schritt für Schritt

Installation, Einrichtung und Problemlösungen für das live24h Health Center in Pimcore 11 – Documents und Sites analysieren, Health Score sehen, Checks mit einem Klick anlegen.

Diese Anleitung gilt für Pimcore 11 (Symfony-basiert) und PHP 8.1 oder höher. Voraussetzung sind ein live24h Account, ein Workspace und ein API-Key mit Schreibrechten – siehe gemeinsame Schritte .

Installieren

Composer-Installation und Bundle-Aktivierung:

composer require live24h/pimcore-adapter

Aktivieren Sie das Bundle in config/bundles.php:

return [
    // ...
    Live24h\PimcoreAdapter\Bundle\Live24hHealthCenterBundle::class => ['all' => true],
];

Importieren Sie das Routing in config/routes.yaml:

live24h_health_center:
    resource: '@Live24hHealthCenterBundle/Resources/config/routing.yaml'

Installieren Sie anschließend das Bundle, leeren Sie den Cache und gewähren Sie der passenden Backend-Rolle die ACL-Berechtigung live24h_health_center:

bin/console pimcore:bundle:install Live24hHealthCenterBundle
bin/console cache:clear

Schritt für Schritt

Der Ablauf entspricht dem bebilderten Weg der Übersicht ; für Pimcore gilt:

  1. Öffnen Sie im Pimcore-Backend den Menüpunkt live24h Health Center (/admin/live24h-health-center).
  2. Hinterlegen Sie im Tab Einstellungen den API-Key und prüfen Sie die Verbindung („Verbindung testen"). Der Key wird stets nur maskiert angezeigt (lv24_••••<last4>).
  3. Starten Sie die Analyse Ihrer Documents und Sites.
  4. Sehen Sie sich den Website Health Score und die Empfehlungen an – gruppiert nach SEO, SSL/Domain/DNS und Mail-Deliverability.
  5. Wählen Sie die Checks aus. Gesperrte Vorschläge bleiben sichtbar und sind als „Ab Pro" markiert.
  6. Legen Sie die ausgewählten Checks mit einem Klick in live24h an.

Mit den Policy-Presets Essential, Recommended und All steuern Sie den Umfang der Vorauswahl. Ein Dry-Run schreibt nichts und zeigt nur den Report.

Problemlösungen und Tipps

Der Menüpunkt „live24h Health Center" fehlt. Prüfen Sie, ob das Bundle in config/bundles.php aktiviert und das Routing in config/routes.yaml importiert ist. Führen Sie bin/console pimcore:bundle:install Live24hHealthCenterBundle aus und leeren Sie den Cache mit bin/console cache:clear. Stellen Sie außerdem sicher, dass Ihre Backend-Rolle die ACL-Berechtigung live24h_health_center besitzt.

„Verbindung testen" schlägt fehl. Prüfen Sie den API-Key (Schreibrechte erforderlich), die API-Basis-URL (https://api.live24h.eu) und ob der Server ausgehend nach außen verbinden darf. Die Verbindung schließt im Fehlerfall bewusst geschlossen (fail-closed) und folgt keinen Weiterleitungen.

Es werden falsche oder fehlende Domains geprüft. Die Domains werden aus der Pimcore Sites-Tabelle abgeleitet. Hinterlegen Sie je Site eine eindeutige produktive Root-Domain, damit SSL-, Domain- und DNS-Checks korrekt zugeordnet werden.

Die Mail-Prüfung schlägt einen Punkt vor, legt aber keinen Check an. Das ist gewollt: MX, SPF, DKIM und DMARC werden zur Information angezeigt. Es gibt keinen Mail-Check-Typ, daher schlägt das Plugin hierfür bewusst keinen anlegbaren Monitor vor.

Wo ist der Heartbeat für Wartungs- oder Cron-Jobs? Den gibt es für Pimcore bewusst nicht. Pimcore bietet kein einheitlich erkennbares Cron-Modell, daher lassen wir den Heartbeat ehrlich weg, statt ein leeres Panel zu zeigen.

Häufige Fragen

Schreibt der Scan etwas in Pimcore? Nein. Der Scan ist lesend und arbeitet cache-basiert. Erst wenn Sie Checks auswählen und anlegen, wird die Konfiguration auf der live24h Plattform erstellt. Mit dem Preset als Dry-Run wird nichts geschrieben.

Werden mehrere Sites unterstützt? Ja. Sites und Domains werden aus der Pimcore Sites-Tabelle ausgelesen und lassen sich pro Domain absichern.

Werden Assets und DataObjects berücksichtigt? Sie erscheinen als Inhalts-Übersicht im Health Center. Anlegbare Checks entstehen aus den Bereichen SEO, SSL, Domain und DNS.

← Zurück zur Plugin-Übersicht