الخطّافات وتطوير الإضافات

الإضافات هي الطريقة التي تضيف بها ميزات إلى TubePress دون المساس بالنواة. تتصل بنظام CMS من خلال نظام صغير على غرار WordPress يتضمن الأحداث (أحداث تُطلق وتُنسى) والفلاتر (تعديل قيمة وإعادتها). الإضافات الثلاث المدمجة — Age Gate وBackup Pro وCTR Ranking — مبنية بالكامل باستخدام نفس API الموثق هنا.

نظام الخطافات

تدير الفئة الثابتة HookSystem كلا النوعين من الخطافات. تعمل ردود النداء بترتيب تصاعدي للأولوية (الافتراضي 10)؛ يتم التقاط أي استثناء تُطلقه ردود النداء وتسجيله، لذا لا يمكن لإضافة معطوبة أن تُعطل الصفحة.

// Actions — do something when an event fires
HookSystem::addAction('head.meta', function () {
    echo '<meta name="rating" content="adult">';
}, 10);

// Filters — receive a value, return a (possibly) changed value
HookSystem::addFilter('theme.template_data', function ($data, $template) {
    if ($template === 'home') {
        $data['promo'] = Promo::current();
    }
    return $data;
});

نقاط الخطاف المتاحة

تُطلق النواة هذه الخطافات. يمكنك أيضاً تحديد خطافاتك الخاصة وإطلاقها من إضافة.

الأحداث

الفلاتر

تشريح الإضافة

الإضافة هي مجلد تحت plugins/ يحتوي على ملف بيان وفئة تُنفذ PluginInterface.

plugins/myplugin/
├── plugin.json     Manifest (name, slug, version, …)
├── myplugin.php    Main class implementing PluginInterface
├── icon.svg        Optional icon shown in the admin
└── …               Your assets, templates, migrations

البيان يعكس الإضافات المدمجة:

{
  "name": "My Plugin",
  "slug": "myplugin",
  "description": "What it does, in one sentence.",
  "version": "1.0.0",
  "author": "You",
  "requires": "1.0.0",
  "icon": "icon.svg"
}

الفئة الرئيسية تُنفذ أساليب دورة الحياة الست لـ PluginInterface:

تسجيل المسارات والأصول

قم بكل الربط في boot():

public function boot(): void
{
    // A front-end route
    Router::get('/promo/{code}', [PromoController::class, 'show']);

    // Inject a meta tag
    HookSystem::addAction('head.meta', [$this, 'meta']);

    // Tweak every video card
    HookSystem::addFilter('video.card.html', [$this, 'badge'], 20);
}

العمل المجدول في الإضافة

سجّل مهمة متكررة مع CronManager من boot() — تعمل على pseudo-cron المدمج، لذا لا يلزم وجود crontab للنظام. هكذا تعيد إضافة CTR حساب الدرجات ويُشغّل Backup Pro النسخ الاحتياطية المجدولة.

الإضافات المدمجة كمراجع

التوزيع والترخيص

يمكنك الاحتفاظ بالإضافة خاصة أو مشاركتها بحرية أو بيعها عبر السوق، والذي يضيف ترخيصاً موقعاً وتفعيلاً لكل نطاق. راجع تطوير القوالب للمكافئ في جانب العرض، ومرجع Theme API لكل ما هو متاح لكود القالب.