Modülü Dağıtıma Hazırlama

AuroraBackup-1.2.0.zip
 └─ coremio/
     └─ modules/
         └─ Addons/
             └─ AuroraBackup/
                 ├─ AuroraBackup.php     # sınıf; yükleyici tam olarak bu adı arar
                 ├─ config.php           # ayarlar ve künye; varsa güncelleme atlar
                 ├─ manifest.json        # kopyayı güncelleme kontrolüne kaydeder
                 ├─ hooks.php            # isteğe bağlı, kanca sistemi yükler
                 ├─ router.php           # isteğe bağlı, bir admin sayfası kaydeder
                 ├─ AdminArea.php        # isteğe bağlı, admin sayfasının kendisi
                 ├─ logo.png             # isteğe bağlı, adıyla bulunur
                 ├─ lang/
                 │   ├─ en.php           # geri düşülen dosya, her zaman gönderin
                 │   └─ tr.php
                 ├─ views/
                 │   └─ index.php
                 └─ src/
                     └─ ApiClient.php    # kendi yardımcı sınıflarınız

# Temiz bir sistemin kökünden; böylece saklanan yollar köke göreli olur.
zip -r AuroraBackup-1.2.0.zip coremio/modules/Addons/AuroraBackup \
    -x '*/.git/*' '*/.DS_Store' '*/node_modules/*' '*.log' '*.map'

# Arşivi geri okuyun ve bakın. Göndermeyi düşündüğünüz şeyi değil gerçekten
# gönderdiğiniz şeyi görmenin tek yolu budur.
unzip -l AuroraBackup-1.2.0.zip

public function enable(): bool
{
    // Modülün var olabilmesi için gereken her şey: tabloları, bildirim şablonları,
    // tohum satırları. İdempotent, çünkü bir operatör modülü canı istediği kadar
    // kapatıp yeniden açabilir.
    $this->check_database();

    // Kolon onarımı tablo oluşturmadan sonra koşar, asla onun içinde değil: sonradan
    // eklenen bir kolona yazan tohumlama, tablosu o kolondan eski olan bir sistemde ölür.
    $this->check_columns();

    // false döndürmek açma işlemini iptal eder ve modülü kapalı bırakır; bu yüzden onu
    // gerçek bir engel için kullanın, asla bir uyarı için değil.
    return true;
}

<?php
require dirname(__DIR__) . '/bootstrap.php';

$type = 'Addons';
$key  = 'AuroraBackup';
$dir  = MODULE_DIR . $type . DS . $key;

$fail = [];

// 1. Platformun sabit yerlerden okuduğu dört dosya.
foreach ([$key . '.php', 'config.php', 'manifest.json', 'lang' . DS . 'en.php'] as $file)
    if (!is_file($dir . DS . $file)) $fail[] = 'missing: ' . $file;

// 2. Yükleyicinin kendi yanıtı, bizim tahminimiz değil.
Modules::Load($type, $key, true);
$config = Modules::Config($type, $key);
if (!is_array($config)) $fail[] = 'config.php did not return an array';

// 3. Derlemeden sağ çıkan kimlik bilgileri. GÖNDERİLEN ayarları okuyun, notlarınızı değil.
foreach ((array) ($config['settings'] ?? []) as $name => $value)
    if (is_string($value) && $value !== '') $fail[] = 'setting not blank: ' . $name;

// 4. Güncelleme kaydı.
if (!ModuleUpdater::manifest($dir)) $fail[] = 'manifest.json unreadable: no updates would ever be offered';

echo $fail ? implode("\n", $fail) . "\n" : "package looks shippable\n";

// İki yükleme yolunun da paylaştığı arşiv işleyicisi. $name boşsa "anahtarı ağaçtan
// çıkar" demektir; elle yükleme yolunun tam ağaca ihtiyaç duymasının sebebi budur.
public function extract_archive($file = '', $name = '', $group = 'Addons'): string;

// Kayıt defterine alma: önce config.php, sonra lang/{active}.php okunur, geri düşüş
// lang/en.php'dir; sınıf zaten bildirilmemişse {Name}.php dahil edilir.
public static function add($file, $type, $nominc = false, $status = '');
public static function Load($type = '', $name = '', $nominc = false, $status = '');

// getInstance bu üç sınıf adından var olan İLKİNİ alır, şu sırayla:
//   {Name}_Module  ->  {Name}  ->  WISECP\Modules\{Ucfirst Type}\{Name}
// Eksik yapıcı argümanları null ile doldurulur; yani sınıfınızın null olarak baş
// edemediği zorunlu bir parametre, yardımcı bir hata değil örnekleme anında bir çöküştür.
public static function getInstance(string $type, string $name, array $params = []): ?object;

// Bir eklentiyi açma. Önce activate(), sonra enable() çağrılır ve bayrak yalnız
// sonuncusu true döndüyse yazılır.
public function change_addon_status($arg = '');

// Store kurulum yolu yazar; diğer her yolda paketin içinde siz yazarsınız.
public static function write_manifest(string $dir, array $manifest): bool;

$ unzip -l AuroraBackup-1.2.0.zip
  coremio/modules/Addons/AuroraBackup/AuroraBackup.php
  coremio/modules/Addons/AuroraBackup/config.php
  coremio/modules/Addons/AuroraBackup/manifest.json
  coremio/modules/Addons/AuroraBackup/hooks.php
  coremio/modules/Addons/AuroraBackup/logo.png
  coremio/modules/Addons/AuroraBackup/lang/en.php
  coremio/modules/Addons/AuroraBackup/lang/tr.php
  coremio/modules/Addons/AuroraBackup/views/index.php
  coremio/modules/Addons/AuroraBackup/views/unlicensed.php
  coremio/modules/Addons/AuroraBackup/src/ApiClient.php

# coremio/modules/Addons/AuroraBackup üstünde hiçbir şey yok. .git yok, node_modules yok,
# geçici betik yok, ikinci arşiv yok, depolama çıktısı yok.

<?php
return [
    'created_at'         => 1785312000,
    'meta'               => [
        'name'         => 'Aurora Backup',
        'version'      => '1.2.0',
        'author'       => 'Aurora Systems',
        'opening-type' => 'normal',
        'icon_type'    => 'font',
        'icon'         => 'bi bi-cloud-arrow-up',
        'slug'         => 'aurora-backup',
    ],
    'show_on_adminArea'  => true,
    'show_on_clientArea' => false,

    // Kapalı gönderilir: operatör açar ve enable() metodunu çağıran şey odur.
    'status'             => false,
    'access_ps'          => [],

    // Her değer boş. Bu dizi diskinizden olduğu gibi geri yazılır.
    'settings'           => [
        'api_endpoint' => '',
        'api_key'      => '',
        'bucket'       => '',
    ],
];

{
    "type": "marketplace",
    "id": 42,
    "version": "1.2.0",
    "last_updated": "2026-08-03"
}