DokumentationAEM 6.5Användarhandbok

Anpassa konsolerna customizing-the-consoles

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Utvecklare
CAUTION
I det här dokumentet beskrivs hur du anpassar konsoler i det moderna, pekaktiverade användargränssnittet och det gäller inte det klassiska användargränssnittet.

AEM innehåller olika mekanismer som gör att du kan anpassa konsolerna (och sidredigeringsfunktionen) för din redigeringsinstans.

  • Clientlibs
    Med Clientlibs kan du utöka standardimplementeringen för att få nya funktioner, samtidigt som du återanvänder standardfunktioner, objekt och standardmetoder. När du anpassar kan du skapa ett eget klientbibliotek under /apps.. Det kan till exempel innehålla den kod som krävs för den anpassade komponenten.

  • Övertäckningar
    Övertäckningar baseras på noddefinitioner och gör att du kan täcka över standardfunktionerna (i /libs) med din egen anpassade funktion (i /apps). När du skapar en övertäckning krävs inte en 1:1-kopia av originalet, eftersom sammanslagningen av försäljningsresurser tillåter arv.

De kan användas på många sätt för att utöka dina AEM. En liten markering beskrivs nedan (på en hög nivå).

NOTE
Mer information finns i:
CAUTION
Du får inte ändra något i sökvägen /libs.
Detta beror på att innehållet i /libs skrivs över nästa gång du uppgraderar din instans (och kan mycket väl skrivas över när du använder en snabbkorrigering eller ett funktionspaket).
Den rekommenderade metoden för konfiguration och andra ändringar är:

  1. Återskapa det obligatoriska objektet (det vill säga som det finns i /libs) under /apps

  2. Gör ändringar i /apps

Följande plats i /libs-strukturen kan till exempel överlappas:

  • konsoler (alla konsoler baserade på GRA-sidor), till exempel:

    • /libs/wcm/core/content
NOTE
Mer information finns i kunskapsbasartikeln Felsökning AEM TouchUI-problem.

Anpassa standardvyn för en konsol customizing-the-default-view-for-a-console

Du kan anpassa standardvyn (kolumn, kort, lista) för en konsol:

  1. Du kan ändra ordningen på vyerna genom att ersätta den önskade posten under:

    /libs/wcm/core/content/sites/jcr:content/views

    Den första posten blir standard.

    De tillgängliga noderna motsvarar de visningsalternativ som är tillgängliga:

    • column
    • card
    • list

  2. I en övertäckning för list:

    /apps/wcm/core/content/sites/jcr:content/views/list

    Definiera följande egenskap:

    • Namn: sling:orderBefore
    • Typ: String
    • Värde: column

Lägg till ny åtgärd i verktygsfältet add-new-action-to-the-toolbar

  1. Du kan skapa egna komponenter och inkludera motsvarande klientbibliotek för anpassade åtgärder. Exempel: en Befordra till Twitter-åtgärd vid:

    /apps/wcm/core/clientlibs/sites/js/twitter.js

    Detta kan sedan anslutas till ett verktygsfältsobjekt på konsolen:

    /apps/<yourProject>/admin/ext/launches

    I markeringsläge:

    content/jcr:content/body/content/header/items/selection/items/twitter

Begränsa en verktygsfältåtgärd till en viss grupp restrict-a-toolbar-action-to-a-specific-group

  1. Du kan använda ett anpassat återgivningsvillkor om du vill täcka över standardåtgärden och ange särskilda villkor som måste uppfyllas innan den återges.

    Skapa till exempel en komponent som styr återgivningsvillkoren enligt grupp:

    /apps/myapp/components/renderconditions/group

  2. Så här använder du åtgärden Skapa plats på webbplatskonsolen:

    /libs/wcm/core/content/sites

    Skapa övertäckningen:

    /apps/wcm/core/content/sites

  3. Lägg sedan till återgivningsvillkoret för åtgärden:

    jcr:content/body/content/header/items/default/items/create/items/createsite/rendercondition

    Med hjälp av egenskaper på den här noden kan du definiera groups som tillåts utföra den specifika åtgärden, till exempel administrators

Anpassa kolumner i listvyn customizing-columns-in-the-list-view

NOTE
Den här funktionen är optimerad för kolumner med textfält. För andra datatyper går det att täcka över cq/gui/components/siteadmin/admin/listview/columns/analyticscolumnrenderer i /apps.

Så här anpassar du kolumnerna i listvyn:

  1. Lägg över listan med tillgängliga kolumner.

    • På noden:

      code language-none 
             /apps/wcm/core/content/common/availablecolumns

    • Lägg till nya kolumner eller ta bort befintliga.

    Mer information finns i Använda övertäckningar (och Sling Resource Merger).

  2. Valfritt:

    • Om du vill lägga till ytterligare data måste du skriva en PageInforProvider med en

      Egenskapen pageInfoProviderType.

    Se till exempel klassen/paketet som bifogas (från GitHub) nedan.

  3. Nu kan du markera kolumnen i listvyns kolumnkonfigurator.

Filtreringsresurser filtering-resources

När du använder en konsol är ett vanligt användningsfall när användaren måste välja bland resurser (till exempel sidor, komponenter, resurser och så vidare). Detta kan t.ex. vara en lista som författaren måste välja ett alternativ från.

För att hålla listan i en rimlig storlek och även relevant för användningsfallet kan ett filter implementeras i form av ett anpassat predikat. Mer information finns i den här artikeln.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2