Arayüz Bileşenleri

public function __construct(string $name, array $options = []);   // $name = preset dosya adı

public function setColumns(array $columns): self;
public function setColumn(string $key, array $data): self;
public function deleteColumn(string $key): self;
public function setRows(array $rows): self;
public function setRowRender(callable $renderRow): self;
public function setFilters(array $filters): self;
public function setOptions(array $options): self;
public function getOptions(): array;

public function isRequestAjax(): bool;
public function ajaxControl(array $options = []): string;
public function allDataAjaxResponse(): string;
public function ajaxResponse(int $totalEntries = 0, int $totalSearchEntries = 0): string;

public function build(string $format = ''): string;        // '' = tüm tablo, 'justBody' = yalnız satırlar
public function buildList(string $format = ''): string;    // ızgara yerine kart satırları
public function container(string $content, array $attributes = []): string;
public function exportButton(array $options = []): string; // ['label', 'formats', 'class']

// Genel property'ler. İki model, bileşenin kendisinin çağırdığı closure'lardır.
public int $ajax_transition_limit = 500;
public mixed $totalModel;   // fn (string $search = '', array $filters = []): int
public mixed $dataModel;    // fn (string $search = '', string $order = '', string $direction = '', int $start = 0, int $end = -1): array

$row = [
    // Kaydın modelden geldiği hali. Salt-okunur girdi.
    'model' => ['id' => 5, 'name' => 'example.com', 'status' => 'active'],

    // Kolon anahtarı başına bir giriş. 'value' hücre işaretlemesi, 'attributes' <td>'ye iner.
    // 'data-value' sıralamanın ve istemci tarafı filtrelemenin karşılaştırdığı HAM değerdir.
    'data' => [
        'id'     => ['value' => '<a href="...">#5</a>', 'attributes' => ['data-value' => 5]],
        'status' => ['value' => '<span class="badge">Aktif</span>', 'attributes' => ['data-value' => 'active']],
    ],

    // <tr> attribute'ları. Satır seviyesi filtre değerleri buradan okunur.
    'attributes' => ['class' => 'table-tr-bg-info', 'data-filter-status' => 'active'],
];

// Tab. $type 'horizontal' ya da 'vertical'. add() İKİ argüman alır:
// panel anahtarı, sonra bir seçenek dizisi. Panel gövdesi $options['content']'tir.
public function __construct($name = '', $type = 'horizontal');
public function add($name, $options = []): self;
public function set($name, $options = []): self;                 // add() ile aynı
public function get($name = '');
public function remove($name = ''): self;
public function noUrl(bool $noUrl = true): self;
public function render(array $options = [], string $header = '', string $contents = ''): string;
public function header($options = []): string;
public function contents(array $options = []): string;

// Accordion. Aynı fikir, tipli, ve dikey/yatay seçimi yok.
public function __construct(string $name = '');
public function add(string $name, array $options = []): self;
public function set(string $name, array $options = []): self;
public function get(string $name = '');
public function remove(string $name): self;
public function noUrl(): self;
public function render(array $options = []): string;

// Her şey kurucuda verilir; setter'lar sonradan değiştirmek içindir
// ve void döndükleri için ZİNCİRLENMEZLER.
public function __construct(array $params);
public function setTitle(string $title): void;
public function setBody(string $body): void;
public function setFooter(string $footer): void;
public function setForm(?array $formAttributes): void;   // attribute haritası, sarmayı kaldırmak için null
public function setHeaderClasses(array $classes): void;
public function render(): string;

$table = new \WISECP\Components\Table('widgetList', ['exportName' => 'widgets']);

// Operatörün seçtiği değerler. setFilters bunları veri isteğinde taşır;
// model ise yalnız bir isteği yanıtlarken alır.
$dynamic = [];
if ($status = Filter::init("REQUEST/filter/status", "route")) $dynamic['status'] = $status;

