Özel Alan Ekleme

// Upsert. $values bir ad => değer haritasıdır; özel alanın adı "field_{id}" biçimindedir.
// En az bir satır yazıldığında true döner.
public static function AddInfo($owner_id = 0, $values = []);
public static function setInfo($owner_id = 0, $values = []);   // AddInfo takma adı

// Okuma. $names bir dizidir (virgüllü dize de kabul edilir ve bölünür).
// İSTENEN HER ad dönen haritada bulunur; satırı olmayan ad null okunur.
// $noCache = true istek-içi hafızayı atlar; yazdıktan hemen sonra buna ihtiyacınız olur.
public static function getInfo($owner_id = 0, $names = [], $noCache = false): array;

// Satırları tamamen kaldırır. $name tek bir ad ya da ad dizisidir.
public static function deleteInfo($owner_id = 0, $name = ''): int|bool;

// Var olan bir değerin satır id'si, yoksa 0.
public static function isInfo($owner_id = 0, $name = ''): int;

// Ters arama: bu değeri hangi müşteriler taşıyor. $first = true tek satır döndürür.
public static function findInfo($name = '', $value = '', $first = true): array;

// Bütünlük kapısı. Hâlâ boş olan her şey için [alan anahtarı => etiket] döner;
// boş dizi, hesabın müşteri panelini kullanabileceği anlamına gelir.
public static function missing_required_fields($id = 0): array;

// User::AddInfo() içinden, insert ya da update'ten hemen önce ateşlenir.
// $value      mixed, referansla. Burada bıraktığınız şey saklanır.
// $field_id   int, "field_5" içinden ayrıştırılan tanım id'si.
// $owner_id   int, değerin ait olduğu müşteri.
Hook::add('filter:custom_field.save_value', 10, function (&$value, $field_id, $owner_id) {
    // ...
});

// User::getInfo() içinden, satırlar toplandıktan sonra ve dönüşten önce ateşlenir.
// Aynı üç argüman, aynı sıra.
Hook::add('filter:custom_field.load_value', 10, function (&$value, $field_id, $owner_id) {
    // ...
});

// Departman ekseni, talep OLUŞTURMA formu kullanır. $did = 0 her alanı döndürür.
// Satırlar yerelleştirilmiş name, description, type, properties, options ve
// department_name taşır. Sıra: did DESC, sonra rank ASC.
public static function custom_fields($lang = '', $did = 0, $status = '');

// Erişim grubu ekseni, YANIT oluşturucunun erişim bilgisi satırları kullanır. Grubun
// kendi virgüllü alan id listesini okur ve alanları TAM O SIRAYLA döndürür; bu, operatörün
// sürükle bırakla belirlediği sıradır. Boş grup [] döndürür.
public static function custom_fields_by_group($lang = '', $groupId = 0, $status = 'active');

// Seçiciyi kurmak için grupların kendisi.
public static function access_groups($lang = '', $status = 'active');
public static function get_access_group($id = 0, $lang = '', $select = '');

// Aynı mantıksal alanın, kurulu her dildeki tanım id'leri. Bir müşteri alanı dil başına
// bir satırdır, yani tek bir etiket birden çok id'ye karşılık gelir.
const ACME_TAX_FIELD_IDS = [11, 12];

Hook::add('filter:custom_field.save_value', 10, function (&$value, $field_id, $owner_id) {
    if (!in_array($field_id, ACME_TAX_FIELD_IDS, true)) return;

    $value = trim((string) $value);
    if ($value === '') return;                      // boş cevap boş kalır

    $value = Crypt::encode($value, Config::get('crypt/system') . '_ACME_TAX');
});

Hook::add('filter:custom_field.load_value', 10, function (&$value, $field_id, $owner_id) {
    if (!in_array($field_id, ACME_TAX_FIELD_IDS, true)) return;
    if ((string) $value === '') return;

    // decode(), bu dinleyici var olmadan önce yazılmış bir değerde false döner; bu yüzden
    // üyenin cevabını boşaltmak yerine özgün metin korunur.
    $plain = Crypt::decode((string) $value, Config::get('crypt/system') . '_ACME_TAX');
    if ($plain !== false) $value = $plain;
});

$uid = 42;

// İstediğiniz adları isteyin. Her ad geri döner, satırı olmayanlar null olarak.
$info = User::getInfo($uid, ['field_11', 'gsm']);
$tax  = (string) ($info['field_11'] ?? '');

// Çok seçimli bir alan, virgülle birleştirilmiş tek bir dizedir; ayırmayı siz yapın.
$picked = array_values(array_filter(explode(',', (string) ($info['field_12'] ?? ''))));

// Yazma. Aynı adlar, aynı "field_{id}" kuralı.
User::setInfo($uid, ['field_11' => 'GB123456789']);

// Okuyucu istek başına hafızaya alır; yazdıktan sonra üçüncü argümanla yeniden okuyun.
$fresh = User::getInfo($uid, ['field_11'], true);

// Bir satırı kaldırmak, boş dize yazmakla aynı şey değildir: hesabı hiç cevap vermemiş
// gibi gösteren yalnızca kaldırmadır.
if ($tax === '') User::deleteInfo($uid, ['field_11']);

$ids = [];

foreach (['en' => 'VAT Number', 'tr' => 'Vergi Numarası'] as $lang => $label) {
    $ids[$lang] = WDB::insert('users_custom_fields', [
        'lang'          => $lang,
        'type'          => 'text',       // text | textarea | select | checkbox | radio
        'name'          => $label,
        'status'        => 'active',     // DİZE, aşağıdaki her bayrağın aksine
        'required'      => 0,
        'uneditable'    => 0,
        'client_hidden' => 0,
        'invoice'       => 1,
        'signForm'      => 1,
        'options'       => '',           // virgülle ayrılmış; select/checkbox/radio için
        'rank'          => 90,
    ]) ? WDB::lastID() : 0;
}

// Id'leri saklayın: alana giden tek kararlı tutamaktır ve dil başına farklıdır.
Config::setd('acme_vat_field_ids', Utility::jencode($ids));