Anpassa och utöka den universella redigeraren customizing-extending

Lär dig mer om de olika tilläggspunkterna och andra funktioner som gör att du kan anpassa redigeringsmiljön i den universella redigeraren så att den passar de behov som finns hos skribenterna.

Ökning overview

Med Universell redigerare kan du anpassa två typer av projekt efter dina behov.

Båda typerna beskrivs i följande avsnitt.

Anpassa den universella redigeraren customizing

Den universella redigeraren har flera inbyggda alternativ för att anpassa funktionaliteten.

Inaktiverar publicering disable-publish

Vissa redigeringsarbetsflöden kräver att innehållet granskas innan det publiceras. I sådana fall bör alternativet att publicera inte vara tillgängligt för någon författare.

Knappen Publish kan därför undertryckas helt i ett program genom att följande metadata läggs till.

<meta name="urn:adobe:aue:config:disable" content="publish"/>

Filtrera komponenter filtering-components

När du använder Universal Editor kan du begränsa vilka komponenter som tillåts per behållarkomponent. För att göra detta måste du infoga ytterligare en script-tagg som pekar på filterdefinitionen.

<script type="application/vnd.adobe.aue.filter+json" src="/static/filter-definition.json"></script>

En filterdefinition kan se ut så här, vilket begränsar en behållare så att bara text och bilder kan läggas till.

[
  {
    "id": "container-filter",
     "components": ["text", "image"]
   }
]

Sedan kan du referera till filterdefinitionen från behållarkomponenten genom att lägga till egenskapen data-aue-filter och skicka ID:t för filtret som du definierade tidigare.

data-aue-filter="container-filter"

Om attributet components i en filterdefinition anges till null tillåts alla komponenter, som om det inte fanns något filter.

[
  {
    "id": "another-container-filter",
     "components": null
   }
]

Visa och dölj komponenter villkorligt på egenskapspanelen conditionally-hide

Även om en eller flera komponenter i allmänhet är tillgängliga för författarna, kan det finnas situationer där det inte passar. I så fall kan du dölja komponenter på egenskapspanelen genom att lägga till ett condition-attribut i fälten i komponentmodellen.

Villkoren kan definieras med hjälp av JsonLogic-schema. Om villkoret är sant visas fältet. Om villkoret är falskt döljs fältet.

Exempelmodell
code language-json
 {
    "id": "conditionally-revealed-component",
    "fields": [
      {
        "component": "boolean",
        "label": "Shall the text field be revealed?",
        "name": "reveal",
        "valueType": "boolean"
      },
      {
        "component": "text-input",
        "label": "Hidden text field",
        "name": "hidden-text",
        "valueType": "string",
        "condition": { "===": [{"var" : "reveal"}, true] }
      }
    ]
 }
Villkorsfel
Dolt textfält
Sant villkor
Visar textfält

URL för anpassad förhandsvisning custom-preview-urls

Du kan ange en anpassad URL för förhandsgranskning via en urn:adobe:aue:config:preview-metakonfiguration, som öppnas när du klickar på knappen Öppna sida i redigerarens övre högra verktygsfält.

Detta är särskilt användbart för program med särskilda förhandsgranskningskrav, till exempel de som använder Edge Delivery Services med WYSIWYG-redigering.

Det gör du genom att helt enkelt ta med önskad URL för förhandsgranskning i en meta-tagg för det instrumenterade programmet, som i följande exempel.

<meta name="urn:adobe:aue:config:preview" content="https://wknd.site"/>

Utöka gränssnittet för Universal Editor extending

Som Adobe Experience Cloud-tjänst kan du utöka UI för den universella redigeraren med App Builder och Experience Manager.

Gränssnittstillägg är JavaScript-program som skapats med Adobe App Builder och som kan bäddas in i UI-program som körs med Adobe Experience Cloud enhetliga gränssnitt, till exempel Universal Editor. Du kan lägga till egna knappar och åtgärder på rubrikmenyn och egenskapspanelen samt skapa egna händelser för den universella redigeraren.

Om du vill utforska de här möjligheterna kan du läsa följande resurser:

  1. UI-utökningsbarhet - Det här är utvecklardokumentationen för UI-tillägg.
  2. Guider för användargränssnittstillägg - stegvisa instruktioner för hur du utvecklar egna tillägg
  3. Extension Points för Universal Editor - Universell redigeringsspecifik dokumentation för tilläggspunkter
TIP
Om du föredrar att lära dig som exempel kan du läsa självstudiekursen AEM UI extensibility. Även om den fokuserar på att utöka konsolen för innehållsfragment är begreppen för implementering av ett UI-tillägg i den universella redigeraren desamma.

Med Extension Manager i AEM Sites kan du aktivera eller inaktivera tillägg per instans, få åtkomst till tillägg från första Adobe, inklusive tillägg för den universella redigeraren, och mycket annat.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab