E-postupplevelsefragmentkomponent email-experience-fragment-component

Med e-postupplevelsefragmentkomponenten kan innehållsförfattaren placera en Experience Fragment-variant i sitt innehåll samtidigt som den stöder en lokaliserad innehållsstruktur.

Användning usage

Med e-postupplevelsefragmentkomponenten kan innehållsförfattaren välja bland befintliga Experience Fragment-varianter och placera en i innehållet. En Experience Fragment är en grupp innehåll som innehåller både innehåll och layout och som kan återanvändas i alla kanaler.

  • Komponentens egenskaper kan definieras i dialogrutan Konfigurera.
  • Standardvärden för komponenten när den läggs till i innehåll kan definieras i designdialogrutan.

Komponenten för e-postupplevelsefragment stöder en lokaliserad platsstruktur.

Version och kompatibilitet version-and-compatibility

Den aktuella versionen av e-postupplevelsefragmentkomponenten är v1, som introducerades med version X av e-postkärnkomponenterna i oktober 2022, och som beskrivs i det här dokumentet.

Följande tabell visar alla versioner av komponenten som stöds, de AEM versionerna som komponenterna är kompatibla med och länkar till dokumentation för tidigare versioner.

Komponentversion
AEM 6.5
AEM as a Cloud Service
v1
Kompatibel
-

Mer information om e-postkärnkomponentens versioner och versioner finns i dokumentet E-postkärnkomponentversioner.

Lokaliserat stöd för webbplatsstruktur localized-site-structure

Komponenten för e-postupplevelsefragment anpassar sig till lokaliserade innehållsstrukturer och återger rätt Experience Fragment baserat på innehållets lokalisering. För att göra detta måste Experience Fragment uppfylla följande villkor.

  • E-postupplevelsefragmentkomponenten har lagts till i en sidmall.
  • Den mallen används för att skapa en ny innehållssida som är en del av en lokaliserad struktur under /content/<site>.
  • Experience Fragment som refereras på en innehållssida är en del av en lokaliserad Experience Fragment-struktur under /content/experience-fragments som följer samma mönster som webbplatsen under /content/<site>, inklusive användning av samma komponentnamn.

I det här fallet återges fragmentet med samma lokalisering (språk, utkast eller live-kopia) som den aktuella sidan som en del av mallen.

Det här beteendet är begränsat till e-postupplevelsefragmentkomponenter som lagts till i mallar. Experience Fragment Components som lagts till på enskilda innehållssidor återger exakt de Experience Fragment-återgivningar som konfigurerats i komponenten.

Exempel example

Låt oss säga att innehållet ser ut ungefär så här:

/content
+-- experience-fragments
   \-- wknd
      +-- language-masters
      +-- us
         +-- en
            +-- footerTextXf
            \-- headerTextXf
         \-- es
            +-- footerTextXf
            \-- headerTextXf
      \-- ch
         +-- de
            +-- footerTextXf
            \-- headerTextXf
         +-- fr
            +-- footerTextXf
            \-- headerTextXf
         \-- it
            +-- footerTextXf
            \-- headerTextXf
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   +-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

Observera att strukturen under /content/experience-fragments/wknd speglar strukturen för /content/wknd.

I det här fallet, om e-postupplevelsefragmentkomponenten /content/experience-fragments/wknd/us/en/footerTextXf placeras i en mall, kommer de lokaliserade sidor som skapas baserat på den mallen automatiskt att återge det lokaliserade Experience Fragment som motsvarar den lokaliserade innehållssidan.

Om du navigerar till en innehållssida under /content/wknd/ch/de som använder samma mall återges /content/experience-fragments/wknd/ch/de/footerTextXf i stället för /content/experience-fragments/wknd/us/en/footerTextXf.

Reserv fallback

Komponenten för e-postupplevelsefragment försöker hitta en motsvarande lokaliserad komponent i följande ordning.

  1. Först försöker den hitta en språkrot.
  2. Om den inte hittas försöker den hitta en plan.
  3. Om den inte hittas försöker den hitta en live-kopia.
  4. Om den inte hittas används som standard det Experience Fragment som konfigurerats i komponenten.

Teknisk information technical-details

Läs den senaste tekniska dokumentationen om Experience Fragment-komponenten.

Mer information om hur du utvecklar kärnkomponenterna finns i dokumentationen för Core Components Developer.

Konfigurera dialogruta configure-dialog

I dialogrutan Konfigurera kan innehållsförfattaren välja den Experience Fragment-variant som ska återges i innehållet.

Redigeringsdialogrutan för e-postupplevelsefragmentkomponenten

Använd knappen Öppna dialogrutan Markering för att öppna komponentväljaren och välja vilken Experience Fragment-komponentvariation som ska läggas till på innehållssidan.

Om du lägger till e-postupplevelsefragmentkomponenten i en mall lokaliseras den automatiskt, förutsatt att Experience Fragments är lokaliserade, så det som återges på sidan kan variera från den komponent som du uttryckligen väljer. Se exemplet ovan för mer information.

Du kan också definiera ett ID. Med det här alternativet kan du kontrollera den unika identifieraren för komponenten i HTM.

  • Om du inte anger något värde genereras ett unikt ID automatiskt och du hittar det genom att kontrollera innehållet.
  • Om ett ID anges är det författarens ansvar att se till att det är unikt.
  • Om du ändrar ID:t kan det påverka CSS.

Fliken Format styles-tab-edit

E-postupplevelsefragmentkomponenten stöder AEM Style System.

Använd listrutan för att välja de format som du vill använda på komponenten. Markeringar som görs i redigeringsdialogrutan har samma effekt som de som väljs i komponentverktygsfältet.

Format måste konfigureras för den här komponenten i designdialogrutan för att fliken ska vara tillgänglig.

Designdialogruta design-dialog

I designdialogrutan kan mallskaparen definiera de alternativ som är tillgängliga för den som använder e-postupplevelsefragmentkomponenten och de standardvärden som anges när e-postupplevelsefragmentkomponenten placeras.

Fliken Format styles-tab

E-postupplevelsefragmentkomponenten stöder AEM Style System.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c