Questa guida vale per Pimcore 11 (basato su Symfony) e PHP 8.1 o superiore. Sono necessari un account live24h, un workspace e una API key con permessi di scrittura – vedi passaggi comuni .
Installazione
Installazione tramite Composer e attivazione del bundle:
composer require live24h/pimcore-adapter
Attiva il bundle in config/bundles.php:
return [
// ...
Live24h\PimcoreAdapter\Bundle\Live24hHealthCenterBundle::class => ['all' => true],
];
Importa il routing in config/routes.yaml:
live24h_health_center:
resource: '@Live24hHealthCenterBundle/Resources/config/routing.yaml'
Svuota poi la cache e concedi al ruolo backend adatto il permesso ACL live24h_health_center:
bin/console pimcore:bundle:install Live24hHealthCenterBundle
bin/console cache:clear
Passo dopo passo
Il flusso corrisponde al percorso illustrato della panoramica ; per Pimcore vale:
- Apri nel backend di Pimcore la voce di menu live24h Health Center (
/admin/live24h-health-center). - Inserisci nella scheda Impostazioni la API key e verifica la connessione («test di connessione»). La key viene sempre mostrata solo mascherata (
lv24_••••<last4>). - Avvia l’analisi dei tuoi Documents e Sites.
- Guarda il Website Health Score e le raccomandazioni – raggruppate per SEO, SSL/dominio/DNS e deliverability delle email.
- Seleziona i check. I suggerimenti bloccati restano visibili e sono contrassegnati come «Da Pro».
- Crea i check selezionati in live24h con un clic.
Con i preset di policy Essential, Recommended e All decidi l’ampiezza della preselezione. Un dry-run non scrive nulla e mostra solo il report.
Soluzione dei problemi e suggerimenti
La voce di menu «live24h Health Center» manca.
Verifica che il bundle sia attivato in config/bundles.php e che il routing sia importato in config/routes.yaml. Esegui bin/console pimcore:bundle:install Live24hHealthCenterBundle e svuota la cache con bin/console cache:clear. Assicurati inoltre che il tuo ruolo backend disponga del permesso ACL live24h_health_center.
Il «test di connessione» fallisce.
Controlla la API key (sono necessari i permessi di scrittura), l’URL della API Base (https://api.live24h.eu) e se il server può aprire connessioni verso l’esterno. In caso di errore la connessione si chiude in modo deliberato (fail-closed) e non segue alcun reindirizzamento.
Vengono verificati domini sbagliati o mancanti. I domini vengono ricavati dalla tabella Sites di Pimcore. Inserisci per ogni Site un root domain produttivo univoco, così i check di SSL, dominio e DNS vengono associati correttamente.
La verifica email propone un punto, ma non crea un check. È voluto: MX, SPF, DKIM e DMARC vengono mostrati a titolo informativo. Non esiste un tipo di check email, perciò il plugin non propone qui in modo deliberato alcun monitor creabile.
Dov’è l’heartbeat per i job di manutenzione o Cron? Per Pimcore non è disponibile in modo deliberato. Pimcore non offre un modello Cron riconoscibile in modo uniforme, perciò omettiamo l’heartbeat con onestà invece di mostrare un pannello vuoto.
Domande frequenti
La scansione scrive qualcosa in Pimcore? No. La scansione è in sola lettura e lavora basandosi sulla cache. Solo quando selezioni e crei i check, la configurazione viene creata sulla piattaforma live24h. Con il preset come dry-run non viene scritto nulla.
Vengono supportati più Sites? Sì. Sites e domini vengono letti dalla tabella Sites di Pimcore e possono essere protetti per ogni dominio.
Vengono considerati Assets e DataObjects? Compaiono come panoramica dei contenuti nel Health Center. I check creabili nascono dagli ambiti SEO, SSL, dominio e DNS.