Müşteri Paneli Köprüsü

tarayıcı POST /addon/MyAddon   operation=use_addon_method & method=save-preference
   |
   +-- addon controller  ->  addon_ctx()     etkin yapılandırma + modül örneği + web yüzü?
   +-- ClientAddon       ->  yüz müşteri paneliyse üye oturumu gerekir
   +-- ad normalize      ->  'save-preference'  use_save_preference'a dönüşür
   +-- method_exists     ->  yoksa reddedilir
   +-- $module->use_save_preference()          HİÇBİR argüman verilmeden çağrılır
   +-- falsy dönüş       ->  Exception($module->error)
   '-- dizi ya da dize   ->  JSON gövdesi

public function use_addon_method(Operation $operation): bool;

$method = (string) Filter::init("REQUEST/method", "route");        // a-zA-Z0-9 - _ . korunur
$method = "use_" . str_replace([' ', '-', '.'], '_', $method);     // boşluk, tire, nokta -> alt çizgi

if ($method === "use_" || !method_exists($module, $method))
    throw new \Exception("Undefined addon method.");

$result = $module->{$method}();                                     // argüman YOK
if (!$result) throw new \Exception((string) (($module->error ?? '') ?: 'An error occurred'));

return $operation->output($result);

public function use_sample_method(): array|string;

return [
    'status'  => 'successful',
    'message' => $this->lang['saved'] ?? 'Saved.',
    'data'    => ['preference' => $value, 'updated_at' => time()],
];

class AddonModule
{
    public string|bool $error = '';        // metodunuz yanlış değer döndürünce köprü bunu okur
    public array  $config    = [];         // kaydedilmiş ayarlarla birleştirilmiş config.php
    public array  $lang      = [];         // lang/{selected}.php
    public string $area_link = '';         // POST edilecek adres; her yüze göre YENİDEN YAZILIR
    public string $_name     = '';         // dizin adı
    public array  $user      = [];         // oturum açmış üye, varsa
    public array  $admin     = [];         // oturum açmış yönetici, varsa
    public string $url       = CORE_FOLDER . DS . MODULES_FOLDER . DS . 'Addons' . DS;
    public string $dir;                    // modül dizininin dosya sistemi yolu
    // Kurucu $url sonuna {Name} ekleyip onu public bir URL'e çözer; $dir, $config, $lang,
    // $user ve $admin alanlarını doldurur ve $area_link değerini o anki yüze yöneltir.

    public function __construct();
    protected function view($file = '', $variables = []): string;
    public function privileges();
    public function save_settings($pFields, $accessPs): bool;
    public function change_addon_status($arg = '');
    public function save_config($data = []): bool;
    public function use_default_settings($formElements = null);
    public function isEnabled();
}

// $groupAction, rota kayıt defterindeki "Group/Action" değeridir; müşteri kayıt defteri için
// başına "client:" ekleyin, o durumda $input ayrıca owner_id taşımalıdır.
public static function internal(string $groupAction, array $input = [], array $query = []): array;

use WISECP\Api\Kernel;

// Süreç içinde: HTTP yok, kimlik doğrulama yok, hız sınırı yok; ama dış API'nin döndürdüğü
// zarfın AYNISI. $input önce yol parametrelerini, sonra gövdeyi doldurur.
$resp    = Kernel::internal('Tickets/GetTicketMessages', ['id' => $ticketId], ['limit' => 50]);
$replies = $resp['data'] ?? [];

<?php
namespace WISECP\Modules\Addons\MyAddon;

use Exception;
use Filter;
use Language;
use User;
use UserManager;

class MyAddon extends \AddonModule
{
    /** config.php içinde show_on_clientArea true olduğunda /addon/MyAddon adresinde basılır. */
    public function clientArea(): array
    {
        $member = UserManager::LoginData('member');

        return [
            'page_title'  => $this->lang['meta']['name'] ?? 'My Addon',
            'breadcrumbs' => [['link' => '', 'title' => $this->lang['meta']['name'] ?? 'My Addon']],
            'content'     => $this->view('client.php', [
                'link'       => $this->area_link,                                  // buraya POST edin
                'preference' => (string) (User::getInfo((int) $member['id'], ['my_addon_pref'])['my_addon_pref'] ?? ''),
            ]),
        ];
    }

    /**
     * method=save-preference ile erişilir. Parametresizdir: girdisini tıpkı bir operation
     * gibi kendisi okur ve hesabı, isteğin gönderdiği hiçbir şeye güvenmek yerine
     * oturumdan yeniden okur.
     *
     * @throws Exception
     */
    public function use_save_preference(): array
    {
        $member = UserManager::LoginData('member');
        if (!$member) throw new Exception(Language::gc('website/index/addon-login-required') ?: 'Login required.');

        $value = Filter::init('POST/preference', 'route');
        if ($value === '' || !in_array($value, ['daily', 'weekly', 'never'], true))
            throw new Exception($this->lang['err-bad-preference'] ?? 'Choose one of the offered options.');

        User::AddInfo((int) $member['id'], ['my_addon_pref' => $value]);

        return [
            'status'  => 'successful',
            'message' => $this->lang['saved'] ?? 'Saved.',
            'data'    => ['preference' => $value],
        ];
    }
}

<select id="ma-pref" class="form-select">
    <option value="daily">Daily</option>
    <option value="weekly">Weekly</option>
    <option value="never">Never</option>
</select>
<button type="button" id="ma-save" class="btn btn-primary mt-2">Save</button>

<script>
(function () {
    var link = ;
    var btn  = document.getElementById('ma-save');
    var sel  = document.getElementById('ma-pref');
    if (!btn || !sel) return;

    btn.addEventListener('click', function () {
        btn.disabled = true;

        var body = new URLSearchParams({
            operation:  'use_addon_method',
            method:     'save-preference',   // tire sorun değil, use_save_preference olur
            preference: sel.value
        });

        fetch(link, {
            method:  'POST',
            headers: { 'X-Requested-With': 'XMLHttpRequest', 'Content-Type': 'application/x-www-form-urlencoded' },
            body:    body
        })
        .then(function (r) { return r.json(); })
        .then(function (r) {
            if (r.status === 'successful') window.WCPTheme && window.WCPTheme.toast(r.message, 'success');
            else window.WCPTheme && window.WCPTheme.toast(r.message, 'error');
        })
        .finally(function () { btn.disabled = false; });
    });
})();
</script>

WcpRequest(AREA_LINK, {
    method: 'POST',
    data:   { operation: 'use_addon_method', method: 'save-preference', preference: 'weekly' },
    button: runBtn,
    buttonLoader: window.saving_loader,
    done: function (response) {           // `done` yazmazsanız standart işleme uygulanır
        output.textContent = JSON.stringify(response, null, 2);
    }
});