Çekirdeğe Dokunmadan Çalışma

Acme.php            # çekirdeğin örneklediği modül sınıfı
config.php          # ayarlar; modül yazar, bir sürüm asla yazmaz
hooks.php           # otomatik dahil edilir: her Hook::add burada yaşar
router.php          # admin yönlendirmesi için otomatik dahil edilir: admin alanını kaydeder
AdminArea.php       # size ait admin sayfaları
lang/en.php         # metinleriniz, istediğiniz gibi anahtarlanmış
cronjobs/Sync.php   # zamanlanmış işleyiciniz, hooks.php'den kaydedilir
src/AcmeClient.php  # size ait düz sınıflar, `new` ile kurulur

// coremio/classes/Hook.php
public static function add($name, $priority, $properties = []): void;

// coremio/classes/Modules.php - sınıfı dahil etmeden yapılandırmayı yükler ($nominc = true),
// sonra okur. hooks.php içinde ucuz bir "modülüm açık mı?" kapısı için ikisi de gerekir.
public static function Load($type = '', $name = '', $nominc = false, $status = '');
public static function Config($type, $module);
public static function getInstance(string $type, string $name, array $params = []): ?object;

// coremio/classes/ModuleAdminArea.php - modülün router.php dosyasından çağrılır.
public static function register(string $areaClass): void;
public static function get(string $type, string $name): ?array;

// coremio/helpers/CronJobQueue.php - bir register:cronjobs dinleyicisinden çağrılır.
public static function register(string $type, string $handlerClass): void;
public static function dispatch(string $type, array $payload = [], array $opts = []): int;

// coremio/cronjobs/CronJobHandler.php - bir ARAYÜZDÜR, yani genişletmeyin, uygulayın.
// Başarı için true, başarısız olup yeniden denenmek için false, ya da admin Sonuçlar
// sekmesine bir yük de vermek için ['success' => bool, 'result' => array] döndürün.
public function handle(array $payload, array $job): bool|array;

// [0] METHOD    [1] desen (/api/v1 sonrasındaki tam yol, {x} yakalar)
// [2] Group     [3] Action   [4] public?  [5] authOnly?  [6] audience
$routes[] = ['GET', 'acme/status', 'Module:Addons/Acme', 'status', false, true, 'admin'];

// "Module:{Type}/{Name}" grubu, modül örneğinin şu metoduna dağıtır
//   api_{Action}(WISECP\Api\Core\Request $request, array $match)
// ve kararı method_exists verir: __call yedeği yoktur. [3] içindeki bir yazım hatası
// görebileceğiniz bir hata değil, 404'tür.
//
// [4] public = true   → hiç kimlik bilgisi yok; modül kendi erişimini kendi denetler
// [5] authOnly = true → geçerli bir kimlik bilgisi yeter, kapsam kontrol edilmez (serbest
//                       yüzeydeki varsayılan, çünkü modül kapsamları katalogda değildir)
// [6] audience        → 'admin' | 'client' | 'any', yalnız public false iken bakılır

<?php

// Ucuz kapı: yalnız yapılandırma, sınıf dahil edilmez. Aşağıdaki her şey if'in içinde,
// yani kapalı bir modül hiçbir şey kaydetmez ve yalnız bir dosya okuması kadar tutar.
Modules::Load('Addons', 'Acme', true);
$acme = Modules::Config('Addons', 'Acme') ?: [];

if ($acme['status'] ?? false) {

    // 1. Bu modülün sahibi olmadığı bir sayfadaki AJAX eylemi. services controller'ında
    //    operation=acme_resync olarak ulaşılır. Bu çağrıyı hiçbir şey sarmalamaz,
    //    yani yetki kontrolünü yapmak bize düşer.
    Hook::add('register:admin.operations', 1, function ($cname, $operation) {
        if ($operation !== 'acme_resync')       return null;
        if ($cname !== 'services')              return null;
        if (!Admin::isPrivilege(['SERVICES_OPERATION']))
            return ['status' => 'error', 'message' => Language::gc('acme/no-privilege')];

        return Modules::getInstance('Addons', 'Acme')->resync_request();
    });

    // 2. Kimlik bilgisi isteyen admin yüzeyinde bize ait bir uç.
    Hook::add('filter:api.routes', 1, function (&$routes, &$audience) {
        if ($audience !== 'admin') return;
        $routes[] = ['GET', 'acme/status', 'Module:Addons/Acme', 'status', false, true, 'admin'];
    });

    // 3. Zamanlanmış bir görev. Dosya açılışta değil burada dahil edilir: cron kaydı
    //    yalnız çekirdek dizinini tarar.
    Hook::add('register:cronjobs', 1, function () {
        include_once __DIR__ . DS . 'cronjobs' . DS . 'Sync.php';
        CronJobQueue::register(\WISECP\Modules\Addons\Acme\CronJobs\Sync::TYPE,
                               \WISECP\Modules\Addons\Acme\CronJobs\Sync::class);
    });

    // 4. Bir dil dosyasını düzenlemeden tek bir bileşen metnini yeniden ifade edin.
    //    Referansla ve yalnızca ifadesinin sahibi olduğumuz tam anahtar için.
    Hook::add('filter:i18n.translation', 1, function (&$text, $key, $lang) {
        if ($key !== 'admin/services/status-active') return;
        $text = Language::gc('acme/status-live');
    });
}

public function resync_request(): array
{
    $id = (int) Filter::init('POST/id', 'rnumbers');
    if (!$id) return ['status' => 'error', 'message' => Language::gc('acme/id-required')];

    // Fırlatmak, modülün başarısızlığı bildirme yoludur; burada bir AJAX çağrısını
    // doğrudan yanıtlıyoruz, dolayısıyla hatayı bunun yerine elle şekillendiriyoruz.
    try {
        $rows = $this->client()->resync($id);
    }
    catch (\Throwable $e) {
        return ['status' => 'error', 'message' => $e->getMessage()];
    }

    return ['status' => 'successful', 'message' => Language::gc('acme/resynced'), 'count' => $rows];
}

// Yukarıda kaydedilen API ucu buraya iner. Ad, api_ artı demetteki Action'dır
// ve kararı veren tek şey method_exists'tir.
public function api_status(\WISECP\Api\Core\Request $request, array $match): array
{
    return ['data' => ['enabled' => true, 'last_sync' => Config::getd('acme_last_sync')]];
}

// coremio/modules/Addons/Acme/router.php
namespace WISECP\Modules\Addons\Acme;

include_once __DIR__ . DS . 'AdminArea.php';

\ModuleAdminArea::register(AdminArea::class);

// coremio/modules/Addons/Acme/AdminArea.php
namespace WISECP\Modules\Addons\Acme;

class AdminArea extends \ModuleAdminArea
{
    public static function manifest(): array
    {
        return [
            'title'      => 'Acme',
            'slug'       => 'acme',
            'privileges' => ['TOOLS_ADDONS'],
            'menu'       => ['path' => ['TOOLS'], 'name' => 'Acme'],
        ];
    }

    // /{admin}/acme          → page_home()
    // /{admin}/acme/report   → page_report()
    public function page_home(array $params): string|array
    {
        return ['content' => '<p>Acme</p>', 'page_title' => 'Acme'];
    }

    // Aynı adrese operation=refresh ile POST
    public function op_refresh(\Operation $operation): bool
    {
        $operation->demo();

        return $operation->output(['status' => 'successful']);
    }
}