Müşteri Sitesi Kancaları

1.7k görüntülenme Markdown

Müşterinin gördüğü sitede kendi HTML'inizi ekleyeceğiniz 156 nokta: nerede durdukları, adların nasıl okunduğu ve dönüşün ne olması gerektiği.

Genel Bakış

Müşteri sitesindeki ekran kancaları 156 tanedir ve hepsi aynı işi yapar: döndürdüğünüz HTML, şablonda o noktanın bulunduğu yere yerleşir.

Kancalar tema şablonlarının içine etiketiyle yerleştirilmiştir. Ölçüldü: üç yerleşik temanın üçü de aynı 154 çağrıyı taşıyor, yani tema değiştirmek dinleyicilerinizi düşürmez.

Dönüş sözleşmesi tek tiptir. Boş olmayan string dönüşler sırayla birleşip sayfaya girer; boş ve null dönüşler atlanır.

Yapı

Ad üç parçadır: aile, ekran, nokta. Son parça noktanın ekranda nereye düştüğünü söyler.

ad ve şablon

after Bir bölümün hemen ardı. 46
bottom Bir bölümün en altı, hâlâ içinde. 34
top Bir bölümün en üstü. 31
end Bir listenin ya da şeridin son öğesinden sonrası. 17
before Bir bölümün hemen öncesi. 10

Referans

Noktaların ekranlara dağılımı. Alan adı ve hizmet detayı en zengin ekranlardır; bir eklentinin müşteriye görünen yüzü çoğu kez oralarda kurulur.

account/domain-detail (22) Alan adı detayı
account/service-detail (11) Hizmet detayı
account/ticket-detail (7) Destek talebi detayı
account/settings (5) Hesap ayarları
account/domains (5) Alan adı listesi
account/invoice-detail (4) Fatura detayı
account/ticket-create (4) Yeni talep formu
products/detail (4) Ürün sayfası
checkout/* (8) Sepet, yapılandırma, ödeme, sipariş sonu
content/* (15) Bilgi bankası, blog, iletişim, eklenti sayfaları
auth/* (3) Parola sıfırlama ve davet kabul ekranları
partials + layouts (13) Başlık, altbilgi, ödeme kabuğu, sayfa gövdesi

Dinleyici

coremio/hooks/acme-site.php
// Cogu ekran kancasi parametre ALMAZ: hangi ekranda oldugunuzu ad soyler.
Hook::add('ui:client.domain_detail.hero.after', 10, function () {
    if (!AcmeBanner::active()) return null;          // dokunma
    return '<div class="alert alert-info">' . AcmeBanner::text() . '</div>';
});

Tuzaklar

Dönen HTML kaçırılmaz

Bu noktalara ham HTML girer. Müşteriden, adres satırından ya da veritabanından gelen bir değeri doğrudan gömerseniz siteye kod enjekte etmiş olursunuz. Dışarıdan gelen her parçayı kendiniz kaçırın; kanca bunu sizin yerinize yapmaz.

Kendi temanız kancaları taşımak zorunda

Kancalar tema şablonlarının içindedir. Yerleşik üç tema aynı çağrıları taşır, ama sıfırdan yazdığınız bir tema yalnız kendi koyduğunuz noktaları taşır. Bir eklentinin sitede görünmemesinin sık nedeni kancanın değil, temanın eksik olmasıdır.

Nokta seçimi düzeni bozabilir

Bir nokta bir kutunun içinde, bir başkası dışındadır. Izgara içine tam genişlikte bir blok koymak sayfayı kaydırır. Adın son parçası nereye düştüğünü söyler, ama emin olmanın yolu şablonu açıp o satıra bakmaktır; kancanın kaydı dosya ve satır numarası verir.

Boş dönüş temiz yoldur

Bir noktada iş yapmak istemiyorsanız null dönün: boş dönüşler atlanır ve sayfada iz bırakmaz. Boş bir <div> döndürmek ise ızgarada gerçek bir boşluk açar.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.