zenito
Eklenti Geliştirme

İlk Zenito eklentinizi yazın: dosya yapısı, kurulum ve paketleme

  • zenito
  • 0 cevap
  • 82 görüntülenme
zenito
Aktif üye
Admin
  • Katılım4 Eki 2026
  • Mesajlar55
  • Tepki puanı33
#1
Merhaba,

Zenito'nun çekirdeği de eklentilerle aynı parçalardan kurulu: rotalar, seçenekler, izinler, şablonlar ve ifadeler hep aynı biçimde tanımlanıyor. Yani çekirdeğin yapabildiği her şeyi bir eklenti de yapabilir. Bu konuda sıfırdan bir eklentinin iskeletini kurup sitenize yüklemeye kadar olan yolu anlatıyoruz. Ayrıntılı başvuru için pakette gelen docs/gelistirici-rehberi.md dosyasına bakın.

Çalışma ortamı
Eklentiyi canlı sitede değil, kendi bilgisayarınızda yazın. Zenito'nun dışarıdan bir bağımlılığı yok; PHP 8.1+ yeterli, veritabanı olarak SQLite da seçebilirsiniz. Proje klasöründe:
Kod
php -S localhost:8080 server.php
src/config.php içinde şu iki ayarı açın:
Kod
$config['debug'] = true;
$config['development']['enabled'] = true;
Geliştirme modunda bir şablon dosyasını değiştirdiğinizde bir sonraki istekte kendiliğinden içe aktarılır. Hata ayıklama modu da yönetim panelinde Geliştirme menüsünü ve sayfaların altındaki sorgu/süre çubuğunu açar.

İskeleti oluşturun
Kod
php cmd.php addon:create Acme/Duyuru "Duyuru Şeridi"[
Bu komut src/addons/Acme/Duyuru/ klasörünü, addon.json, Setup.php, Listener.php dosyalarını ve _data klasörlerini hazırlar. İki parça da büyük harfle başlamalı, yalnızca harf ve rakam içermeli; "Zenite" satıcı adı çekirdeğe ayrılmış. Namespace klasörü izler: Acme\Duyuru\...

addon.json
Kod
{
	"title": "Duyuru Şeridi",
	"description": "Forum listesinin üstünde bir duyuru şeridi gösterir.",
	"version_id": 1000070,
	"version_string": "1.0.0",
	"dev": "Acme",
	"dev_url": "https://acme.example",
	"require": {"Zenite": [1010470, "Zenito 1.1.4+"]},
	"icon": "icon.svg"
}
[/
I]version_id[/I] sayısal sürümdür ve her yeni pakette artmalı: 1.0.0 → 1000070, 1.0.1 → 1000170, 1.1.0 → 1010070. Panel bir eklentiyi "yükseltilecek" saymak için bu sayıya bakar; aynı sayıyla yeni bir zip yüklerseniz Yükselt düğmesi çıkmaz. require eklentinin çalıştığı en eski Zenito sürümünü söyler; daha eski bir sitede kurulum açık bir mesajla reddedilir.

Setup.php
Eklentinin kendi tabloları varsa burada oluşturulur:
Kod
public function install(): void
{
	$this->schemaManager()->createTable('acme_duyuru_okunan', function (Table $table)
	{
		$table->int('user_id');
		$table->int('read_date');
		$table->primary('user_id');
	});
}

public function upgrade(int $fromVersionId): void { }

public function uninstall(): void
{
	$this->schemaManager()->dropTable('acme_duyuru_okunan');
}
[/
enito hem MySQL/MariaDB hem SQLite üzerinde çalışıyor, eklentiniz de çalışmalı. SQL yazarken ON DUPLICATE KEY, UNIX_TIMESTAMP(), FIND_IN_SET gibi tek veritabanına özgü şeyler kullanmayın; $db->insert($tablo, $satir, 'replace') ve zamanı PHP'den vermek yeterli.

_data klasörü
Eklentinin tanımları burada JSON olarak durur, kurulumda içe aktarılır:
  • routes.json, navigation.json, admin_navigation.json: adresler ve menüler
  • options.json, option_groups.json: Seçenekler sayfasındaki ayarlar
  • permissions.json: grup izinleri
  • templates/public/*.html, templates/admin/*.html: şablonlar (CSS için .css)
  • phrases/*.json (İngilizce ana metin) ve lang/tr-TR/*.json (Türkçe)
  • template_modifications.json, class_extensions.json, code_event_listeners.json: çekirdeğe bağlandığınız yerler (ayrı bir konuda anlatıyoruz)
  • cron.json, widget_definitions.json, style_properties.json
Ekranda görünen her yazı bir ifade olmalı; şablonda {{ phrase('acme_duyuru_baslik') }}. İfade adlarını eklentinizin önekiyle başlatın, başka eklentilerle çakışmasın.

Kurun ve deneyin
Kod
php cmd.php addon:install Acme/Duyuru
php cmd.php dev:check
[/CO
dev:check[/I] bütün şablonları derler, tanımlanmamış ifadeleri listeler. Paylaşmadan önce temiz çıktığından emin olun. _data altında bir dosyayı değiştirdiğinizde php cmd.php addon:rebuild Acme/Duyuru tanımları yeniden içe aktarır. Kaldırıp yeniden kurmayı da deneyin: addon:uninstall, sonra addon:install. Kaldırma sonrasında geride tablo ya da ayar kalmamalı.

Paketleme
Zip'in içinde Acme/Duyuru/addon.json yolu olmalı; dosyalar isterseniz upload/ ya da src/addons/ klasörlerinin altında da durabilir, panel üçünü de tanır. Site sahibi zip'i Eklentiler › Arşivden kur ile yükler.

Sonraki konu: "Şablon değişiklikleri, sınıf genişletme ve kod olayları". Sorularınızı ve yazdığınız eklentileri bu foruma bekliyoruz.
Cevap yazabilmek için giriş yapmalı veya kayıt olmalısınız.

Şu an bu konuyu okuyanlar

0

0 üye, 0 ziyaretçi ve 0 arama motoru