Estender editor de ativos extending-asset-editor

O Editor de ativos é a página que abre quando um ativo encontrado por meio do Compartilhamento de ativos é clicado, permitindo que o usuário edite esses aspectos do ativo como metadados, miniatura, título e tags.

A configuração do editor usando os componentes de edição predefinidos é abordada em Criação e configuração de uma página do editor de ativos.

Além de usar componentes de editor pré-existentes, os desenvolvedores do Adobe Experience Manager também podem criar seus próprios componentes.

Criar um modelo do Editor de ativos creating-an-asset-editor-template

As seguintes páginas de exemplo estão incluídas no Geometrixx:

Configurar Clientlib configuring-clientlib

Assets componentes usam uma extensão da biblioteca de edição do WCM. Normalmente, as clientlibs são carregadas em init.jsp.

Comparado ao carregamento padrão clientlib (no núcleo init.jsp), um modelo Assets deve ter o seguinte:

Na maioria dos casos, copiar a amostra existente init.jsp (/apps/geometrixx/components/asseteditor/init.jsp) deve atender a essas necessidades.

Configurar ações JS configuring-js-actions

Alguns dos componentes Assets exigem funções JS definidas em component.js. Copie este arquivo para o diretório do componente e vincule-o.

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

A amostra carrega esta origem JavaScript em head.jsp(/apps/geometrixx/components/asseteditor/head.jsp).

Folhas de estilos adicionais additional-style-sheets

Alguns dos componentes do Assets usam a biblioteca de widgets. Para ser renderizada corretamente no contexto de conteúdo, uma folha de estilos adicional deve ser carregada. O componente de ação de tag requer mais um.

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

Folha de Estilos do Geometrixx geometrixx-style-sheet

Os componentes de página de exemplo exigem que todos os seletores comecem com .asseteditor de static.css (/etc/designs/geometrixx/static.css). Prática recomendada: copiar todos os seletores .asseteditor para sua folha de estilos e ajustar as regras conforme desejado.

FormChooser: ajustes para recursos eventualmente carregados formchooser-adjustments-for-eventually-loaded-resources

O Editor de ativos usa o Seletor de formulários, que permite editar recursos — neste caso, ativos — na mesma página de formulário simplesmente adicionando um seletor de formulários e o caminho do formulário para o URL do ativo.

Por exemplo:

Os identificadores de exemplo em head.jsp (/apps/geometrixx/components/asseteditor/head.jsp) fazem o seguinte:

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

Na parte HTML, use o conjunto de títulos anterior (título de ativo ou página):

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

Criar um componente de campo de formulário simples creating-a-simple-form-field-component

Este exemplo descreve como criar um componente que mostra e exibe os metadados de um ativo carregado.

Modificar opções de metadados modifying-metadata-options

Você pode modificar os namespaces disponíveis no formulário de metadados.

Os metadados disponíveis no momento estão definidos em /libs/dam/options/metadata:

As opções podem ser substituídas em /apps/dam/options/metadata: