Utöka resursredigeraren extending-asset-editor

Resursredigeraren är den sida som öppnas när användaren klickar på en resurs som hittas via Resursresurs, så att användaren kan redigera sådana aspekter av resursen som metadata, miniatyrbilder, rubrik och taggar.

Konfiguration av redigeraren med de fördefinierade redigeringskomponenterna beskrivs i Skapa och konfigurera en resursredigeringssida.

Förutom att använda befintliga redigeringskomponenter kan Adobe Experience Manager-utvecklare även skapa egna komponenter.

Skapa en resursredigeringsmall creating-an-asset-editor-template

Följande exempelsidor finns i geometrixx:

Konfigurerar Clientlib configuring-clientlib

Experience Manager Assets -komponenter använder ett tillägg till WCM-klienten för redigering. Klientlibs läses vanligtvis in i init.jsp.

Jämfört med standardinläsning av klientlib (i kärnan) init.jsp), Assets -mallen måste ha följande:

I de flesta fall kopieras det befintliga exemplet init.jsp (/apps/geometrixx/components/asseteditor/init.jsp) ska tillgodose dessa behov.

Konfigurera JS-åtgärder configuring-js-actions

Vissa av Assets komponenter kräver JS-funktioner definierade i component.js. Kopiera den här filen till komponentkatalogen och länka den.

<script type="text/javascript" src="<%= component.getPath() %>/component.js"></script>

Exemplet läser in den här JavaScript-källan i head.jsp(/apps/geometrixx/components/asseteditor/head.jsp).

Ytterligare formatmallar additional-style-sheets

Vissa av Assets använder Experience Manager widgetbibliotek. För att kunna återges korrekt i innehållskontexten måste ytterligare en formatmall läsas in. Kodåtgärdskomponenten kräver en till.

<link href="/etc/designs/geometrixx/ui.widgets.css" rel="stylesheet" type="text/css">

Geometrixx formatmall geometrixx-style-sheet

Komponenterna för exempelsidorna kräver att alla väljare börjar med .asseteditor av static.css (/etc/designs/geometrixx/static.css). Bästa praxis: Kopiera alla .asseteditor väljare till formatmallen och justera reglerna efter behov.

FormChooser: Justeringar för resurser som slutligen läses in formchooser-adjustments-for-eventually-loaded-resources

Resursredigeraren använder formulärväljaren, som gör att du kan redigera resurser - i det här fallet resurser - på samma formulärsida genom att lägga till en formulärväljare och formulärsökvägen till resursens URL.

Till exempel:

Exempelhandtagen i head.jsp (/apps/geometrixx/components/asseteditor/head.jsp) gör följande:

 List<Resource> resources = FormsHelper.getFormEditResources(slingRequest);
    if (resources != null) {
        if (resources.size() == 1) {
            // single resource
            FormsHelper.setFormLoadResource(slingRequest, resources.get(0));
        } else if (resources.size() > 1) {
            // multiple resources
            // not supported by CQ 5.3
        }
    }
    Resource loadResource = (Resource) request.getAttribute("cq.form.loadresource");
    String title;
    if (loadResource != null) {
        // an asset is loaded: disable WCM
        WCMMode.DISABLED.toRequest(request);

        String path = loadResource.getPath();
        Asset asset = loadResource.adaptTo(Asset.class);
        try {
            // it might happen that the adobe xmp lib creates an array
            Object titleObj = asset.getMetadata("dc:title");
            if (titleObj instanceof Object[]) {
                Object[] titleArray = (Object[]) titleObj;
                title = (titleArray.length > 0) ? titleArray[0].toString() : "";
            } else {
                title = titleObj.toString();
            }
        }
        catch (NullPointerException e) {
            title = path.substring(path.lastIndexOf("/") + 1);
        }
    }
    else {
        title = currentPage.getTitle() == null ? currentPage.getName() : currentPage.getTitle();
    }

Använd den föregående titeluppsättningen (antingen resurs eller sidrubrik) i HTML-delen:

<title><%= title %></title>

Skapa en enkel formulärfältskomponent creating-a-simple-form-field-component

I det här exemplet beskrivs hur du skapar en komponent som visar och visar metadata för en inläst resurs.

Ändra metadataalternativ modifying-metadata-options

Du kan ändra de namnutrymmen som finns i dialogrutan metadataformulär.

Tillgängliga metadata definieras i /libs/dam/options/metadata:

Alternativen kan skrivas över i /apps/dam/options/metadata: