Bildirim Şablonları Nasıl Çalışır

Platformun gönderdiği her e-posta ve her kısa mesaj, olay ve dil başına diskteki üç dosyadan üretilir. Bir şablon yazarı bu dosyaların sahibidir, tıpkı bir tema yazarının view'ının sahibi olduğu gibi.

Genel Bakış

Bildirim kodun içinde yazılmaz. Kod bir şeyin olduğuna karar verip olguları teslim eder; sözcükler, işaretleme ve konu satırı templates/notifications altında yaşar. Bir kurulum müşterisinin okuduğu metni geliştiriciye ihtiyaç duymadan değiştirebilir, bir modül de kendi sözcüklerini paketleyebilir.

Birim olaydır ve grup/ad biçiminde yazılır. Her olay, kurulu her dilde üç dosyaya sahiptir: e-posta gövdesi, kısa mesaj gövdesi ve konu satırını taşıyan küçük bir dosya. E-posta gövdesi bir belge değil parçadır.

Şablona iki şey ulaşır. Grubun çözümleyicisi (resolver) çağıranın verdiğini (bir fatura satırı, bir hizmet kimliği, bir talep) adlandırılmış değişkenlere çevirir. Platform da kurulumun kendi değerlerini üstüne ekler: logolar, renkler, şirket bilgileri ve alıcının profili. Şablon yalnızca gösterir.

Yapı

Dosya Düzeni

Üç kök var ve her biri ayrı bir soruyu yanıtlar. Konu satırı ve kısa mesaj, e-posta nasıl görünürse görünsün aynı okunur; tasarımların tamamen dışında yaşarlar. E-posta gövdesi ise onu üreten tasarıma aittir.

templates/notifications/
├── content/                     # PAYLAŞILAN METİN — tek kopya her tasarıma hizmet eder
│   └── en/invoice/
│       ├── invoice-created.json   # {"subject": "..."}
│       └── invoice-created.txt    # kısa mesaj gövdesi, hiç kabuk yok
├── themes/                      # TASARIM — kurulu tasarım başına bir dizin
│   ├── aurora/                  # ürünle birlikte gelen tasarım
│   │   ├── header.html            # en dıştaki kabuk
│   │   ├── content.html           # gövde yuvası, tek bir {$notifi_body} yer tutucusu
│   │   ├── footer.html            # kapanış kabuğu
│   │   └── en/invoice/
│   │       └── invoice-created.html   # e-posta gövdesi, kabuğun bir PARÇASI
│   └── ledger/                  # ikinci tasarım; olayların yalnız bir kısmını taşıyabilir
├── custom/                      # operatörün kendi düzenlemeleri, tasarım başına bir ağaç
│   └── ledger/en/invoice/invoice-created.html
└── .htaccess                    # bu ağaçtan HTTP ile hiçbir şey sunulmaz

Bu yolları elle kurmayın: sırayı bilen tek yer aşağıdaki yardımcılardır. O olay için dosyası olmayan bir tasarım maili yine gönderir: gövde taban tasarımdan gelir, kabuk kendisinin kalır.

Kabuk

E-posta gövdesi tek başına gönderilmez. Platform üç dosyayı tek bir kabukta birleştirir, biten olay gövdesini notifi_body değişkenine atar ve kabuğu aynı değişkenlerle üretir. Kabuk da gövdeyle aynı sırayla çözülür; kendi kabuğunu taşımayan bir tasarım maillerini taban kabuğuyla çerçeveler.

Gruplar ve Çözümleyiciler

Grup aynı anda hem bir dizin hem de yapılandırma dosyasının bir bölümüdür. Değişkenleri hangi çözümleyicinin kuracağını ve alıcının tercihlerinin hangi bildirim kategorisine karşı denetleneceğini o belirler.

Son iki satır, bir olayın normal yoldan geçmeden var olabilmesinin iki biçimidir. newsletter yapılandırma kayıtlarına sahip ama çözümleyicisi yok, yani bir dispatch error döner. Şablonları doğrudan üretilip kuyruğa itilir ve değişkenleri bülten kodu kendisi verir. license-transfer ise tam tersi: üç olay diskte durur ve yapılandırmada hiç bölümü yoktur. Düşük seviyeli giriş noktasından gönderilirler; o giriş noktası ayar bulamadığında e-posta ve kısa mesajı açık kabul eder.

Teslim Yolu

Tek bir çağrıdan gerçek bir mesaja giden zincir sabittir ve her adım zinciri bitirebilir.

Notification::dispatch('invoice', 'invoice-created', ['entity' => $invoice])
  1. gate:notification.dispatch          bir dinleyici veto edebilir  -> blocked
  2. notifications/invoice/invoice-created okunur                     -> yoksa/kapalıysa disabled
  3. grubun çözümleyicisi: entity -> değişkenler + user_id            -> boş dönerse error
  4. alıcının tercih bitmask'i kategoriye karşı denetlenir            -> opted_out
  5. alıcı listesi kurulur (sahip, ek adresler, yöneticiler)          -> boşsa no_recipients
  6. alıcı BAŞINA render: o alıcının dili ve kanalıyla
  7. olay sync listesindeyse hemen gönderilir, değilse kuyruğa yazılır -> sent | queued
  8. panel içi satırlar yazılır: alıcının kendi satırı ve yönetici kopyası
  9. action:notification.dispatched

Şablon 6. adımda, dispatch başına değil alıcı başına bir kez okunur: aynı olayın iki alıcısı farklı dillerde ve farklı kanallarda okuyor olabilir. 7. adımdaki eşzamanlı liste kısadır ve güvenlik açısından kritik olayları taşır; geri kalan her şey kuyruğu bekler.

Bir ad 1. adımdan önce değişir. E-posta aktarımıyla açılan talepte ticket-replied-by-admin, ticket-replied-by-admin-pipe olur. Zincirdeki her kanca değişen adı görür; adıyla süzen dinleyici iki adı da tanımalıdır. 8. adımda müşteri için yazılan panel içi satır istenen adı korur.

Referans

İki Giriş Noktası

public static function dispatch(string $group, string $name, array $context = []): array;
public static function send(array $params): array|string|bool;
public static function get_recipients(string $group, string $name, array $context = []): array;

Bir Dispatch Ne Döner

Asla bir boolean değil, istisna da fırlatmaz. Dizi her zaman status taşır; başarılı olan ayrıca batch_id ve items altında alıcı başına bir kayıt taşır.

partial, yeniden deneyen bir çağırana denemenin güvenli olup olmadığını söyler. false: hatadan önce hiçbir şey çıkmadı, yeniden dispatch bildirimi bir kez gönderir. true: bir mesaj ya da panel içi satır zaten çıktı, yeniden dispatch o kısmı tekrarlar.

Şablon Motoru

Dosyaları hangi motorun ayrıştıracağı kurulum geneli bir ayardır ve options/notification-template-engine anahtarından okunur. Smarty olarak gelir ve ağaçtaki her şablon ona göre yazılmıştır. İki değer daha vardır: Twig ve yalnızca {ad} biçimini anlayan düz dize değiştirme kipi.

Bu motor tema kum havuzu değildir ve onun gibi davranmaz:

Kuyruk

Tuzaklar

İlgili Makaleler

• E-posta Şablonu Yazma
• SMS Şablonu Yazma
• Bildirim Şablonu Değişkenleri
• Mail Modülü Yazma
• SMS Modülü Yazma
• Kanca Dinleyicisi Yazma