Kalo te dokumentacioni
Baza e njohurive

Shabllonet

Një trup i shkruar një herë, i versionuar dhe i dërguar shumë herë: nga hartuesi, nga kodi juaj ose nga një agjent.

Detaje

  • Një shabllon i përket lidhjes dhe jo personit që e shkroi, gjë që është e gjithë arsyeja pse versioni i parë i kësaj u zëvendësua. Ai ishte i lidhur me përdoruesin: shablloni i një kolegu ishte i padukshëm për një çelës API të hapësirës së punës, kështu që një integrim nuk mund të dërgonte atë që personi i cili e kishte konfiguruar e shihte, dhe fshirja e llogarisë së autorit merrte me vete shabllonet e hapësirës së punës. Rreshtat u bartën, nuk u hoqën.
  • Dy mënyra për të shkruar një trup. Një pemë blloqesh mbi komponentët e @react-email/components (Section, Row, Column, Container, Text, Heading, Button, Link, Img, Hr, Markdown, CodeBlock, CodeInline), e kontrolluar ndërsa shkruhet, kështu që një nyje e gabuar ose një href i pasigurt refuzohet në vetë thirrjen që e shkroi, në vend që të mbërrijë si një email i prishur. Ose markup që e keni renderuar vetë: nëse shabllonet tuaja janë tashmë komponentë react-email në depon tuaj, renderojini atje me @react-email/render dhe dërgoni HTML-në, e cila pastrohet një herë kur publikohet versioni.
  • Njëzet e tre pika nisjeje dhe një e zbrazët, në një galeri e jo në një meny, sepse këto janë gjëra që duhet t'i shihni para se të zgjidhni mes tyre, prandaj çdo kartë tregon vetë emailin. Mirëseardhje dhe verifikim, dëftesa dhe fatura, dërgesa dhe rinovime, përmbledhje dhe njoftime, të renditura nën katër tituj, dhe secila hapet në redaktuesin vizual me çdo pjesë të lëvizshme, të ristilizueshme dhe të fshishme. Cilëndo që zgjidhni, mbërrin si draft, kështu që asgjë nuk është e dërgueshme derisa ta publikoni.
  • Galeria është e vetmja pjesë e kësaj që gjendet vetëm në aplikacion. Një thirrës që i arrin shabllonet nga kodi juaj ose nga një agjent dërgon një trup (një dokument blloqesh ose markup-in tuaj) në vend që të emërtojë një pikë nisjeje, kështu që të njëzet e tria janë një vend nga ku të fillohet e jo një katalog prej nga instalohet.
  • Slot-et e emërtuara dhe prop-et e emërtuara janë dy llojet e vrimave, të shkruara si {{key}} në trup dhe në subjekt. Një slot mbushet nga kushdo që redakton shabllonin dhe mbart një vlerë të parazgjedhur, kështu që një dërgim që nuk emërton asgjë prapëseprapë renderohet. Një prop jepet në çastin e dërgimit, dhe një i shënuar si i detyrueshëm e refuzon dërgimin kur mungon: një 422, dhe asnjë postë nuk niset. Ai refuzim është arsyeja e deklarimit të tij: alternativa është një mesazh që del me një zbrazëti aty ku duhej numri i porosisë, gjë që asgjë nuk e raporton dhe askush nuk mund ta tërheqë.
  • Një version i publikuar është i ngrirë. Redaktimi i trupit të një shablloni të publikuar krijon një draft të ri në vend që të rishkruajë atë që është live, kështu që dërgimet vazhdojnë të zgjidhin atë që zgjidhnin dje derisa dikush të publikojë, dhe një dërgim që fikson një numër versioni nuk preket as atëherë. Trupi kompilohet në publikim, gjë që bën që një shabllon i cili nuk renderohet të dështojë për personin që e publikon dhe jo për një marrës.
  • Pamja paraprake rendon saktësisht atë që do të prodhonte një dërgim, pa e dërguar, dhe raporton çfarë ka mbetur bosh në vend që ta refuzojë. Një shabllon që shihet paraprakisht zakonisht është një shabllon që po shkruhet, dhe një autor që mbush një bllok në herë nuk duhet të plotësojë çdo prop për të parë se ku ka arritur.
  • Çdo shabllon mban regjistrin e vet të asaj që ka dërguar: sa kanë dalë gjatë shtatë, tridhjetë ose nëntëdhjetë ditëve të fundit, cilat prej tyre u hapën dhe cilat u klikuan, një seri ditë pas dite, dhe një ndarje sipas vendit nga erdhi secili dërgim: hartuesi, kodi juaj, një agjent ose radha. Çdo normë emërton emëruesin e vet në vend që ta huazojë, sepse janë vërtet të ndryshme: hapjet numërohen mbi mesazhet që mbanin një piksel, klikimet mbi mesazhet që mbanin një lidhje të rishkruar, dhe një mesazh mund të mbajë njërën pa tjetrën. Një pamje paraprake nuk regjistrohet kurrë, dhe një dërgim prove numërohet veçmas e lihet jashtë çdo shifre, sepse nuk doli kurrë.
  • Ai regjistër është i ndershëm për atë që nuk e sheh, gjë që është arsyeja për t'i besuar gjysmës që e sheh. Një dërgim përputhet me regjistrin e tij të dorëzimit nëpërmjet vetë dërgimit, dhe vetëm posta e dërguar nga kodi juaj ose nga radha mban një të tillë. Një mesazh i dërguar nga hartuesi, nga një agjent ose nga asistenti nuk mban. Kështu një shabllon i përdorur kryesisht nga hartuesi mbërrin me shumicën e dërgimeve të papërputhura, dhe numri i të papërputhurave shfaqet si shifër më vete e jo i palosur brenda si askush nuk e hapi.
  • Katër sipërfaqe mbi një shërbim të vetëm, kështu që pyetja “çfarë do të thotë publikimi” ka një përgjigje e jo tri që pajtohen sot. Butoni Shabllonet i hartuesit ofron ato të publikuarat dhe E ZËVENDËSON mesazhin me atë që zgjidhni, në vend që ta ngjisë brenda: dërgimi e emërton shabllonin, versioni fiksohet në çastin kur e zgjidhni, dhe trupi renderohet aty ku u shkrua, kështu që një publikim mes zgjedhjes dhe klikimit nuk mund ta ndryshojë atë që del, dhe një strukturë që hartuesi nuk do të mund ta mbante mbijeton e paprekur. Ajo që plotësoni atje janë vlerat, jo trupi. /templates janë nëntë endpoint-e pas scope-eve templates:read dhe templates:write, të mbështjella metodë për metodë nga SDK. Dërgimi i njërit kërkon një leje dërgimi krahas një lejeje shablloni, kështu që një çelës i lëshuar një vegle kopirajtingu mund të shkruajë e të publikojë pa qenë në gjendje t'i dërgojë postë askujt. Serveri MCP mban pesë vegla: list, read, preview, create dhe send. Qëllimisht nuk ka asnjë vegël për të përditësuar, fshirë ose publikuar një ekzistues. Një redaktim krijon një draft te i cili dërgimi i radhës nuk do të zgjidhej, dhe një fshirje nuk mund të kthehet mbrapsht. Redaktimi i një trupi të ruajtur është një ekran: /workspace/templates mban një kanavacë blloqesh me një paletë dhe një inspektor, një pamje paraprake të drejtpërdrejtë pranë saj, dhe Ruaj e Publiko si veprime të ndara, gjë që bën që një version i publikuar të jetë diçka që mund ta lini të qetë ndërsa punoni për të ardhshmin.
  • 200 shabllone për lidhje, një dokument blloqesh i kufizuar në 500 blloqe, tetë nivele fole, 20.000 karaktere në një vlerë të vetme dhe 100 slot-e e 100 prop-e; një trup i dërguar si markup i kufizuar në një milion karaktere, dhe një subjekt në 998. Secili prej tyre është mbrojtje kundër një skripti të shfryrë kontrollit e jo kufi plani, secili refuzon me një mesazh që emërton numrin mbi të cilin refuzoi, dhe asgjë te shabllonet nuk varet nga niveli i planit.