Merhaba,
Bir eklentinin çekirdek dosyalarını düzenlemesi hem güncellemede kaybolur hem de başka eklentilerle çakışır. Zenito bunun yerine üç bağlanma yolu sunuyor. Bu konuda üçünü de örnekle anlatıyoruz; örneklerdeki eklenti "İlk Zenito eklentinizi yazın" konusundaki Acme/Duyuru.
1. Şablon değişiklikleri
Bir çekirdek şablona birkaç satır eklemek için şablonu kopyalamazsınız; neyi bulup neyle değiştireceğinizi _data/template_modifications.json içinde tarif edersiniz. Değişiklik şablon derlenmeden önce uygulanır.
action olarak str_replace, preg_replace, append (sona ekle) ya da prepend (başa ekle) kullanılabilir.
Dikkat edilecekler:
2. Sınıf genişletme
Bir denetleyicinin, varlığın, deponun ya da servisin davranışını değiştirmek için o sınıfı genişletirsiniz. _data/class_extensions.json:
ZNX_Forum, o ana kadar zincirde ne varsa onun takma adıdır. Aynı sınıfı üç eklenti genişletirse üçü sırayla birbirinin üstüne biner. Bu yüzden her zaman parent:: çağırın ve yanıtı değiştirip geri verin; yanıtı baştan kendiniz kurarsanız sizden önceki eklentilerin eklediklerini silersiniz.
3. Kod olayları
Belirli anlarda çağrılan dinleyicilerdir. _data/code_event_listeners.json:
Sık kullanılanlar: templater_setup (şablon fonksiyonu ve süzgeci eklemek), entity_structure (bir varlığa sütun, ilişki ya da getter eklemek), navigation_setup, bb_code_rules, thread_creator_validate, user_registration_complete. Tam liste ve her olayın argümanları yönetim panelinde Geliştirme › Kod olayları sayfasında.
Eklenti yazarken unutulmaması gerekenler
Hata ayıklama
Araçlar › Hata ayıklama ve geliştirme sayfasından hata ayıklama modunu panelden, isterseniz belirli bir süre için açabilirsiniz. Açıkken Geliştirme › Geliştirici sayfası rotaları, dinleyicileri, sınıf genişletmelerini, şablon değişikliklerini ve iş kuyruğunu tek sayfada gösterir; bulunamayan bir sınıfa ya da şablona işaret eden her şey en üstte listelenir. Her sayfanın altındaki çubuktan o isteğin sorgularını, sürelerini ve işlenen şablonları görebilirsiniz.
Takıldığınız yerde kodunuzun ilgili kısmıyla birlikte bu foruma konu açın.
Bir eklentinin çekirdek dosyalarını düzenlemesi hem güncellemede kaybolur hem de başka eklentilerle çakışır. Zenito bunun yerine üç bağlanma yolu sunuyor. Bu konuda üçünü de örnekle anlatıyoruz; örneklerdeki eklenti "İlk Zenito eklentinizi yazın" konusundaki Acme/Duyuru.
1. Şablon değişiklikleri
Bir çekirdek şablona birkaç satır eklemek için şablonu kopyalamazsınız; neyi bulup neyle değiştireceğinizi _data/template_modifications.json içinde tarif edersiniz. Değişiklik şablon derlenmeden önce uygulanır.
Kod
[
{
"type": "public",
"template": "forum_list",
"modification_key": "acme_duyuru_forum_list",
"description": "Forum listesinin üstüne duyuru şeridini ekler.",
"action": "str_replace",
"find": "{{ widget_position('forum_list_above_nodes') }}",
"replace": "{{ widget_position('forum_list_above_nodes') }}\n<zn:include template=\"acme_duyuru_serit\"/>"
}
]
[Dikkat edilecekler:
- find metni şablonda birebir bulunmalı. Bulunamazsa değişiklik hata vermeden uygulanmaz. Bu yüzden aradığınız metni olabildiğince kısa ve kararlı seçin; uzun bir HTML bloğu yerine bir widget_position satırı ya da belirgin bir sınıf adı gibi.
- Bulduğunuz metni replace içinde tekrar yazın (yukarıdaki gibi); yoksa onu silmiş olursunuz ve aynı yere bağlanan başka bir eklenti onu bulamaz.
- Site sahibi değişiklikleri Görünüm › Şablon değişiklikleri sayfasında görür ve tek tek kapatabilir.
- Site sahibinin stilinde kopyaladığı şablonlara da uygulanır, ama stil yazarı aradığınız satırı değiştirdiyse bulunamaz. Destek isteyen birine önce bunu sorun.
2. Sınıf genişletme
Bir denetleyicinin, varlığın, deponun ya da servisin davranışını değiştirmek için o sınıfı genişletirsiniz. _data/class_extensions.json:
Kod
[{"from_class": "Zenite\\Pub\\Controller\\Forum", "to_class": "Acme\\Duyuru\\Extend\\Pub\\Controller\\Forum"}]
[Kod
namespace Acme\Duyuru\Extend\Pub\Controller;
use Zenite\Mvc\ParameterBag;
use Zenite\Mvc\Reply\View;
class Forum extends ZNX_Forum
{
public function actionIndex(ParameterBag $params)
{
$reply = parent::actionIndex($params);
if ($reply instanceof View && $reply->getTemplateName() == 'forum_list')
{
$reply->setParam('acmeDuyuru', \Zenite::options()->acmeDuyuruMetni);
}
return $reply;
}
}
[3. Kod olayları
Belirli anlarda çağrılan dinleyicilerdir. _data/code_event_listeners.json:
Kod
[{"event_id": "templater_setup", "callback_class": "Acme\\Duyuru\\Listener", "callback_method": "templaterSetup"}]
[Kod
public static function templaterSetup(App $app, Templater $templater): void
{
$templater->addFunction('acme_duyuru_sayisi', function (Templater $templater)
{
return \Zenite::repository('Acme\Duyuru:Duyuru')->countActive();
});
}
[Eklenti yazarken unutulmaması gerekenler
- Adresleri elle yazmayın. 1.1.4 ile site sahipleri Kurulum › Rota önekleri'nden /threads/, /members/ gibi kelimeleri değiştirebiliyor. Şablonda {{ link('threads', $thread) }}, PHP'de $this->buildLink(...) kullanın. Kelimenin kendisi gerekirse şablonda route_prefix('threads'). Betikte "/threads/" ile başlıyor mu diye adres denetlemeyin.
- Sayfa geçişlerini hesaba katın. Site sayfalar arasında geçerken yalnızca içerik alanını yeniler. Sayfaya bir kez bakıp kurulan betikleriniz document.addEventListener('zn:spa-navigated', ...) ile de çalışmalı. Davranışı ZN.register('ad', fn) ve data-zn-init="ad" ile bağlarsanız bu kendiliğinden olur.
- Klavye kısayolları bir alana ya da mesaj editörüne yazı yazılırken çalışmamalı: ZN.isTyping(event) ile kontrol edin.
- Makale forumları: Konu listesine ya da mesaj görünümüne dokunan bir eklenti, forum türü "Makale" olan forumlardaki kart görünümüne (article_macros::card) ve makale düzenindeki ilk mesaja da bakmalı.
- Renkleri sabit yazmayın, var(--zn-color-primary) gibi stil değişkenlerini kullanın; eklentiniz koyu temada ve özel stillerde de doğru görünsün.
- Yetkileri sunucuda denetleyin. Bir düğmeyi şablonda gizlemek yetmez; denetleyicide canEdit(), hasPermission() gibi kontrolleri yapın.
Hata ayıklama
Araçlar › Hata ayıklama ve geliştirme sayfasından hata ayıklama modunu panelden, isterseniz belirli bir süre için açabilirsiniz. Açıkken Geliştirme › Geliştirici sayfası rotaları, dinleyicileri, sınıf genişletmelerini, şablon değişikliklerini ve iş kuyruğunu tek sayfada gösterir; bulunamayan bir sınıfa ya da şablona işaret eden her şey en üstte listelenir. Her sayfanın altındaki çubuktan o isteğin sorgularını, sürelerini ve işlenen şablonları görebilirsiniz.
Takıldığınız yerde kodunuzun ilgili kısmıyla birlikte bu foruma konu açın.