Estendi editor risorse extending-asset-editor

L’Editor risorse è la pagina che si apre quando si fa clic su una risorsa trovata tramite Condivisione risorse, consentendo all’utente di modificare aspetti della risorsa come metadati, miniature, titolo e tag.

La configurazione dell’editor utilizzando i componenti di modifica predefiniti è descritta in Creazione e configurazione di una pagina Editor risorse.

Oltre a utilizzare componenti editor preesistenti, Adobe Experience Manager gli sviluppatori possono anche creare i propri componenti.

Creare un modello di Editor risorse creating-an-asset-editor-template

Le pagine di esempio seguenti sono incluse in Geometrixx:

Configurare Clientlib configuring-clientlib

Assets I componenti utilizzano un’estensione della libreria client di modifica WCM. Le clientlibs vengono generalmente caricate in init.jsp.

Rispetto al caricamento clientlib predefinito (in core init.jsp), un Assets il modello deve presentare le seguenti caratteristiche:

Nella maggior parte dei casi, la copia del campione esistente init.jsp (/apps/geometrixx/components/asseteditor/init.jsp) deve soddisfare queste esigenze.

Configurare azioni JS configuring-js-actions

Alcune delle Assets I componenti richiedono le funzioni JS definite in component.js. Copia il file nella directory dei componenti e collegalo.

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

L’esempio carica questa origine JavaScript in head.jsp(/apps/geometrixx/components/asseteditor/head.jsp).

Fogli di stile aggiuntivi additional-style-sheets

Alcune delle Assets i componenti utilizzano la libreria widget. Per eseguire correttamente il rendering nel contesto del contenuto, è necessario caricare un foglio di stile aggiuntivo. Il componente Azione tag ne richiede un altro.

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

Foglio di stile Geometrixx geometrixx-style-sheet

I componenti della pagina di esempio richiedono che tutti i selettori inizino con .asseteditor di static.css (/etc/designs/geometrixx/static.css). Best practice: copia tutto .asseteditor selettori nel foglio di stile e regola le regole come desiderato.

FormChooser: regolazioni per le risorse caricate formchooser-adjustments-for-eventually-loaded-resources

L’Editor risorse utilizza il Selettore moduli, che consente di modificare le risorse, in questo caso le risorse, nella stessa pagina del modulo semplicemente aggiungendo un selettore di moduli e il percorso del modulo all’URL della risorsa.

Ad esempio:

Gli handle di esempio in head.jsp (/apps/geometrixx/components/asseteditor/head.jsp) effettuare le seguenti operazioni:

 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();
    }

Nella parte HTML, utilizza il set di titoli precedente (titolo della risorsa o della pagina):

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

Creare un componente campo modulo semplice creating-a-simple-form-field-component

Questo esempio descrive come creare un componente che mostra e visualizza i metadati di una risorsa caricata.

Modifica opzioni metadati modifying-metadata-options

È possibile modificare gli spazi dei nomi disponibili nel modulo metadati.

I metadati attualmente disponibili sono definiti in /libs/dam/options/metadata:

Le opzioni possono essere sovrascritte in /apps/dam/options/metadata: