Eklenti ekle

Eklentiler, Light Portal'ın yeteneklerini genişleten uzantılardır. Kendi eklentinizi oluşturmak için aşağıdaki talimatları izleyin.

Not

Kendi eklentilerinizi oluşturmak için PluginMaker'ı yardımcı olarak kullanabilirsiniz. Bunu Yönetici -> Portal ayarları -> Eklentiler sayfasından indirin ve etkinleştirin.

Eklenti türünü seçme

Şu anda aşağıdaki eklenti türleri mevcuttur:

Türü	Açıklama
block	Portal için yeni blok türleri ekleyen eklentiler.
ssi	Veri almak için SSI fonksiyonlarını kullanan eklentiler (genellikle bloklar).
editor	Farklı içerik türleri için üçüncü taraf bir editör ekleyen eklentiler.
comment	Yerleşik olanın yerine üçüncü taraf bir yorum widget'ı ekleyen eklentiler.
parser	Sayfaların ve blokların içeriği için ayrıştırıcıyı uygulayan eklentiler.
article	Ana sayfadaki makale kartlarının içeriğini işlemek için eklentiler.
frontpage	Portalın ana sayfasını değiştirmek için eklentiler.
impex	Çeşitli portal öğelerini içe aktarma ve dışa aktarma için eklentiler.
block_options, page_options	Eklentiler, ilgili varlık (blok veya .sayfa) için ek parametreler ekler.
icons	Arayüz öğelerini değiştirmek veya blok başlıklarında kullanmak için yeni simge kütüphaneleri ekleyen eklentiler.
seo	Forumu ağda görünürlüğünü etkileyen eklentiler.
other	Yukarıdaki kategorilerle ilgili olmayan eklentiler.

Eklenti dizini oluşturma

Eklenti dosyalarınız için /Sources/LightPortal/Plugins içinde ayrı bir klasör oluşturun. Örneğin, eklentinizin adı HelloWorld ise, klasör yapısı şu şekilde olmalıdır:

...(Plugins)
└── HelloWorld/
    ├── langs/
    │   ├── english.php
    │   └── index.php
    ├── index.php
    └── HelloWorld.php

index.php dosyası diğer eklentilerin klasörlerinden kopyalanabilir. HelloWorld.php dosyası eklenti mantığını içerir:

<?php declare(strict_types=1);

namespace Bugo\LightPortal\Plugins\HelloWorld;

use Bugo\Compat\{Config, Lang, Utils};
use Bugo\LightPortal\Plugins\Plugin;

if (! defined('LP_NAME'))
    die('No direct access...');

class HelloWorld extends Plugin
{
    // FA icon (for blocks only)
    public string $icon = 'fas fa-globe';

    // Your plugin's type
    public string $type = 'other';

    // Optional init method
    public function init(): void
    {
        echo 'Hello world!';
    }

    // Hookable and custom methods
}

SSI Kullanımı

Eğer eklenti, SSI fonksiyonlarını kullanarak herhangi bir veri almak gerekiyorsa, yerleşik getFromSsi(string $function, ...$params) metodunu kullanın. Parametre olarak $function değişkenine SSI.php dosyasında bulunan fonksiyonlardan birinin adını, ssi_ ön ekini eklemeden geçmelisiniz. Örneğin:

$data = $this->getFromSSI('topTopics', 'views', 10, 'array');

Composer Kullanımı

Eklentiniz, Composer aracılığıyla kurulan üçüncü taraf kütüphaneleri kullanabilir. Gerekli bağımlılıkları içeren composer.json dosyasının eklenti dizininde bulunduğundan emin olun. Eklentinizi yayınlamadan önce, komut satırında eklenti dizinini açın ve şu komutu çalıştırın: composer install --no-dev -o. Bunun ardından, eklenti dizininin tamamı SMF için ayrı bir modifikasyon olarak paketlenebilir (örneğin PluginMaker paketine bakın).