DocumentazioneAEM 6.5Guida utente

Personalizzazione delle console customizing-the-consoles

Last update: Thu Aug 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore
CAUTION
Questo documento descrive come personalizzare le console nella moderna interfaccia touch e non si applica all’interfaccia classica.

AEM fornisce vari meccanismi per consentirti di personalizzare le console (e la funzionalità di authoring delle pagine) della tua istanza di authoring.

  • Clientlibs
    Le clientlibs consentono di estendere l’implementazione predefinita per realizzare nuove funzionalità, riutilizzando le funzioni, gli oggetti e i metodi standard. Durante la personalizzazione, puoi creare una libreria client personalizzata in /apps.. Ad esempio, può contenere il codice necessario per il componente personalizzato.

  • Sovrapposizioni
    Le sovrapposizioni si basano sulle definizioni dei nodi e consentono di sovrapporre la funzionalità standard (in /libs) con la funzionalità personalizzata (in /apps). Quando crei una sovrapposizione, non è necessaria una copia 1:1 dell’originale, in quanto la fusione di risorse sling consente l’ereditarietà.

Questi possono essere utilizzati in molti modi per estendere le console AEM. Di seguito è riportata una piccola selezione (ad alto livello).

NOTE
Per ulteriori informazioni, consulta:
CAUTION
must non modificare nulla nel percorso /libs.
Il contenuto di /libs viene sovrascritto al successivo aggiornamento dell'istanza (e potrebbe essere sovrascritto quando si applica un hotfix o un feature pack).
Il metodo consigliato per la configurazione e altre modifiche è:

  1. Ricrea l'elemento richiesto (ovvero, poiché esiste in /libs) in /apps

  2. Apporta le modifiche in /apps

Ad esempio, è possibile sovrapporre la seguente posizione all'interno della struttura /libs:

  • console (tutte le console basate sulle pagine dell’interfaccia utente Granite); ad esempio:

    • /libs/wcm/core/content
NOTE
Per ulteriori suggerimenti e strumenti, consulta l'articolo della Knowledge Base Risoluzione dei problemi relativi all'interfaccia utente touch dell'AEM.

Personalizzazione della vista predefinita per una console customizing-the-default-view-for-a-console

Puoi personalizzare la vista predefinita (colonna, scheda, elenco) per una console:

  1. È possibile riordinare le viste sovrapponendo la voce richiesta da in:

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

    La prima voce sarà quella predefinita.

    I nodi disponibili sono correlati alle opzioni di visualizzazione disponibili:

    • column
    • card
    • list

  2. Ad esempio, in un elenco di sovrapposizione per:

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

    Definisci la seguente proprietà:

    • Nome: sling:orderBefore
    • Tipo: String
    • Valore: column

Aggiungi nuova azione alla barra degli strumenti add-new-action-to-the-toolbar

  1. Puoi creare componenti personalizzati e includere le librerie client corrispondenti per le azioni personalizzate. Ad esempio, un'azione Promuovi al Twitter in:

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

    Questa può quindi essere collegata a un elemento della barra degli strumenti nella console:

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

    Ad esempio, in modalità di selezione:

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

Limitare un'azione della barra degli strumenti a un gruppo specifico restrict-a-toolbar-action-to-a-specific-group

  1. Puoi utilizzare una condizione di rendering personalizzata per sovrapporre l’azione standard e imporre condizioni specifiche che devono essere soddisfatte prima che venga eseguito il rendering.

    Ad esempio, crea un componente per controllare le condizioni di rendering in base al gruppo:

    /apps/myapp/components/renderconditions/group

  2. Per applicare questi elementi all’azione Crea sito nella console Sites:

    /libs/wcm/core/content/sites

    Crea la sovrapposizione:

    /apps/wcm/core/content/sites

  3. Quindi aggiungi la condizione di rendering per l’azione:

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

    Utilizzando le proprietà in questo nodo è possibile definire il groups consentito per eseguire l'azione specifica, ad esempio administrators

Personalizzazione delle colonne nella vista a elenco customizing-columns-in-the-list-view

NOTE
Questa funzionalità è ottimizzata per colonne di campi di testo; per altri tipi di dati è possibile sovrapporre cq/gui/components/siteadmin/admin/listview/columns/analyticscolumnrenderer in /apps.

Per personalizzare le colonne nella vista a elenco:

  1. Sovrapponi l’elenco delle colonne disponibili.

    • Sul nodo:

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

    • Aggiungi le nuove colonne o rimuovi quelle esistenti.

    Per ulteriori informazioni, consulta Utilizzo di sovrapposizioni (e Sling Resource Merger).

  2. Facoltativamente:

    • Se si desidera inserire dati aggiuntivi, è necessario scrivere un PageInforProvider con un

      Proprietà pageInfoProviderType.

    Ad esempio, consulta la classe/bundle allegato (da GitHub) di seguito.

  3. Ora puoi selezionare la colonna nel configuratore di colonne della vista a elenco.

Filtrare le risorse filtering-resources

Quando si utilizza una console, un caso d’uso comune si verifica quando l’utente deve selezionare tra le risorse (ad esempio pagine, componenti, risorse e così via). Può assumere la forma di un elenco, ad esempio, dal quale l’autore deve scegliere un elemento.

Per mantenere l’elenco a una dimensione ragionevole e pertinente al caso d’uso, un filtro può essere implementato sotto forma di predicato personalizzato. Per ulteriori informazioni, vedere Personalizzazione dell'authoring delle pagine - Filtraggio delle risorse.

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