Müşteri Sitesi Verisi ve Kapıları
Müşteri sitesinin ekran dışı kancaları: veriyi değiştiren 42 filtre, işlem durduran 10 kapı ve olay bildiren 30 kanca.
Genel Bakış
Ekran kancaları HTML ekler. Buradaki kancalar ise sayfanın ne göstereceğine karar veren veriye dokunur, bir işlemi durdurur ya da olup biteni bildirir.
Üçünün ayrımı işinizi nereye yazacağınızı belirler. Listeye satır eklemek istiyorsanız filtre, spam yorumu durdurmak istiyorsanız kapı, dış sisteme haber vermek istiyorsanız olay kancası kullanılır.
Referans
Veriyi değiştirenler
Kırk iki filtrenin en çok kullanılanları. Çoğu değeri referansla verir; kancanın kaydındaki Ref sütunu hangisinin değiştirilebildiğini söyler.
false başlar; belgeyi kesen entegrasyon referansla true yapar, buton ve indirme ucu görünür. Dönüş kullanılmaz.
Durduranlar
On kapı. Hepsi aynı sözleşmeyle çalışır: boş olmayan bir string döndürmek işlemi durdurur ve o metin müşteriye hata olarak gösterilir.
Bildirenler
Otuz olay kancasının çoğu müşterinin hesabında yaptığı işleri bildirir: anahtar açma, yorum yazma, form gönderme.
addData() kullanın.
Üç sözleşme yan yana
// FILTRE: panoya kendi panelini ekle (referansla)
Hook::add('filter:client.dashboard.panels', 10, function (&$panels) {
$panels[] = ['title' => 'Acme', 'body' => AcmePanel::html()];
});
// KAPI: spam skoru yuksekse yorumu durdur
Hook::add('gate:client.blog_comment', 10,
function ($owner_id, $parent_id, $message) {
if (Spam::score($message) > 80) return 'Yorumunuz kaydedilemedi.';
return null;
});
// OLAY: acilan anahtari denetim kaydina yaz
Hook::add('action:client.api_key_created', 10, function ($owner_id, $new_id, $perms) {
Audit::keyOpened($owner_id, $new_id, $perms);
});
Tuzaklar
Müşteri kancalarının çoğu ilk parametrede hesap kimliğini verir. Onu kullanın. Oturumdan okumaya çalışmak alt hesap ve hesap değiştirme akışlarında yanlış kişiyi getirir; API üzerinden gelen çağrıda ise oturum hiç yoktur.
Bir kapı yalnız o akışta çalışır. Aynı iş API üzerinden de yapılabiliyorsa oradaki yol bu kapıdan geçmeyebilir. Bir kuralı gerçekten dayatmak istiyorsanız kapının hangi çağrı yollarını kapsadığını kancanın kaydından doğrulayın.
Sayfanın tamamlanmış çıktısına dokunan filtre her sayfa görüntülemesinde çalışır. İçinde ağır bir sorgu ya da dış çağrı yaparsanız bedelini bütün site öder. Ağır işi önbelleğe alın; dinleyicide yalnız hazır sonucu kullanın.
İlgili Makaleler
Geri bildiriminiz için teşekkürler!
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.