Státusz: az oldal állapota egy titkos URL-en

A Státusz egy olvasható jelentés az oldalad állapotáról: fut-e a WP-Cron, volt-e végzetes PHP-hiba, mennyi frissítés vár, megy-e ki a levél, mikor volt mentés, és rendben van-e a HelloPack-kapcsolat. A jelentést egy titkos URL-en adod oda a monitorozó szolgáltatásodnak, így egyetlen kérésből látja, mi a baj az oldallal.

A funkció a HelloPack Client 3.1.0-s verziójától érhető el, és alapból ki van kapcsolva.

Hol találod?

WordPress admin → HelloPack → Státusz. A Státusz a bal oldali menüben, a HelloPack almenüjében van (a HelloPack felület felső sávjában nincs).

https://pelda.hu/wp-admin/admin.php?page=hellopack-client-status

A Státusz oldal: a végpont kapcsolója, a státusz-URL, a gyorsítótár ideje és az ellenőrzések listája.

Hálózati (multisite) telepítésnél a Státusz a Hálózati admin → HelloPack → Státusz alatt van, és a fő oldal válaszol a teljes hálózat helyett.

Bekapcsolás lépésről lépésre

1. Nyisd meg a Státusz oldalt, és kapcsold Bekapcsolva állásba a Státuszvégpont kapcsolót.

2. A Hozzáférés részben kattints az URL generálása gombra. Kapsz egy ilyen címet:

   https://pelda.hu/wp-json/hellopack/v1/status/3f9a…(32 karakter)…c41e

3. Másold ki a Másolás gombbal, és add meg a monitorozó szolgáltatásodnak.

4. Válaszd ki, mennyi ideig használja újra a jelentést (Eredmény újrafelhasználása ennyi ideig: 1, 5 vagy 15 perc). Ennyi ideig a tárolt eredményt kapja minden kérés, utána a következő kérés újra lefuttatja az ellenőrzéseket.

5. Az Ellenőrzések listában kapcsold ki, amire nincs szükséged. A Futtatás most gombbal azonnal megnézheted az eredményt.

Az URL-ben lévő kulcs az egyetlen védelem

Aki ismeri a címet, el tudja olvasni a jelentést. Ne tedd ki nyilvános helyre. Ha kiszivárgott, kattints az Új URL generálása gombra: a régi cím azonnal megszűnik működni.

Rossz vagy régi kulcsra, illetve kikapcsolt végpontnál a válasz ugyanaz a 404-es hiba, amit a WordPress egy nem létező REST útvonalra ad. Kívülről nem derül ki, hogy a funkció létezik-e az oldalon.

Mit jelentenek az állapotok?

Minden ellenőrzés egy állapotot ad, az Összesített állapot a legrosszabb közülük.

Állapot	A felületen	Jelentése
ok	rendben	Az ellenőrzés nem talált gondot.
warn	figyelmet igényel	Nem sürgős, de foglalkozni kell vele (pl. függő frissítések, régi mentés).
crit	hibás	Az oldal működését érintő hiba (pl. végzetes PHP-hiba, le nem futott ütemezett feladatok).
unknown	nem mérhető	Nincs elég adat, az ellenőrzés hibára futott, vagy kifutott az időkeretből.

A súlyossági sorrend: ok < unknown < warn < crit. Az ellenőrzések együtt legfeljebb 2 másodpercig futhatnak; ami ezután következne, az „Kihagyva: az időkeret elfogyott.” üzenettel unknown lesz.

A Nem alkalmazható jelölésű ellenőrzés ezen az oldalon nem fut (például WooCommerce nélkül a WooCommerce-ellenőrzés), és nem kerül a jelentésbe.

Az ellenőrzések

Azonosító	Név a felületen	Mit néz
site_url	Oldal címe	Https-t használ-e az oldal címe, és egyezik-e a két WordPress-cím beállítás.
woo_coming_soon	WooCommerce „hamarosan indulunk”	A bolt a WooCommerce „hamarosan” oldala mögé van-e rejtve. Csak WooCommerce mellett fut.
visibility	Kereső-láthatóság	Le van-e tiltva a keresőmotorok elől az oldal, vagy fut-e karbantartási mód az élő oldalon.
cron	Ütemezett feladatok (WP-Cron)	Vannak-e esedékes, de le nem futott ütemezett feladatok.
fatal_errors	Végzetes hibák	Helyreállítási mód, és az utolsó 24 óra végzetes PHP-hibái.
autoload	Automatikusan betöltött beállítások	Az minden oldalbetöltéskor beolvasott beállítások teljes mérete és a legnagyobbak.
updates	Váró frissítések	Függő WordPress-, bővítmény- és sablonfrissítések.
performance	Szerverterhelés	Terhelés CPU-magonként, a WordPress indulási ideje és az adatbázis válaszideje.
mail	Kimenő e-mail	Kiment-e a legutóbbi néhány levél, a FluentSMTP naplója alapján.
action_scheduler	Háttérfeladatok (Action Scheduler)	Késésben lévő és hibás háttérfeladatok, és futott-e valami mostanában. Csak Action Scheduler mellett fut.
backup	Mentések	Milyen régi az utolsó sikeres mentés (UpdraftPlus vagy All-in-One WP Migration). Csak ezek mellett fut.
hellopack	HelloPack-kapcsolat	Él-e a HelloPack-kapcsolat, ehhez a domainhez tartozik-e a kulcs, és futnak-e a licencmodulok.
permalinks	Permalinkek	Naprakészek-e a tárolt átírási szabályok, és Apache-on egyezik-e a .htaccess. Csak beállított közvetlen hivatkozásoknál fut.

