Modül Yapılandırması

return [
    'meta' => [
        'name'    => 'AcmeDomains',
        'version' => '1.0',
        'logo'    => 'logo.png',
    ],

    // Kodunuzun okuduğu her anahtarı güvenli bir varsayılanla gönderin. Yalnız ilk kayıttan
    // sonra beliren bir anahtar, kodunuzun her okumada korumak zorunda olduğu anahtardır.
    'settings' => [
        'username'      => '',
        'apiKey'        => '',
        'test-mode'     => 0,
        'nameservers'   => ['ns1.example.com', 'ns2.example.com'],
        'cost-currency' => 4,
    ],
];

// Servis sağlayıcı formu. Ekran bunu saklanan ayar bloğuyla çağırır, yani
// $data doludur. Ödeme geçidinde ya da eklentide aynı metot ARGÜMANSIZ çağrılır
// ve $data sessizce boş kalır: orada özelliği okuyun.
public function config_fields($data = []): array
{
    return [
        // ANAHTAR alan adıdır. 'name' ise ETİKETTİR.
        'username' => [
            'name'        => $this->lang['username'] ?? 'Username',
            'description' => $this->lang['username-desc'] ?? '',
            'type'        => 'text',
            'value'       => $data['username'] ?? '',
            'placeholder' => 'api-user',
        ],

        'apiKey' => [
            'name'  => $this->lang['api-key'] ?? 'API Key',
            'type'  => 'password',
            'value' => $data['apiKey'] ?? '',
        ],

        // Onay kutusu. 'checked' mevcut durumdur, gönderilen değer değil.
        'test-mode' => [
            'name'    => $this->lang['test-mode'] ?? 'Test Mode',
            'type'    => 'approval',
            'checked' => (bool) ($data['test-mode'] ?? false),
        ],

        // Yalnız yukarıdaki kutu işaretliyken gösterilir.
        'test-endpoint' => [
            'name'         => $this->lang['test-endpoint'] ?? 'Test Endpoint',
            'type'         => 'text',
            'value'        => $data['test-endpoint'] ?? '',
            'parent'       => 'test-mode',
            'parentEffect' => 'hide',
        ],

        'mode' => [
            'name'    => $this->lang['mode'] ?? 'Mode',
            'type'    => 'dropdown',
            'value'   => $data['mode'] ?? 'live',
            'options' => ['live' => 'Live', 'sandbox' => 'Sandbox'],
        ],
    ];
}

// Ortak trait; sunucu, servis sağlayıcı, ürün ve sosyal giriş modüllerinin kullandığı.
// $auto_status = true, dizi boş olmayan bir ayar bloğu taşıdığında modülü açar.
protected function save_config($data = [], $auto_status = true);

// Sunucu modülleri bunu daraltır: otomatik durum bayrağı yok, dönüş kesin boolean.
public function save_config($data = []): bool;

// Eklentiler de aynı şekilde daraltır ve ayrıca diziyi $this->config değerine atar.
public function save_config($data = []): bool;

// Hepsinin altta çağırdığı şey. Hedef .php ise derlenmiş kopyayı geçersiz kılar.
public static function file_write($file, $data = null, $mode = 'w', $flags = 0);

// Diziden kaynak koda. ['pwith' => true] onu eksiksiz bir PHP dosyası olarak sarar.
public static function array_export($array = [], $options = []);

// Platform yapılandırması, modül yapılandırması değil. Yapılandırma dizinindeki
// dosyalara eğik çizgili yollarla erişilir.
public static function get($arg = null);
public static function set($key, $values, $merge = false): array|false;
public static function save($name = '', $data = []): bool;

// Veritabanında tutulan ayarlar, ada göre anahtarlanmış. Modülün admin alanı
// kendi dosyası yerine bunları kullanır.
public static function getd($name = '');
public static function setd($name = '', $content = '');

public function controller_settings($extraFields = []): array
{
    // Formun gönderdiği her şey, tek anahtar altında, sizin tanım anahtarlarınızın adıyla.
    $fields = \Filter::POST("fields") ?: [];

    // Diskte zaten duranla başlayın: aşağıdaki yazma dosyanın tamamını değiştirir.
    $config = $this->config;

    $config['settings']['username']  = \Filter::html_clear((string) ($fields['username'] ?? ''));
    $config['settings']['mode']      = in_array($fields['mode'] ?? '', ['live', 'sandbox'], true)
        ? $fields['mode'] : 'live';

    // İşaretsiz bir kutu gönderide HİÇ YOKTUR, yani yokluk "kapalı" değeridir.
    $config['settings']['test-mode'] = (int) ($fields['test-mode'] ?? 0) === 1 ? 1 : 0;

    // Sırlar: girerken şifreleyin ve alan maskeli ya da boş geldiğinde saklanan değeri
    // koruyun; ekran değişmemiş bir sır için tam olarak bunu gönderir.
    $posted = (string) ($fields['apiKey'] ?? '');
    if ($posted !== '' && !str_starts_with($posted, '*'))
        $config['settings']['apiKey'] = $this->encode_str($posted);

    // Tam dosya yazması; derlenmiş kopyayı geçersiz kılan yönetici üzerinden.
    \FileManager::file_write($this->dir . 'config.php', \Utility::array_export($config, ['pwith' => true]));

    return ['status' => "successful", 'message' => \Language::gc("admin/ac-settings/successful1")];
}

private function credentials(): array
{
    $settings = $this->config['settings'] ?? [];

    return [
        // Her okumada null güvenli: modülünüzün eski bir sürümünden yükseltilmiş
        // bir sistemde anahtar eksik olabilir.
        'username' => (string) ($settings['username'] ?? ''),
        'apiKey'   => $this->decode_str((string) ($settings['apiKey'] ?? '')),
        'sandbox'  => (int) ($settings['test-mode'] ?? 0) === 1,
    ];
}

// Config() yalnız statik önbelleği okur, bu yüzden önce yükleme yapılmalıdır.
// Üçüncü argüman sınıf dosyasını işin dışında tutar.
$record = Modules::Load("Registrars", "AcmeDomains", true);

$mode = $record["config"]["settings"]["mode"] ?? 'live';

// Sır buradan okunamaz: çözme, örnek üzerindeki bir metottur.
// Açık değere ihtiyacınız varsa modülü kurun ve ona sorun.