Kur Modülü Yazma

// 1. coremio/helpers/Money.php: tek oran yolu, eşitleme görevi bunu kullanır
$instance = self::currency_module();               // yapılandırılmış modül, yoksa OpenRates
if (!$instance) return (string) Language::gc("admin/financial/currency-module-unavailable");
$rates = $instance->exchange_rates($from, $to);
if (!$rates) return $instance->error;              // modülün kendi mesajı operatöre ulaşır

// 2. coremio/operations/AdminFinancialCurrencies.php: ayar kaydı, ardından test butonu
$instance = Modules::getInstance("Currency", $module);
if ($instance && method_exists($instance, "save_config")) $instance->save_config($module_data[$module]);
// ...
if (!method_exists($instance, "exchange_rates")) throw new Exception("Module does not implement exchange_rates().");
$instance->config = array_replace_recursive($instance->config, $module_data[$module]);   // kaydedilmemiş form değerleri
$rates = $instance->exchange_rates($localCode, $targets);

// 3. coremio/api/Resources/Admin/Concerns/FinancialCurrencies.php: aynı ikisi, API üzerinden

Acme.php        namespace WISECP\Modules\Currency; class Acme  (extends yok)
config.php      DÜZ bir dizi, diğer modül tiplerindeki meta/settings ayrımı değil
lang/en.php
lang/tr.php

<?php
namespace WISECP\Modules\Currency;

class Acme
{
    public string  $name   = "Acme";
    public ?array  $config = null;
    public ?array  $lang   = null;
    public ?string $error  = null;      // false döndüğünüzde çağıran bunu okur

    public function __construct()
    {
        // Global sınıflar bu ad alanının içinde baştaki ters bölüyü ister,
        // yoksa PHP WISECP\Modules\Currency\Modules sınıfını arar.
        $this->config = \Modules::Config("Currency", $this->name);
        $this->lang   = \Modules::Lang("Currency", $this->name);
    }
}

// ZORUNLU
public function exchange_rates(string $from = '', array $to = []): array|false;

// Modülün herhangi bir ayarı olduğu anda ZORUNLU
public function save_config(array $data = []): bool;

// İSTEĞE BAĞLI: kur ayarları ekranı için işaretleme
public function page_settings(): string;

// Çağıranların doğrudan okuduğu public durum
public string  $name;
public ?array  $config;    // test butonu bellekte bunun üzerine yazar
public ?array  $lang;
public ?string $error;     // exchange_rates() false döndüğünde operatöre gösterilir

$rates = Money::get_exchange_rates($localCode, $targets);

if (!is_array($rates))
    return ['success' => false, 'result' => ['error' => is_string($rates) && trim($rates) !== '' ? $rates : self::NO_RATES]];

// Genişletme noktası: sağlayıcının fiyatlayamadığı bir para birimini enjekte edin ya da birini ezin.
Hook::runRefs('filter:money.exchange_rates_fetch', $rates, $localCode, $targets);

// Büyük harfli kod => para birimi id'si; böylece her şeyi döndüren bir sağlayıcı
// yine de yalnız sistemde gerçekten var olan para birimlerini günceller.
$codeToId = [];
foreach ($targets as $cid => $code) $codeToId[strtoupper($code)] = (int) $cid;

foreach ($rates as $code => $rate) {
    $codeUp = strtoupper((string) $code);
    $rate   = (float) $rate;

    if (!isset($codeToId[$codeUp])) continue;          // burada bir para birimi değil: yok sayılır
    if ($rate <= 0 || $rate > 999999999999.99999999) { $skipped++; continue; }   // tutarlılık koruması

    WDB::update('currencies', ['rate' => $rate])->where('id', '=', $codeToId[$codeUp])->save();
}

Hook::run('action:money.exchange_rates_updated', $changes, $localCode);

public function exchange_rates(string $from = '', array $to = []): array|false
{
    $apiKey = (string) ($this->config["api_key"] ?? '');

    if ($apiKey === '') {
        $this->error = "Acme api_key is not configured.";
        return false;
    }

    $url = "https://api.example.com/v1/" . urlencode($apiKey) . "/latest/" . urlencode(strtoupper($from));

    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 15);

    $response = curl_exec($ch);
    if ($response === false) $this->error = curl_error($ch) ?: "Currency provider request failed.";
    curl_close($ch);

    // Erken dönüşlerden ÖNCE kaydedin: bozuk bir anahtarı ayıklayan operatörün
    // yalnız hatayı değil, hatayı üreten isteği de görmesi gerekir.
    \Modules::save_log("Currency", $this->name, "exchange", [
        'api_url' => $url,
        'from'    => $from,
        'to'      => $to,
    ], $response, $this->error);

    if ($this->error) return false;

    $decoded = \Utility::jdecode(trim((string) $response), true);

    if (!is_array($decoded) || ($decoded["result"] ?? '') !== 'success') {
        $this->error = (string) ($decoded["error-type"] ?? 'Acme returned an error.');
        return false;
    }

    // Büyük harfli anahtarlar, float değerler. $to süzgeç olarak KULLANILMAZ: eşitleme
    // tanıdığını tutar, kalanını yok sayar.
    $result = [];
    foreach ((array) ($decoded["conversion_rates"] ?? []) as $code => $rate)
        $result[strtoupper((string) $code)] = (float) $rate;

    return $result;
}

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

    // Girdinin ADI, kaydetme operation'ıyla yapılan sözleşmedir:
    // module_data[Acme][api_key], save_config() içine $data['api_key'] olarak gelir.
    return '<div class="row mb-0 align-items-center">'
        . '<label for="acme-apikey" class="col-sm-3 col-form-label fw-semibold">API Key</label>'
        . '<div class="col-sm-9">'
        . '<input type="text" class="form-control" id="acme-apikey"'
        . ' name="module_data[Acme][api_key]" value="' . $apiKey . '" placeholder="api_key">'
        . '</div></div>';
}

public function save_config(array $data = []): bool
{
    // Birleştirin, değiştirmeyin: kısmi bir gönderim diğer anahtarları silmemelidir.
    $merged = array_replace_recursive($this->config ?: [], $data);

    // file_write() bir .php hedefinde opcode önbelleğini geçersiz kılar; kaydedilen
    // değerin daha bir sonraki istekte okunabilmesinin sebebi budur.
    return (bool) \FileManager::file_write(
        __DIR__ . DS . "config.php",
        \Utility::array_export($merged, ['pwith' => true])
    );
}

<?php
return [
    'api_key'   => '',
    'help-link' => 'https://example.com',
];