Modül Varlıkları ve Logo

coremio/modules/{Type}/{Name}/
├── logo.svg            # panel simgesi. Modül KÖKÜ, assets/ değil
└── assets/
    ├── style/          # css
    ├── js/             # javascript
    └── images/         # arayüzünüzün İÇİNDE kullanılan görseller, asla logo değil

// Örnek üzerinde: bu modülün kendi adı ve tipi için çözer.
public function logo(): string;

// Elinizde örnek yokken statik olarak. Tip VARSAYILANINA dikkat: onu atlayan bir çağrı
// modülü bir sunucu modülü olarak arar.
public static function logo(string $name = '', $type = 'Servers'): string;

// Bu dosya, modül etkin olsun olmasın, HER istekte koşar. Burada yalnız kayıt yapın.
$acme_on_page = fn () => in_array(Controllers::$cname ?? '', ['tickets', 'services'], true);

Hook::add('ui:admin.head.css', 1, function () use ($acme_on_page) {
    if (!$acme_on_page()) return '';

    $m = Modules::getInstance('Addons', 'Acme');

    // Diskteki dosya için dir, işaretlemedeki adres için url.
    $v = @filemtime($m->dir . 'assets' . DS . 'style' . DS . 'app.css') ?: ($m->config['meta']['version'] ?? '1.0');

    return '<link rel="stylesheet" href="' . $m->url . 'assets/style/app.css?v=' . $v . '">';
});

Hook::add('ui:admin.head.js', 1, function () use ($acme_on_page) {
    if (!$acme_on_page()) return '';

    $m    = Modules::getInstance('Addons', 'Acme');
    $lang = $m->lang;

    // Betiğin ihtiyaç duyduğu her şey, tek seferde kodlanır. Kaçış bayrakları önemlidir:
    // bu dize bir HTML belgesinde script etiketinin içine basılır.
    $config = Utility::jencode([
        'endpoint' => Controllers::$init->ControllerURI(),
        'i18n'     => [
            'run'    => $lang['btn-run'] ?? 'Run',
            'failed' => $lang['err-failed'] ?? 'Request failed',
        ],
    ], JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT);

    $v = @filemtime($m->dir . 'assets' . DS . 'js' . DS . 'app.js') ?: ($m->config['meta']['version'] ?? '1.0');

    return '<script>window.Acme = ' . $config . ';</script>'
         . '<script src="' . $m->url . 'assets/js/app.js?v=' . $v . '"></script>';
});

(function () {
    var cfg = window.Acme;
    if (!cfg) return;                     // varlık, ait olmadığı bir sayfada yüklendi

    document.querySelectorAll('[data-acme-run]').forEach(function (btn) {
        btn.textContent = cfg.i18n.run;
        btn.addEventListener('click', () => WcpRequest(cfg.endpoint, {
            data: { operation: 'use_addon_method', method: 'run', id: btn.dataset.acmeRun },
        }));
    });
})();

return [
    'meta' => [
        'name'    => 'Acme',
        'version' => '1.0',

        // Modül dizinine göre çözülür. Alt yol serbesttir; protokolle başlayan
        // bir adres ise yazıldığı gibi kullanılır.
        'logo'    => 'assets/images/brand.svg',
    ],
];