Konfiguracja rozszerzenia TYPO3 – krok po kroku

Instalacja, konfiguracja i rozwiązywanie problemów rozszerzenia live24h Website Monitor w TYPO3 – w module backendu lub przez CLI.

Ta instrukcja dotyczy TYPO3 12.4 do 13.4 LTS oraz PHP 8.1 do 8.3. Wymagane są konto live24h, workspace oraz API key z prawem zapisu – zobacz wspólne kroki .

Instalacja

Instalacja przez Composer:

composer require live24h/website-monitor-typo3
vendor/bin/typo3 extension:setup

Następnie w konfiguracji rozszerzenia wprowadź apiKey, opcjonalnie siteBaseUrl oraz apiBaseUrl (domyślnie https://api.live24h.eu). Listowanie w oficjalnym TYPO3 Extension Repository (TER) nastąpi później.

Krok po kroku (backend)

Backend TYPO3: live24h Monitor w Site-Management
W TYPO3 w sekcji Site-Management → live24h Monitor – lub przez CLI. Schemat poglądowy – prawdziwy zrzut ekranu wkrótce.
  1. W backendzie otwórz grupę modułów Site-Management → live24h Monitor.
  2. W zakładce Ustawienia sprawdź połączenie („Testuj połączenie").
  3. Uruchom analizę strony (Site).
  4. Przyjrzyj się wartości Health Score i rekomendacjom.
  5. Wybierz checki – zablokowane propozycje są oznaczone jako „Wymagany upgrade".
  6. Utwórz checki jednym kliknięciem.

Alternatywnie przez CLI

# Dry-run: pokazuje scan, modules, score i suggestions jako raport
vendor/bin/typo3 live24h:monitor:scan --base-url=https://www.example.org

# Tworzenie: tworzy domyślne propozycje
vendor/bin/typo3 live24h:monitor:scan --base-url=https://www.example.org --apply

Dla stopniowanych wdrożeń dostępne jest dodatkowo vendor/bin/typo3 live24h:monitor:rollout (poziomy minimal, standard, enterprise – domyślnie jako dry-run).

Rozwiązywanie problemów i wskazówki

Brakuje modułu backendu „live24h Monitor". Wykonaj vendor/bin/typo3 extension:setup i wyczyść cache poleceniem vendor/bin/typo3 cache:flush. Sprawdź ponadto, czy Twój użytkownik backendu ma dostęp do modułu.

siteBaseUrl jest puste lub sprawdzany jest niewłaściwy URL. Bazowy URL jest wyprowadzany z konfiguracji Site w TYPO3. Jeśli nie jest jednoznaczny, ustaw siteBaseUrl w konfiguracji rozszerzenia jawnie – lub podaj go przez CLI z --base-url=.

„Testuj połączenie" kończy się błędem. Sprawdź apiKey (wymagane prawo zapisu), apiBaseUrl (https://api.live24h.eu) oraz to, czy serwer może łączyć się wychodząco na zewnątrz.

Check typu Heartbeat pozostaje na „Oczekuje". To normalne i nie jest błędem: Heartbeat czeka na pierwszy sygnał monitorowanego zadania Scheduler (ping do adresu Heartbeat). Dopóki zadanie jeszcze się nie zgłosiło, check pozostaje na „Oczekuje" – a nie na „Awaria". Po pierwszym uruchomieniu status zmienia się na „Operacyjny".

Heartbeat Scheduler się nie pojawia. Propozycja Heartbeat wymaga, aby rozszerzenie systemowe Scheduler w TYPO3 było zainstalowane i aktywne. Bez niego ten punkt nie występuje.

Backend czy CLI – co wybrać? Oba prowadzą do tego samego rezultatu. Kreator backendu jest blisko klienta, CLI nadaje się do powtarzalnych wdrożeń. Bez --apply skanowanie działa jako dry-run.

Najczęstsze pytania

Dlaczego osobne rozszerzenie TYPO3? Projekty TYPO3 mają często wiele Sites i wyższe wymagania co do śledzenia zmian. Prowadzony przepływ pasuje lepiej niż ręczne pojedyncze checki.

Czy to tylko dla agencji? Nie. Pasuje równie dobrze dla firm, operatorów SaaS, instytucji publicznych i zespołów technicznych.

Czy obsługiwanych jest wiele domen? Tak. Sites i domeny są odczytywane z konfiguracji Site i można je zabezpieczyć per domena.

← Powrót do przeglądu wtyczek