IP Modülü Yazma

coremio/modules/IP/AcmeGeo/
├── AcmeGeo.php       AcmeGeo sınıfı   (taban sınıf yok, ad alanı gerekmez)
├── config.php        ['website' => 'AcmeGeo', 'key' => '']
└── pages/
    └── settings.php  kimlik bilgisi alanları, Ayarlar içinde render edilir

public $error;          // false dönüşünden sonra çekirdek tarafından okunur
public $config = [];    // yapıcıda modülün config.php dosyasından doldurulur

public function __construct();

// Konum. ZORUNLU. Aşağıdaki diziyi döndürün, ya da $this->error dolu olarak false.
// classes/UserManager.php içindeki UserManager::ip_info() metodundan çağrılır.
public function info($ip = '');

// Risk puanlama. İSTEĞE BAĞLI - çekirdek çağırmadan önce method_exists() ile yoklar.
// classes/UserManager.php içindeki UserManager::is_proxy() metodundan çağrılır.
public function proxy($ip = '');

// classes/UserManager.php, ip_info()
$ip_module = Config::get("modules/ip");
$obj       = Modules::getInstance("IP", $ip_module);
if (!$obj) return ['status' => "error", 'message' => "IP module '{$ip_module}' could not be loaded."];

$result = $obj->info($ip);
if (!$result) {
    // Zaman aşımı düz bir false olarak yutulur; başka her şey loglanır ve yüzeye çıkarılır.
    if (stristr($obj->error, 'timed out')) return false;
    Modules::save_log("IP", $ip_module, "check", $ip, $obj->error);

    return ['status' => "error", 'message' => $obj->error];
}

// classes/UserManager.php, is_proxy()
$proxy_obj = Modules::getInstance("IP", $ip_module);
if ($proxy_obj && method_exists($proxy_obj, 'proxy')) {
    $pdata = $proxy_obj->proxy($ip);
    if ($pdata === false) $error = $proxy_obj->error;
}

// Üçüncü argüman true, çıplak karar yerine ayrıntılı dökümü ister.
$verdict = UserManager::is_proxy($ip, false, true);
// ['proxy' => bool, 'hosting' => bool, 'risky' => bool]
// 'risky' sizin 'result' değerinizdir, operatörün beyaz listesi uygulandıktan sonra.

// Giriş ve kayıt kapılarının kullandığı yaygın biçim:
if (Config::get('options/proxy-block') && UserManager::is_proxy() === true)
    throw new Exception(Language::g('errors/error9'));

<?php

class AcmeGeo
{
    public $error;
    public $config = [];

    public function __construct()
    {
        $this->config = Modules::Config("IP", __CLASS__);
    }

    public function info($ip = '')
    {
        $this->error = null;

        $key = (string) ($this->config["key"] ?? '');
        $url = "https://api.acmegeo.example/v1/lookup/" . rawurlencode($ip);

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: " . $key]);

        $response = curl_exec($ch);
        if (curl_errno($ch)) {
            $this->error = curl_error($ch);
            $response    = false;
        }
        curl_close($ch);

        if ($response === false) return false;

        $data = Utility::jdecode((string) $response, true);
        if (!is_array($data)) {
            $this->error = "Invalid response from AcmeGeo.";

            return false;
        }

        // Ülke yoksa kullanılabilir cevap da yok. Burada dolu bir dizi döndürmek başarı
        // sayılıp önbelleğe alınır ve dosya silinene dek o adres bozuk kalır.
        $iso = (string) ($data["country_code"] ?? '');
        if (!$iso) {
            $this->error = "Country code not found : " . $ip;

            return false;
        }

        $region = (string) ($data["region"] ?? '');
        $city   = (string) ($data["city"] ?? '');

        return [
            'status'      => "success",
            'query'       => (string) ($data["ip"] ?? $ip),
            'countryCode' => strtolower($iso),          // küçük harf zorunludur
            'country'     => (string) ($data["country_name"] ?? ''),
            'regionName'  => $region ?: $city,
            'city'        => $city ?: $region,          // city alanını asla boş bırakmayın
            'zip'         => (string) ($data["postal"] ?? ''),
            'lat'         => $data["latitude"] ?? '',
            'lon'         => $data["longitude"] ?? '',
            'timezone'    => (string) ($data["time_zone"] ?? ''),
            'as'          => isset($data["asn"]) ? trim("AS" . $data["asn"] . " " . ($data["asn_org"] ?? '')) : '',
        ];
    }

    public function proxy($ip = '')
    {
        $this->error = null;

        $ch = curl_init("https://api.acmegeo.example/v1/risk/" . rawurlencode($ip));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: " . (string) ($this->config["key"] ?? '')]);

        $response = curl_exec($ch);
        if (curl_errno($ch)) {
            $this->error = curl_error($ch);
            $response    = false;
        }
        curl_close($ch);

        if ($response === false) return false;

        $data = Utility::jdecode((string) $response, true);
        if (!is_array($data)) {
            $this->error = "AcmeGeo risk lookup failed.";

            return false;
        }

        $score = (int) ($data["score"] ?? 0);

        return [
            // 'result' engeller, 'proxy' yalnız tanımlar. İkisini birleştirmeyin.
            'result'  => $score >= 60,
            'proxy'   => $score >= 30,
            'hosting' => (bool) ($data["datacenter"] ?? false),
            'score'   => $score,
            'as'      => isset($data["asn"]) ? trim("AS" . $data["asn"] . " " . ($data["asn_org"] ?? '')) : '',
        ];
    }
}

<?php
return [
    'website' => "AcmeGeo",   // Ayarlar açılır listesinin gösterdiği etiket
    'key'     => '',          // kayıt yolu tarafından geri yazılır, asla elle değil
];

<div class="row mb-3 pb-3 pt-3 border-bottom">
    <label for="acmegeo_key" class="col-sm-1 col-form-label text-sm-end">
        <span class="d-block fw-semibold">Api Key</span>
    </label>
    <div class="col-sm-11">
        <!-- Ad, config anahtarıdır: ip_api_config[key] config.php dosyasına 'key' olarak düşer. -->
        <input type="text" class="form-control" id="acmegeo_key"
               name="ip_api_config[key]"
               value="<?php echo $module->config["key"] ?? ''; ?>">
    </div>
</div>

// helpers/Money.php - ziyaretçinin para birimi ülke kodundan gelir.
$info = UserManager::ip_info();

// Günlük kota tükendiğinde ya da modül yüklenemediğinde ip_info() ayrıca
// ['status' => 'error', 'message' => ...] döndürür: dolu, ama countryCode yok. Null-güvenli okuyun.
$needle = strtoupper($info["countryCode"] ?? '');

// classes/Auth.php - giriş konum denetimi, ülke ya da şehir hassasiyetinde.
$country = is_array($info) ? (string) ($info['countryCode'] ?? '') : '';
$city    = is_array($info) ? (string) ($info['city'] ?? '') : '';
if ($country === '') return false;   // ulaşılamayan bir sorgu asla değişiklik sayılmaz