Modül Anatomisi

coremio/modules/{Type}/{Name}/
├── {Name}.php          # ZORUNLU: sınıf, dizinle aynı adı taşır
├── config.php          # dizi döndürür; ayarlar, künye, alan tanımları
├── logo.png            # ya da .svg/.webp/.jpg; yapılandırma ad vermezse addan bulunur
├── hooks.php           # Hook::add() kayıtları, HER istekte dahil edilir
├── AdminArea.php       # kendi admin sayfası, router.php'den kaydedilir
├── router.php          # include + ModuleAdminArea::register()
├── lang/
│   ├── en.php          # pratikte ZORUNLU: geri düşülen dil
│   └── tr.php          # çevrilen dil başına bir dosya
├── pages/              # ayar ve yönetim işaretlemesi, sayfa adıyla bulunur
├── views/              # aynı rol, alternatif dizin adı
├── controllers/        # controller dağıtıcısıyla ulaşılan adlandırılmış giriş noktaları
├── assets/
│   ├── style/          # css
│   ├── js/             # javascript
│   └── images/         # arayüz görselleri, logo değil
└── src/                # kendi yardımcı sınıflarınız, otomatik YÜKLENMEZ

// Bağlam bağlama. Her biri bir id YA DA yüklenmiş kaydı alır; int verirseniz sizin için çekilir.
public function set_service(array|int $service = []): void;
public function set_product(array|int $product = []): void;
public function set_order(array|int $order = []): void;

// $this->options değerini bağlı hizmete geri yazar. Hiçbir şey bağlı değilse false.
public function save_options(): bool;

// config.php'yi yeniden yazar. $auto_status = true, ayar dizisi varken durumu açık konuma çevirir.
protected function save_config($data = [], $auto_status = true);

// Sağlayıcı çağrısı başına bir günlük satırı, panelin işlem geçmişinde gösterilir.
protected function save_log($action = '', $request = '', $response = '', $processed = ''): int|bool;

// Modülün şifreleme alt anahtarıyla şifreler; $key tek çağrılık olarak onu ezer.
protected function encode_str(string $str = '', string $key = ''): string;
protected function decode_str(string $str = '', string $key = ''): string;

// Çözülmüş logo URL'i ya da boş dize.
public function logo(): string;

// Bağlı hizmette etkin olan metrik sınırları, metrik tipine göre anahtarlanmış.
protected function enabled_metrics(): array;
protected function enabled_metric_values(): array;
protected function reapply_enabled_metrics(): void;

// Seçeneklerini metotlarınızdan birinden yükleyen bir açılır liste için veri öznitelikleri.
protected function method_url_data(string $method): array;

// "reset-password" adını handle_reset_password() metoduna yönlendirir. Yoksa null döner.
protected function use_method($param = '');

// Tek bir seçeneğin eklenti değerleri; parametre hariç tutmadıkça adetle çarpılır.
public function resolveAddonConfigurable(array $moduleParams, int $quantity = 0): array;

// Özellikler: $config, $lang, $dir, $url, $area_link, $_name, $user, $admin, $error.
public function __construct();

// views/{file}.php dosyasını, $variables içine açılmış halde render eder. İşaretlemeyi döndürür.
protected function view($file = '', $variables = []): string;

// Bu eklentinin admin rol ekranına eklediği yetki anahtarları.
public function privileges();

// Eklenti ayarları ekranı çağırır: $pFields gönderilen ayarlar,
// $accessPs ise gönderilen yetki seçimidir.
public function save_settings($pFields, $accessPs): bool;

// Eklenti listesinden etkinleştirme ya da devre dışı bırakma.
public function change_addon_status($arg = '');

// config.php'yi yeniden yazar. Tek argümana dikkat: burada otomatik durum bayrağı yok.
public function save_config($data = []): bool;

// Aynı şifreleme yardımcıları, ama eklenti tabanı alt anahtarı varsayılan olarak 'system' yapar.
protected function encode_str(string $str = '', string $key = ''): string;
protected function decode_str(string $str = '', string $key = ''): string;

public function use_default_settings($formElements = null);
public function isEnabled();

namespace WISECP\Modules\Registrars;

use Exception;
use Language;
use RegistrarModule;
use WISECP\Modules\Registrars\AcmeDomains\ApiClient;

class AcmeDomains extends RegistrarModule
{
    private ?ApiClient $api = null;

    // Yapıcı yok. Taban yapıcı $_name, $_type, $dir, $url, $config ve $lang değerlerini zaten kurdu.
    // Onun yerine istemciyi tembel kurun: hizmet yapıcıdan SONRA bağlanır, yani
    // $this->service gerektiren hiçbir şey burada koşamaz.
    private function api(): ApiClient
    {
        if ($this->api) return $this->api;

        // src/ otomatik yüklenmez, bu yüzden dosya açıkça dahil edilir.
        include_once $this->dir . 'src' . DS . 'ApiClient.php';

        $settings = $this->config['settings'] ?? [];

        $this->api = new ApiClient(
            (string) ($settings['username'] ?? ''),
            $this->decode_str((string) ($settings['apiKey'] ?? '')),
        );

        return $this->api;
    }

    // create() DEĞİL. create() taban sınıfa aittir ve EPP kodunun varlığına göre
    // register() ya da transfer() metoduna yönlendirir. create() metodunu geçersiz kılmak
    // transfer dalını ve onun iki kancasını birden düşürür.
    public function register(): array|bool
    {
        // Bağlı kayıt, sipariş edilen alan adını options içinde taşır; service['name']
        // geri düşüştür. Hizmetin kendisinde 'domain' diye bir kolon yoktur.
        $domain = (string) ($this->options['domain'] ?? $this->service['name'] ?? '');
        if ($domain === '') throw new Exception(Language::gc("acme/error-no-domain"));

        // 'year' tescil süresidir. service['period'] ise faturalama döngüsü
        // dizesidir ('y', 'm', 'none'), asla yıl sayısı değil.
        $year = (int) ($this->options['year'] ?? $this->service['period_time'] ?? 1) ?: 1;

        $response = $this->api()->register($domain, $year);

        // Her sağlayıcı çağrısı kaydedilir; api_url kendi kolonuna çıkarılır.
        $this->save_log('register', ['api_url' => $this->api()->last_url, 'domain' => $domain], $response);

        if (!($response['ok'] ?? false))
            throw new Exception($response['message'] ?? Language::gc("acme/error-refused"));

        return true;
    }
}

$module = Modules::getInstance("Registrars", "AcmeDomains");
if (!$module) throw new Exception(Language::gc("modules/error-not-found"));

// Bağlama ayrı bir adımdır ve $service, $product, $user ile $options değerlerini dolduran şeydir.
$module->set_service($serviceId);

try {
    // Çağıran taraf her zaman create() ister. Servis sağlayıcıda bu, taban metottur:
    // register() ya da transfer() metoduna yönlendirir ve çevresinde alan adı kancalarını koşturur.
    $result = $module->create();
}
catch (\Throwable $e) {
    // Modül başarısızlığı fırlatarak bildirir; çağıran taraf mesajı yanıta çevirir.
    return $operation->output(['status' => "error", 'message' => $e->getMessage()]);
}

// Modülün değiştirdiği durum, kendi yardımcısı üzerinden hizmete geri yazılır.
$module->save_options();