TILEZZA GEO-SZŰRŐ — PHP-VÁLTOZAT (tárhely és VPS)
==================================================

Mit csinál: a kiválasztott országokból és adatközpontokból érkező látogatókat
csak feljegyzi, ellenőrző lapra küldi, vagy kizárja (403). A döntés a TE
szervereden születik; a látogatóid adatai nem mennek sehova. A Tilezzától
naponta egyszer csak a kiválasztott országok aláírt IP-listáját tölti le.

Ha a Tilezza nem érhető el, vagy bármi hiba van: a látogatók átmennek, és a
legutóbbi jó lista marad érvényben. A szűrő miatt az oldalad nem áll le.

Kell hozzá: PHP 7.4–8.4 a sodium bővítménnyel (alapból benne van), egy Tilezza
API-kulcs (tlz_…), és HTTPS a webes beállítóhoz.
Statikus (PHP nélküli) oldalhoz az nginx-ügynök való: https://tilezza.eu/botkapu/#sajat-szerver


1. FELTÖLTÉS
------------
Töltsd fel a "geoszuro" mappát a webgyökérbe (ahol az index.php van),
FTP-vel vagy a tárhely fájlkezelőjével. Az eredmény pl.:
    /home/felhasznalo/public_html/geoszuro/geoszuro.php


2. BEKÖTÉS — egyet válassz
--------------------------
A pontos útvonalat a webes beállító "Bekötés" része kiírja (vagy SSH-n:
php geoszuro-proba.php bekotes). Az alábbi példákban /UT/ a geoszuro mappa
teljes útvonala.

 a) Tárhely (cPanel, DirectAdmin, Plesk; PHP-FPM vagy LiteSpeed):
    hozz létre a webgyökérben egy .user.ini fájlt (vagy egészítsd ki) ezzel:
        auto_prepend_file = "/UT/geoszuro.php"
    5 percen belül él (a PHP ennyi időnként olvassa újra).

    Ha a tárhely Apache + mod_php (a .user.ini nem hat): a .htaccess-be:
        php_value auto_prepend_file "/UT/geoszuro.php"

 b) VPS, nginx + PHP-FPM: a .php location blokkba, a fastcgi_pass mellé:
        fastcgi_param PHP_VALUE "auto_prepend_file=/UT/geoszuro.php";
    majd:  nginx -t && systemctl reload nginx
    Vagy az összes oldalra egyszerre, a PHP-FPM poolban
    (pl. /etc/php/8.3/fpm/pool.d/www.conf):
        php_admin_value[auto_prepend_file] = /UT/geoszuro.php
    majd:  systemctl restart php8.3-fpm

 c) VPS, Apache: mod_php esetén a vhostba vagy a .htaccess-be:
        php_value auto_prepend_file "/UT/geoszuro.php"
    PHP-FPM-mel (proxy_fcgi) a b) pont pool-sora való.

 d) Ha egyik sem megy: az index.php (WordPressnél a wp-config.php)
    legelejére, a <?php sor alá:
        require '/UT/geoszuro.php';


3. BEÁLLÍTÁS
------------
Nyisd meg böngészőben:  https://a-te-oldalad.hu/geoszuro/geoszuro-beallito.php
Első alkalommal: Tilezza API-kulcs + egy új jelszó (legalább 12 karakter).
A kulcsot a Tilezzánál ellenőrizzük, így más nem foglalhatja el a lapot.
Utána: jelöld be az országokat, válaszd a módot, mentsd.

Javaslat: 1–2 hétig "Csak figyel" módban fusson, nézd meg a statisztikát,
és utána válts "Ellenőrző lap" vagy "Tiltás" módra.

Uniós és EGT-országot nem lehet kiválasztani: az EU 2018/302 rendelete
tiltja az uniós látogatók ország szerinti kizárását.

A keresők (Google, Bing…), az AI-keresők, a link-előnézetek és az
uptime-figyelők mindig átmennek, ahogy a robots.txt és a sitemap is.

Kézi beállítás (HTTPS nélkül, vagy ha jobban szereted): másold a
geoszuro-beallitas-minta.php-t geoszuro-beallitas.php néven, és írd át.


4. ELLENŐRZÉS
-------------
- A beállító "Állapot" részén minden sor zöld.
- "Próba": írj be egy kiválasztott országbeli IP-címet; a lap megmondja,
  mit tenne vele a szűrő.
- SSH-n:  php geoszuro-proba.php            (állapot)
          php geoszuro-proba.php ip 1.2.3.4
          php geoszuro-proba.php stat
- Ha a statisztika napok óta üres, pedig jönnek látogatók a kiválasztott
  helyekről: a bekötés nem fut (2. pont).


5. KIKAPCSOLÁS AZONNAL
----------------------
Töröld vagy tedd megjegyzésbe (#  vagy ;) a 2. pontban beírt sort,
vagy nevezd át a geoszuro.php-t (pl. geoszuro.php.ki). Ennyi.
A "require" változatnál a sort kell törölni (az átnevezés ott hibát okozna).


6. HA VÉGEZTÉL A BEÁLLÍTÁSSAL
-----------------------------
A beállító lap alján: "Beállító kikapcsolása" (a szűrő tovább működik).
Vagy töröld a geoszuro-beallito.php fájlt.
Visszakapcsolás:  php geoszuro-proba.php beallito be
Elfelejtett jelszó: php geoszuro-proba.php jelszo  — vagy FTP-n a
geoszuro-beallitas.php-ban az 'admin_hash' értékét töröld ('').


7. FRISSÍTÉS ÚJ VERZIÓRA
------------------------
Töltsd fel az új zip fájljait a régiek fölé. A beállításod
(geoszuro-beallitas.php) a zipben nincs benne, így megmarad.


ADATOK
------
Adatmappa: geoszuro/geoszuro-adat (a webes beállító, ha tudja, a webgyökéren
kívülre teszi). A webről nem olvasható: .htaccess véd, és a napló, a titok
és a belépési próbák .php fájlok, amelyek megnyitva semmit nem adnak ki.
A napló IP-cím nélkül, 14 napig marad.
IP-adatok: iptoasn.com (PDDL 1.0, közkincs). Leírás: https://tilezza.eu/botkapu/
