Modülden Kanca Kaydetme

class Hook
{
    // $properties YA bir callable YA da bir tanım dizisidir (aşağıdaki üç biçime bakın).
    public static function add($name, $priority, $properties = []): void;

    public static function run($name, ...$args): array;        // değerle
    public static function runRefs($name, &...$args): array;   // HER argüman referansla
    public static function runDetailed($name, ...$args): array; // dinleyici başına telemetri
}

// 1. Closure. Çağrılabilir olan her şey doğrudan girer.
Hook::add('action:service.created', 10, function ($id, $data) {
    // ...
});

// 2. Örnek metodu. Sınıf argümansız olarak BİR KEZ kurulur ve istek boyunca
//    önbellekte tutulur, bu yüzden yapıcısı parametresiz çalışmalıdır.
Hook::add('filter:invoice.totals', 10, [
    'class'  => 'MyAddonHooks',
    'method' => 'adjustTotals',
]);

// 3. Statik metot. Hiçbir şey kurulmaz.
Hook::add('ui:admin.service_detail.bottom', 10, [
    'class'          => 'MyAddonHooks',
    'method::static' => 'renderPanel',
]);

// Dinleyicinizin $i konumunda bildirdiği her parametre için:
//   referansla bildirilmiş VE $i konumunda argüman var  -> referansla geçirilir
//   $i konumunda argüman var                            -> değerle geçirilir
//   $i konumunda argüman yok                            -> parametre düşürülür,
//                                                          yani varsayılanınız geçerli olur
$callArgs = [];
foreach ($reflection->getParameters() as $i => $param) {
    if ($param->isPassedByReference() && isset($args[$i])) $callArgs[] = &$args[$i];
    else if (isset($args[$i])) $callArgs[] = $args[$i];
}

// $nominc = true, sınıfı dahil ETMEDEN yapılandırmayı ve dil dosyasını yükler.
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;

Modules::Load('Addons', 'MyAddon', true);              // yalnız yapılandırma, sınıf yok
$my_config = Modules::Config('Addons', 'MyAddon') ?: [];

if (($my_config['status'] ?? false) && License::valid_addon('my-addon')) {
    // ... dinleyicileri burada kaydedin
}

<?php

// src/ sınıfları otomatik yüklenmez: bu dosyanın andığı şeyi, anmadan önce include edin.
include_once __DIR__ . DS . 'src' . DS . 'Notifier.php';

use WISECP\Modules\Addons\MyAddon\Src\Notifier;

// Sınıfsız yapılandırma. Tek ucuz çağrı, aşağıda bir şey kaydedilip kaydedilmeyeceğine karar verir.
Modules::Load('Addons', 'MyAddon', true);
$my_config = Modules::Config('Addons', 'MyAddon') ?: [];

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

/* Bir olay. Bu kanca ($id, $data) ile tetiklenir: yeni users_products kimliği ve eklenen
   satır. Dönüş değeri yoksayılır, yani işi yapın ve hiçbir şey söylemeyin. */
Hook::add('action:service.created', 10, function ($id, $data) {
    Notifier::service_created((int) $id, is_array($data) ? $data : []);
});

/* Bir değer. $totals REFERANSLA bildirilir, çünkü bu kanca runRefs ile tetiklenir;
   $invoice ve $items salt okunur bağlamdır. */
Hook::add('filter:invoice.totals', 10, function (&$totals, $invoice, $items) {
    if ((int) ($invoice['legal'] ?? 0) !== 1) return;

    $fee = (float) ($GLOBALS['my_addon_fee'] ?? 0);
    if ($fee <= 0) return;

    $totals['total'] = round((float) $totals['total'] + $fee, 4);
});

/* İşaretleme. Dizeyi döndürün; yüzey onu basar. Örneği YUKARIDA değil BURADA kurun. */
Hook::add('ui:admin.service_detail.bottom', 20, fn ($service) =>
    Modules::getInstance('Addons', 'MyAddon')->render_service_panel(is_array($service) ? $service : []));

/* Bir yetenek. Kayıt kancaları besledikleri şeyin bootstrap'ı sırasında koşar. */
Hook::add('register:cronjobs', 1, function () {
    include_once __DIR__ . DS . 'cronjobs' . DS . 'SyncTask.php';

    CronJobQueue::register(
        \WISECP\Modules\Addons\MyAddon\CronJobs\SyncTask::TYPE,
        \WISECP\Modules\Addons\MyAddon\CronJobs\SyncTask::class
    );
});

// coremio/helpers/Invoices.php, recalculate_totals() içinde: rakamlar kurulduktan sonra
// ve satıra yazılmadan önce.
Hook::runRefs('filter:invoice.totals', $totals, $invoice, $items);

// $totals artık dinleyicilerin içinde bıraktığı şeydir ve $persist onu yazar.

// Değerle: diğer modüllerin izleyebileceği bir olay.
Hook::run('action:myaddon.sync_finished', $summary, $startedAt);

// Referansla: burada bağlam olanlar dahil HER argüman referanstır, bu yüzden her biri
// önce düz bir değişken olmalıdır.
$context = ['id' => $recordId, 'lang' => Language::selected()];
Hook::runRefs('filter:myaddon.payload', $payload, $context);

// Bir kapı: herhangi bir dinleyiciden gelen boş olmayan dönüş işlemi durdurur.
$veto = Hook::run('gate:myaddon.export', $recordId);
if (array_filter($veto)) throw new Exception((string) current(array_filter($veto)));