Pano Widget'ı Ekleme

$hook = Hook::run("register:admin.dashboard_widgets");
if ($hook)
{
    $last = end($widgets);
    $rank = $last["rank"] ?? 10;

    foreach ($hook as $h)
    {
        $rank++;
        $wn = "wt" . $rank;

        if (isset($h["name"]) && $h["name"]) $wn = $h["name"];
        if (!isset($h["allowed"])) $h["allowed"] = true;
        if (!isset($h["status"])) $h["status"] = "open";
        if (!isset($h["rank"]))   $h["rank"]   = $rank;

        $widgets[$wn] = $h;                 // anahtar sizin adınızdır: yerleşik bir kartı DEĞİŞTİREBİLİR
    }
}

public function get_widget_content(Operation $operation): bool;

// GET {dashboard}?operation=get_widget_content&name={adınız}
$widgets = $this->get_widgets();                 // kanca dahil listenin TAMAMI yeniden kurulur
if (!isset($widgets[$wn])) throw new Exception("Invalid widget");

// Aynı kabuktan yeniden basılan tek bir kart, HTML dizesi olarak döner.
return $operation->output($this->view->chose("admin")->render("inc" . DS . "template-widget-item", [
    'widget' => $widgets[$wn],
], true));

$t = new \WISECP\Components\Table("myAddonWidget", [
    'preset'      => 'invoiceList',      // satır basımı ANA listeden gelir
    'hideActions' => true,
    'perPage'     => false,
    'search'      => false,
    'info'        => false,
    'pagination'  => false,
]);

foreach ($t->getColumns() as $k => $v) $t->setColumn($k, ['sortable' => false]);
$t->deleteColumn("selection");
$t->setRows($rows);

$html = $t->build();

<?php

Modules::Load('Addons', 'MyAddon', true);
$my_config = Modules::Config('Addons', 'MyAddon') ?: [];

if (!($my_config['status'] ?? false)) return;

/*
 * Panoda tek bir kart. Dinleyici argüman almaz ve TEK bir tanım döndürür; her pano
 * basımında ve bu kartın her yenilenmesinde koşar, bu yüzden ucuz kalır ve modül
 * örneğini ancak yetki kontrolü geçtikten sonra kurar.
 */
Hook::add('register:admin.dashboard_widgets', 10, function () {
    if (!Admin::isPrivilege('TOOLS_ADDONS')) return false;

    $module = Modules::getInstance('Addons', 'MyAddon');

    return [
        'name'    => 'myaddon_queue',
        'title'   => $module->lang['widget-title'] ?? 'My Addon Queue',
        'icon'    => 'bi bi-list-check',
        'rank'    => 6,
        'status'  => 'open',
        'link'    => LinkGenerator::admin('tools-2', ['addons', 'MyAddon']),
        'buttons' => [
            'create' => [
                'name' => Language::gc('admin/index/button-create-a-new'),
                'link' => LinkGenerator::wQS(LinkGenerator::admin('tools-2', ['addons', 'MyAddon']), ['trigger' => 'create']),
            ],
        ],
        'content' => $module->render_dashboard_widget(),
    ];
});

/* Şeritte bir rakam. Size verileni okuyun, bir anahtarı değiştirin, HEPSİNİ döndürün. */
Hook::add('filter:admin.dashboard.statistics', 10, function ($result) {
    if (!is_array($result)) return false;

    $result['static_blocks']['myaddon_pending'] = [
        'title' => 'Pending syncs',
        'value' => (int) WDB::select('COUNT(id) AS total')->from('MyAddon_queue')
            ->where('status', '=', 'pending')->build() ? (int) (WDB::getAssoc()['total'] ?? 0) : 0,
    ];

    return $result;
});

public function render_dashboard_widget(): string
{
    $rows = '';

    foreach ($this->queue_preview(5) as $row) {
        $label = htmlspecialchars((string) ($row['label'] ?? ''), ENT_QUOTES);
        $state = htmlspecialchars((string) ($row['status'] ?? ''), ENT_QUOTES);

        $rows .= <<<HTML
        <li class="list-group-item d-flex justify-content-between align-items-center px-0">
            <span class="text-truncate">{$label}</span>
            <span class="badge text-bg-light">{$state}</span>
        </li>
        HTML;
    }

    if ($rows === '')
        $rows = '<li class="list-group-item px-0 text-body-secondary">' . ($this->lang['widget-empty'] ?? 'Nothing queued.') . '</li>';

    // Rezerve edilen yüksekliği sınıf taşır (aşağıdaki stil dosyasına bakın); liste
    // dolduğunda tüm ızgaranın yeniden paketlenmesini engelleyen şey budur.
    return <<<HTML
    <ul class="list-group list-group-flush myaddon-queue">{$rows}</ul>
    HTML;
}

/* Nihai yükseklik, içerik var olmadan önce bildirilir. Kartı kaydeden aynı hooks.php
   dosyasından ui:admin.head.css üzerinden gönderin. */
.myaddon-queue { min-block-size: 220px; }

$w_name    = $widget["name"]  ?? "widget" . $w_rank;
$w_title   = ($widget["title"] ?? '') ?: 'Untitled Widget';
$w_icon    = ($widget["icon"]  ?? '') ?: 'bi bi-box';
$w_content = $widget["content"] ?? '';

if ($w_name == "orders_chart") {
    // ... yerleşik adlardan oluşan uzun bir zincir, her birine bir dal
}
else
    echo $w_content ?: $w_name;      // kaçırılmamış HTML'iniz, ya da unuttuysanız ad