Modül Dil Dosyaları

coremio/modules/{Type}/{Name}/lang/
├── en.php     # kendi dosyası olmayan her dil için geri düşülen dosya
├── tr.php     # aynı anahtarlar, çevrilmiş
└── de.php     # desteklediğiniz dil başına bir dosya ekleyin; kod, dosya adıdır

return [
    // Platformun okuduğu: modül listesindeki etiket ve tanıtım cümlesi.
    'name'        => 'Acme Domains',
    'description' => 'Domain registration through the Acme API. An API key is required.',

    // Sizin. Uzun bir dosyada gezinmek kolay kalsın diye bunları bir önekle gruplayın.
    'username'      => 'Username',
    'username-desc' => 'The API account this installation connects with.',
    'api-key'       => 'API Key',
    'test-mode'     => 'Test Mode',

    'error-no-domain' => 'No domain name is bound to this service.',
    'error-refused'   => 'The provider refused the request.',

    // Yer tutucular konumsaldır ve değerleri çağıran taraf geçer.
    'error-locked' => 'The domain %s is locked and cannot be transferred.',
];

// Tam olarak tek bir dosya dahil edilir. İngilizceyle anahtar bazında birleştirme yoktur.
if (file_exists($path . 'lang' . DS . $lang . '.php'))
    $strings = include $path . 'lang' . DS . $lang . '.php';
elseif (file_exists($path . 'lang' . DS . 'en.php'))
    $strings = include $path . 'lang' . DS . 'en.php';

// İkisi de yoksa: özellik boş bir dizidir ve her okuma kendi varsayılanına düşer.

// Modül metinleri. Dosyayı kendisi yükler, yani önceden bir yükleme çağrısı gerekmez.
// $lang, 'en' ya da 'tr' gibi bir dil kodudur; boş bırakmak "sen çöz" demektir.
public static function Lang($type, $module, $lang = '');

// Modül yapılandırması. YALNIZ statik önbelleği okur: kimse yüklemediyse null döner.
// Lang() ile arasındaki bu asimetri, ikilinin en şaşırtıcı yanıdır.
public static function Config($type, $module);

// Görünen etiket: lang['name'], sonra config['name'], sonra dizin adı.
// Yüklemeyi sizin yerinize yapar.
public static function getName(string $type, string $module): string;

// Platform metinleri, modül metinleri DEĞİL. Modül bunları yalnız ortak ifadeler için kullanır.
public static function g($key = '', $replaces = [], $slang = ''): array|string|int|bool;
public static function gc($name = '', $replaces = [], $slang = ''): array|string|int|bool;
public static function selected(): string;

// lang/en.php
return [
    'name'            => 'Acme Domains',
    'description'     => 'Domain registration through the Acme API.',
    'api-key'         => 'API Key',
    'api-key-desc'    => 'Found under Account, API in the provider panel.',
    'error-locked'    => 'The domain %s is locked and cannot be transferred.',
    'addon-privacy'   => 'WHOIS Privacy',
];

// lang/tr.php : AYNI anahtarlar, aynı sırada, değerler çevrilmiş.
return [
    'name'            => 'Acme Alan Adları',
    'description'     => 'Acme API üzerinden alan adı kaydı.',
    'api-key'         => 'API Anahtarı',
    'api-key-desc'    => 'Sağlayıcı panelinde Hesap, API altında bulunur.',
    'error-locked'    => '%s alan adı kilitli ve transfer edilemez.',
    'addon-privacy'   => 'WHOIS Gizliliği',
];

public function config_fields($data = []): array
{
    return [
        'apiKey' => [
            // Her zaman varsayılanla: bu anahtar var olmadan önce gönderilmiş bir çeviri
            // aksi halde boş bir etiket basardı.
            'name'        => $this->lang['api-key'] ?? 'API Key',
            'description' => $this->lang['api-key-desc'] ?? '',
            'type'        => 'password',
            'value'       => $data['apiKey'] ?? '',
        ],
    ];
}

public function transfer(): array|bool
{
    if ($this->is_locked()) {
        // Yer tutucu dil dosyasında yaşar; değer burada uygulanır,
        // böylece çevirmen iki parça yerine cümlenin tamamını görür.
        $message = sprintf(
            $this->lang['error-locked'] ?? 'The domain %s is locked.',
            (string) ($this->service['domain'] ?? ''),
        );

        throw new \Exception($message);
    }

    // Platform metni, modül metni değil: bu ifade panelin geri kalanıyla paylaşılır
    // ve bu modülün dosyalarına ait değildir.
    if (!$this->credentials()['apiKey'])
        throw new \Exception(\Language::gc("admin/modules/error-missing-credentials"));

    // Başarıda status döndürmeyin: taban sınıf gönderilen transferi inprocess durumuna alır.
    return true;
}

return [
    'addon-params' => [
        // Durağan veri; ekran render ederken lang/ dizinine karşı çözülür.
        'whois_privacy' => [
            'label'       => '{lang.addon-privacy}',
            'description' => '{lang.addon-privacy-desc}',
            'type'        => 'toggle',
        ],
    ],
];