Az ellenőrzések csak olvasnak: nem írnak beállítást, nem ürítenek gyorsítótárat, és nem indítanak kimenő kérést. Az egyetlen kivétel a performance, ami a saját mérési mintáit eltárolja.

A jelentés formája

GET /wp-json/hellopack/v1/status/<kulcs>

{
  "overall": "warn",
  "checked_at": "2026-10-28T09:15:02+00:00",
  "cached": true,
  "site": {
    "url": "https://pelda.hu",
    "wp": "6.8.3",
    "php": "8.3.12",
    "hellopack": "3.2.2"
  },
  "checks": {
    "updates": {
      "status": "warn",
      "summary": "…",
      "details": { },
      "checked_at": "2026-10-28T09:15:02+00:00",
      "duration_ms": 12
    }
  }
}

Lekérdezési paraméterek:

Paraméter	Hatása
?fresh=1	Nem a tárolt eredményt adja, hanem most futtat minden ellenőrzést.
?checks=cron,mail	Csak a felsorolt ellenőrzéseket futtatja. Az ismeretlen azonosítókat kihagyja.
?http_status=1	Ha az összesített állapot crit, a válasz HTTP-kódja 503 lesz. Hasznos olyan monitorozónál, ami csak a HTTP-kódot figyeli.

Parancssorból

A Státusz WP-CLI-ből is kezelhető. A run akkor is működik, ha a végpont ki van kapcsolva, mert helyben fut és semmit nem tesz közzé.

Terminál

# Jelentés táblázatban, vagy pontosan a végpont JSON-jával
wp hellopack status run
wp hellopack status run --fresh --checks=cron,mail --format=json
# Végpont be- és kikapcsolása
wp hellopack status enable
wp hellopack status disable
# Ellenőrzések listája, egyenkénti ki- és bekapcsolás
wp hellopack status checks list
wp hellopack status checks disable mail backup
wp hellopack status checks enable mail
# A titkos URL kiírása, vagy új kulcs
wp hellopack status url
wp hellopack status url regenerate
# Beállítások megtekintése, gyorsítótár ideje (60–3600 másodperc)
wp hellopack status settings
wp hellopack status settings --cache-ttl=300

A wp hellopack status run kilépési kódja az összesített állapotot követi: ok és unknown esetén 0, warn esetén 1, crit esetén 2. Így szkriptből vagy ütemezett feladatból is tudsz rá riasztani.

Saját ellenőrzés fejlesztőknek

Bővítmény is adhat ellenőrzést a jelentéshez a hellopack_status_checks szűrővel. Az osztálynak a HelloPack\Client\Status\StatusCheck interfészt kell megvalósítania (id(), label(), description(), applies(), run()), a run() pedig CheckResult::ok(), warn(), crit() vagy unknown() értéket ad vissza.

sajat-bovitmeny.php

add_filter( 'hellopack_status_checks', function ( array $checks ) {
    $checks[] = new class implements \HelloPack\Client\Status\StatusCheck {
        public function id(): string          { return 'sajat_sor'; }
        public function label(): string       { return __( 'Saját sor', 'sajat' ); }
        public function description(): string { return __( 'Várakozó feladatok száma.', 'sajat' ); }
        public function applies(): bool       { return class_exists( 'Sajat_Bovitmeny' ); }
        public function run(): \HelloPack\Client\Status\CheckResult {
            $n = \Sajat_Bovitmeny::sor_merete();
            return $n > 100
                ? \HelloPack\Client\Status\CheckResult::warn( sprintf( __( '%d feladat vár.', 'sajat' ), $n ), [ 'queued' => $n ] )
                : \HelloPack\Client\Status\CheckResult::ok( __( 'A sor rendben.', 'sajat' ), [ 'queued' => $n ] );
        }
    };
    return $checks;
} );

Szabályok: csak olvass (ne írj beállítást, ne indíts kimenő kérést), legyél gyors, és ne tegyél kulcsot, jelszót vagy fájlútvonalat az összegzésbe. Ha a run() kivételt dob, az eredmény unknown lesz, és a jelentés többi része változatlan marad. Az új ellenőrzés a Státusz oldalon a bővítményed nevével jelenik meg a Forrás oszlopban, és ott ki is kapcsolható.