Çeviriler ve Dil Dosyaları

public static function g($key = '', $replaces = [], $slang = ''): string|int|array|bool;
public static function gc($name = '', $replaces = [], $slang = ''): string|int|array|bool;
public static function selected(): string;

// Instance metot, singleton üzerinden çağrılır: Language::$init->rank_list()
public function rank_list($status = 'active'): array;

// İki statik yardımcının devrettiği instance metotlar. Argüman sırasına dikkat:
// get() dili ikinci sıraya, get_cm() değiştirmeleri ikinci sıraya alır.
public function get($arg = null, $slang = '', $replaces = []): string|int|array|bool;
public function get_cm($arg = null, $replaces = [], $slang = ''): string|int|array|bool;

// coremio/locale/tr/cm/admin/departments.php
return [
    'error1'  => '{lang} dili için ad zorunludur.',

    // content/variables biçimi hangi yer tutucuların olduğunu bildirir.
    // Aramalar content dizesini döndürür, sarmalayıcıyı asla.
    'welcome' => [
        'content'   => 'Merhaba {name}, {count} mesajınız var.',
        'variables' => '{name},{count}',
    ],
];

// Çağrı. Anahtarlar kendi parantezlerini taşır; ':name' biçimi de aynı çalışır.
$msg = Language::gc("admin/departments/error1", ['{lang}' => "TR"]);      // "TR dili için ad zorunludur."
$hi  = Language::gc("admin/departments/welcome", ['{name}' => $name, '{count}' => 3]);

// Üçüncü argüman, hizmet edilen dil yerine tek bir dili zorlar.
$en  = Language::gc("admin/departments/error1", ['{lang}' => "EN"], "en");

// Language::$init->rank_list()          açık diller, rank sırasıyla
[
    'rank' => 2, 'local' => 0, 'selected' => true, 'key' => 'en',
    'name' => 'English', 'global-name' => 'English',
    'link' => 'https://example.test/en/services',        // bu sayfanın o dildeki adresi
    'cc' => '', 'cname' => 'Worldwide', 'pc' => 1,
    'flag-img' => 'https://example.test/resources/assets/images/flags/en.svg',
];

// Language::$init->rank_list("all")     kurulu her dil, paket kaydı
// Kaydın tamamı, bu sırayla. 'key' ve 'country-name' çağrının kendisi tarafından
// eklenir; 'local' paket bayrağından değil general/local'dan (kurulumun varsayılan
// dili) türetilir; geri kalanı paket dosyasının diskteki hâlidir.
[
    'create-date' => '2018-06-21 10:15:48',
    'name' => 'English', 'show-name' => 'English',
    'country-id' => 0, 'country-code' => '',
    'code' => 'en', 'code-hyphen' => 'en_US',
    'scharacters' => '', 'charset-code' => 'UTF-8',
    'phone-code' => 1, 'currency' => 1, 'rank' => 2,
    'permalink' => true, 'prefix' => 'enabled', 'status' => true,
    'local' => false, 'rtl' => false,
    'key' => 'en', 'country-name' => 'Worldwide',
];

public static function plural(string $key, int|float $n, array $replaces = [], string $slang = ''): string;
public static function plural_set(string $key, string $slang = ''): array;
public static function plural_category(int|float $n, string $slang = ''): string;

public static function form_langs(array $defined = []): array;
public static function posted_langs(): array;
public static function removed_langs(): array;

// Paketi zaten yüklü bir ekranın içinde.
$title = Language::g("needs/button-save");

// Başka her yerde: önce dosya, sonra anahtar.
throw new Exception(Language::gc("admin/services/error-not-found"));

// Hizmet edilen dil için çeviri tablosunu join etme.
$lang  = Language::selected();
$rows  = WDB::select("t1.id, COALESCE(t2.name, t1.name) AS name")
    ->from("products AS t1")
    ->join("LEFT", "products_lang AS t2", "t2.owner_id=t1.id AND t2.lang='" . $lang . "'")
    ->build();

// Dil değiştirici.
foreach (Language::$init->rank_list() as $l)
    $items[] = ['label' => $l["name"], 'href' => $l["link"], 'on' => $l["selected"]];

// coremio/locale/tr/cm/admin/services.php   ve aynı anahtar diğer her dilde
return [
    'page-list'        => 'Hizmetler',
    'error-not-found'  => 'Hizmet bulunamadı.',

    // İç içe, yani yolu admin/services/errors/timeout olur
    'errors' => [
        'timeout' => 'Sağlayıcı zaman aşımına uğradı.',
    ],
];

// Bir ekran dil dosyasını düzenlediğinde koddan geri yazılır.
Language::save("admin/services", $data, "tr");