$table->setFilters($dynamic);
$filter = $table->isRequestAjax() ? $dynamic : [];

$table->totalModel = fn ($search = '', $filters = []) =>
    $this->model->list(true, array_merge($filter, $filters, ['word' => $search]));

$table->dataModel = fn ($search = '', $order = '', $direction = '', $start = 0, $end = -1) =>
    $this->model->list(false, array_merge($filter, ['word' => $search]), [$order => $direction], $start, $end);

// Boş olmayan dönüş, isteğin burada zaten yanıtlandığı anlamına gelir.
if ($response = $table->ajaxControl(['baseLink' => $links["controller"]])) return $response;

$this->addData('table', $table);

/** @var \WISECP\Components\Table $table */
if (!isset($table)) return;

$table->setColumns([
    'id'     => ['title' => 'ID', 'attributes' => ['class' => 'text-center'], 'sortable' => true],
    'name'   => ['title' => Language::gc("admin/widgets/th-name"), 'sortable' => true],
    'status' => ['title' => Language::gc("admin/widgets/th-status"), 'sortable' => "asc"],
    'email'  => ['title' => Language::gc("admin/widgets/th-email"), 'exportOnly' => true],
]);

$table->setRowRender(function ($row) {
    $id = (int) $row["model"]["id"];

    $row["data"]["id"]["value"]                     = '<a href="?id=' . $id . '">#' . $id . '</a>';
    $row["data"]["id"]["attributes"]["data-value"]  = $id;

    $row["data"]["name"]["value"] = htmlspecialchars($row["model"]["name"] ?? '');

    // Filtrenin karşılaştırdığı ham değerdir; hücre rozeti gösterir.
    $row["data"]["status"]["value"]                    = \WISECP\AdminComponents\Statuses::getInstance()->service($row["model"]["status"]);
    $row["data"]["status"]["attributes"]["data-value"] = $row["model"]["status"];

    // Ekranda çizilmez, indirmede vardır.
    $row["data"]["email"]["value"] = $row["model"]["email"] ?? '';

    $row["attributes"]["data-filter-status"] = $row["model"]["status"];

    return $row;
});

// Sayfa şablonu basmadan hiçbir şey görünmez. Preset zaten kurucunun içinde çalıştı,
// bu çağrı yalnız controller ile preset'in kurduğunu render eder.
if (isset($table)) {
    $table->setOptions(['containerExtraClass' => 'mt-3']);
    echo $table->build();
}

// footer.php $modals içinde ne varsa basar; şablon onu bir kez burada tanımlar
// ve sayfadaki her pencere üzerine ekler.
$modals = '';

$tab = new \WISECP\Components\Tab('widget-detail');

$tab->add('overview', [
    'title'   => Language::g('widgets-overview'),
    'icon'    => 'bi bi-grid-1x2',
    'content' => $overviewHtml,
]);

// Koşul BURADA, bir kez. Paneli okuyan biri sekmenin bir şey düştüğü için değil
// bu kural yüzünden görünmediğini böylece bilir.
if ((int) Config::get('options/reselling/status') === 1)
    $tab->add('reselling', [
        'title'   => Language::g('widgets-reselling'),
        'badge'   => $pendingCount,
        'content' => $resellingHtml,
    ]);

echo $tab->render();

$modal = new \WISECP\Components\Modal([
    'id'                    => 'widgetDeleteModal',
    'title'                 => Language::g('needs/delete'),
    'body'                  => '<p>' . Language::gc('admin/widgets/delete-confirm') . '</p>'
                             . '<input type="hidden" name="operation" value="delete_widget">',
    'footer'                => '<button type="submit" class="btn btn-danger">' . Language::g('needs/delete') . '</button>',
    'headerClasses'         => ['bg-danger'],
    'modalDialogExtraClass' => 'modal-lg',
    'form'                  => ['action' => $links["controller"], 'method' => 'POST'],
]);

$modals .= $modal->render();