Panel Müşteri Ekranı Kancaları
Müşteri ekranlarının on dokuz yerleşim noktası: özet kartları, sekmeler, liste araç çubuğu ve oluşturma formu.
Genel Bakış
Müşteri ekranlarının yerleşim noktaları burada. Hepsi aynı biçimde çalışır: döndürdüğünüz HTML o noktada görünür, bir şey eklemek istemediğinizde null dönersiniz.
İki nokta bu kalıbın dışındadır. Sekme ekleme HTML değil bir nesne alır; ekleme metot çağrısıyla olur. Evrak alanı formu ise sayfa açılırken bir kez toplanır ve sabitlenir, düzenlenen alana göre değişemez.
Referans
Özet sekmesinin en üstü
Müşteri özetinin en üstünde, istatistik kartlarından önce görünür. Risk bandı, son temas notu ya da önemli müşteri uyarısı için doğru yer.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.summary.top', 10,
function ($user, $user_id, $user_stats) {
$score = Acme::riskScore($user_id);
if ($score < 70) return null; // eklenecek bir sey yoksa null
return '<div class="alert alert-warning">Risk skoru: ' . (int) $score . '</div>';
});Müşteri bilgi kartına satır ekleme
Bilgi kartının son satırından sonra görünür. Dış sistemdeki müşteri numarası, kaynak ya da hesap yöneticisi gibi bir alan eklemenin yeri.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.summary.info_card', 10,
function ($user, $client_info, $user_id) {
$crm = Acme::crmId($user_id);
if ($crm === '') return null;
// Cikti kacissiz basilir: dis degeri kendiniz temizleyin.
return '<div class="row"><div class="col-5">CRM</div><div class="col-7">'
. htmlspecialchars($crm) . '</div></div>';
});Aksiyon kartına işlem ekleme
Aksiyon kartındaki son işlemin ardından görünür. Kendi toplu işleminizi yerleşik olanların yanına koyar.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.summary.action_cards', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Özet sekmesinin altı
Özet sekmesinin kartları bittikten sonra görünür. Kendi kartınızı ya da bilgi panelinizi eklemenin yeri.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.summary.bottom', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Başlık alanına rozet ya da buton
Sayfa başlığındaki durum rozetlerinin sonunda görünür. Kendi rozetinizi ya da kısa yol butonunuzu buraya koyarsınız.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.header_actions', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Müşteri detayına yeni sekme
Çekirdek sekmelerin hepsi kurulduktan sonra çalışır. Diğer yerleşim noktalarının aksine burada HTML döndürmezsiniz: sekmeyi nesnenin metoduna eklersiniz.
Hook::add('ui:admin.client_detail.tabs', 10, function ($tab, $user, $user_id) {
// HTML DONDURMEYIN: sekme nesneye eklenir.
$tab->add('acme', 'Acme', Acme::renderTab($user_id));
});Profil sekmesinin altı
Profil sekmesinin dikey sekmeleri işlendikten sonra görünür. Kimlik doğrulama özeti ya da ek tercih bölümü için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.profile.bottom', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Kişiler sekmesinin üstü
Adres ve kişi listesinin üstünde görünür. Adres doğrulama durumu ya da eksik fatura adresi uyarısı için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.contacts.top', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Alt kullanıcılar sekmesinin üstü
Alt kullanıcı listesinin üstünde görünür. Kabul edilmemiş davet uyarısı ya da izin politikası bildirimi için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.subusers.top', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Faturalar sekmesinin üstü
Fatura tablosunun üstünde görünür. Açık bakiye uyarısı ya da otomatik ödeme durumu için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.invoices.top', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Hizmetler sekmesinin üstü
Hizmet ve sipariş listesinin üstünde görünür. Yenileme uyarısı ya da kurulum hatası bandı için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.orders.top', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Destek sekmesinin üstü
Talep tablosunun üstünde görünür. Açık talep sayısı ya da memnuniyet özeti için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.tickets.top', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Notlar sekmesinin üstü
Not listesinin üstünde görünür. Dış kaynaktan gelen sistem notlarını göstermenin yeri.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.notes.top', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Müşteri sayfasının en altı
Sayfanın en sonunda, alt bilgiden hemen önce görünür. Sekmeye bağlı olmayan bir panel için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_detail.bottom', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Müşteri listesi araç çubuğu
Listenin üstündeki buton grubunda görünür. Dışa aktarma ya da kendi toplu işleminiz için buton eklersiniz.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_list.toolbar', 10, function () {
return '<a href="/acme/export" class="btn btn-outline-secondary">'
. '<i class="bi bi-download"></i> Acme</a>';
});Müşteri listesinde tablodan önce
İstatistik kartı ve filtre panelinden sonra, tablodan hemen önce görünür.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_list.before_table', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Müşteri oluşturma formundan önce
Yeni müşteri formunun üstünde görünür. Bilgilendirme şeridi ya da ek talimat için uygundur.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_create.before_content', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Müşteri oluşturma formundan sonra
Yeni müşteri formu bittikten sonra, sayfa sonunda görünür.
null ve false atlanır: bir şey eklemek istemediğinizde null dönün. Çıktı kaçışsız girer — dışarıdan gelen değeri kendiniz temizleyin.Hook::add('ui:admin.client_create.bottom', 10, function () {
return '<div class="alert alert-info">Acme</div>';
});Evrak alanı formuna ek bölüm
Evrak doğrulama alanlarının ekleme ve düzenleme penceresine ek bölüm koyar. Kendi alan tipinizi tanıttıysanız ayarlarını buradan sorarsınız.
Hook::add('ui:admin.document_field.form', 10, function () {
// Cikti bir kez toplanir: alana gore degisemez.
return '<div class="mb-3"><label>Acme dogrulama</label>'
. '<input class="form-control" name="acme_rule"></div>';
});Tuzaklar
Bu noktalarda döndürdüğünüz metin olduğu gibi sayfaya girer. Dışarıdan gelen bir değeri (müşteri adı, dış sistem yanıtı, form girdisi) doğrudan gömerseniz panelde kod çalıştırma açığı yaratırsınız. Değeri kendiniz kaçırın.
Sekme ekleme noktası diğerlerine benzer görünse de HTML göstermez: size bir nesne verir ve sekme onun metoduyla eklenir. HTML döndüren bir dinleyici burada sessizce hiçbir şey yapmaz — hata da almazsınız, bu yüzden fark edilmesi zordur.
İ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.