İlk Modülünüz

coremio/modules/Currency/AcmeRates/
├── AcmeRates.php      # sınıf, dizinle aynı adı taşır
├── config.php         # dizi döndürür; ayarlar kaydedilince modül bu dosyayı yeniden yazar
└── lang/
    ├── en.php         # dizi döndürür; panelde görünen 'name' ve 'description'
    └── tr.php

// Kur çekme. Money::get_exchange_rates() ve panelin bağlantı testi çağırır; test önce
// method_exists ile varlığını kontrol eder. $to hedef kodları taşır, büyük harfle.
// KOD => kur haritası döndürün; falsy her dönüş başarısızlık sayılır.
public function exchange_rates(string $from = '', array $to = []): array|false;

// Ayar kalıcılığı. Kur ayarları operasyonu bunu yalnız bu modüle gönderilen
// değerlerle, yani $_POST['module_data']['AcmeRates'] ile çağırır.
public function save_config(array $data = []): bool;

// Kur ekranında gösterilen ayar işaretlemesi. Instance üzerinde koşulsuz çağrılır,
// yani boş dize döndürecek olsa bile var olmak zorundadır.
public function page_settings(): string;

// Modules : fabrika ve iki yükleyici. Hepsi statik.
public static function getInstance(string $type, string $name, array $params = []): ?object;
public static function Config($type, $module);                          // cache'ten; önce yükleme ister
public static function Lang($type, $module, $lang = '');                // dosyayı kendisi yükler
public static function Load($type = '', $name = '', $nominc = false, $status = '');
public static function getName(string $type, string $module): string;
public static function save_log($type = '', $module = '', $action = '', $request = '', $response = '', $processed = '');

// Utility : istek ve JSON yardımcıları.
public static function HttpRequest($url = '', $params = [], $retry = 0);   // dizi ilk argüman, aşağıya bakın
public static function jdecode($string = '', $mode = false);              // ilişkisel dizi için $mode = true
public static function jencode($string = '', $flags = 0): string|false;
public static function array_export($array = [], $options = []);          // ['pwith' => true] PHP dosyası olarak sarar

// FileManager : derlenmiş kopyayı geçersiz kılan yazım.
public static function file_write($file, $data = null, $mode = 'w', $flags = 0);

namespace WISECP\Modules\Currency;

class AcmeRates
{
    public string $name   = "AcmeRates";
    public ?array $config = null;
    public ?array $lang   = null;

    public function __construct()
    {
        $this->config = \Modules::Config("Currency", $this->name);
        $this->lang   = \Modules::Lang("Currency", $this->name);
    }

    public function save_config(array $data = []): bool
    {
        $merged = array_replace_recursive($this->config ?: [], $data);

        return (bool) \FileManager::file_write(__DIR__ . DS . "config.php", \Utility::array_export($merged, ['pwith' => true]));
    }

    public function exchange_rates(string $from = '', array $to = []): array|false
    {
        $key = (string) ($this->config['apiKey'] ?? '');
        if ($key === '')
            throw new \Exception($this->lang['error-no-key'] ?? 'API anahtarı tanımlı değil.');

        $response = \Utility::HttpRequest([
            'url'    => 'https://api.example.com/rates?base=' . urlencode($from),
            'type'   => 'GET',
            'header' => ['Authorization: Bearer ' . $key],
        ]);

        // Her çağrı kaydedilir; böylece hata veren sağlayıcı panelden teşhis edilebilir.
        \Modules::save_log("Currency", $this->name, "exchange", ['from' => $from, 'to' => $to], $response);

        $data = \Utility::jdecode((string) $response, true);
        if (!isset($data['rates']))
            throw new \Exception('Kur sağlayıcısından beklenmeyen yanıt.');

        $out = [];
        foreach ($to as $code) $out[$code] = (float) ($data['rates'][$code] ?? 0);

        return $out;
    }

    public function page_settings(): string
    {
        $key = htmlspecialchars((string) ($this->config['apiKey'] ?? ''), ENT_QUOTES);

        // Alan adı sözleşmenin kendisidir: save_config() tam bunu alır.
        return '<div class="row mb-0 align-items-center">'
             . '<label class="col-sm-3 col-form-label fw-semibold">API Key</label>'
             . '<div class="col-sm-9"><input type="text" class="form-control" '
             . 'name="module_data[AcmeRates][apiKey]" value="' . $key . '"></div></div>';
    }
}

// config.php : page_settings() bastığı ve save_config() geri yazdığı anahtarlar.
return [
    'apiKey'    => '',
    'help-link' => 'https://api.example.com/docs',
];

// lang/tr.php : modül listesinin gösterdiği 'name' ve 'description'.
return [
    'name'         => 'Acme Kurları',
    'description'  => 'Acme sağlayıcısından döviz kurları. API anahtarı gerekir.',
    'error-no-key' => 'API anahtarı tanımlı değil.',
];

$module = Modules::getInstance("Currency", "AcmeRates");

// Tipe değil sözleşmeye göre koruyun: modül düz bir sınıftır ve bir metottan eski olabilir.
if ($module && method_exists($module, "exchange_rates"))
    $rates = $module->exchange_rates("USD", ["EUR", "TRY"]);

// Hiçbir şey kurmadan yalnız yapılandırma ve dil paketi.
Modules::Load("Currency", "AcmeRates", true);
$config = Modules::Config("Currency", "AcmeRates");
$label  = Modules::getName("Currency", "AcmeRates");