Incorpora componente

Il componente Incorpora componenti core consente di incorporare contenuto esterno in una pagina di contenuto AEM.

Utilizzo

Il componente core Incorpora componente permette all’autore del contenuto di definire il contenuto esterno selezionato da incorporare all’interno di una pagina di contenuto AEM. Inoltre, è disponibile un’opzione per definire anche l’HTML a forma libera da incorporare.

  • Le proprietà del componente possono essere definite nella finestra di dialogo di configurazione.
  • I valori predefiniti per il componente quando viene aggiunto a una pagina possono essere definiti nella finestra di dialogo di progettazione a1/>.

Versione e compatibilità

La versione corrente del componente Incorpora è v1, introdotto con la release 2.7.0 dei componenti core a settembre 2019, ed è descritto in questo documento.

Nella tabella seguente sono elencate tutte le versioni supportate del componente, le versioni AEM con cui sono compatibili le versioni del componente e i collegamenti alla documentazione delle versioni precedenti.

Versione componente AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 Compatibile Compatibile Compatibile

Per ulteriori informazioni sulle versioni e sulle versioni dei componenti core, consultare il documento Versioni dei componenti core.

Esempio di output del componente

Per provare il componente Incorpora e vedere esempi delle relative opzioni di configurazione, nonché l'output HTML e JSON, visitare la Libreria componenti.

Dettagli tecnici

La documentazione tecnica più recente sul componente Incorpora è disponibile su GitHub.

Ulteriori dettagli sullo sviluppo di componenti core sono disponibili nella documentazione per lo sviluppo di componenti core.

Configura finestra di dialogo

La finestra di dialogo di configurazione consente all’autore del contenuto di definire la risorsa esterna da incorporare nella pagina. Scegliete innanzitutto il tipo di risorsa da incorporare:

Per ciascun tipo di modulo da incorporare, è possibile definire ad ID. Questa opzione consente di controllare l'identificatore univoco del componente nell'HTML e nel Livello dati.

  • Se lasciato vuoto, viene generato automaticamente un ID univoco che può essere trovato esaminando la pagina risultante.
  • Se viene specificato un ID, è responsabilità dell’autore assicurarsi che sia univoco.
  • La modifica dell’ID può avere un impatto su CSS, JS e tracciamento dei livelli di dati.

URL

L’incorporamento più semplice è l’URL. È sufficiente incollare l'URL della risorsa da incorporare nel campo URL. Il componente tenterà di accedere alla risorsa e, se può essere rappresentato da uno dei processori, visualizzerà un messaggio di conferma sotto il campo URL. In caso contrario, il campo verrà contrassegnato come errore.

Il componente Incorpora viene fornito con processori per i seguenti tipi di risorse:

  • Risorse conformi allo standard oEmbed, inclusi post di Facebook, Instagram, SoundCloud, Twitter e YouTube
  • Pinterest

Gli sviluppatori possono aggiungere altri processori URL seguendo la documentazione sviluppatore del componente Incorpora.

Finestra di dialogo di modifica del componente Incorpora per l’URL

Contenuto incorporabile

Le variabili da incorporare consentono una maggiore personalizzazione della risorsa incorporata, che può essere parametrizzata e che include informazioni aggiuntive. Un autore può scegliere tra file da incorporare affidabili preconfigurati e i componenti vengono forniti con un out-of-the-box integrabile su YouTube.

Il campo Embedable definisce il tipo di processore da utilizzare. Nel caso di YouTube embedable potete quindi definire:

  • ID video - ID video univoco da YouTube della risorsa da incorporare
  • Larghezza - La larghezza del video incorporato
  • Altezza - L'altezza del video incorporato

Altri elementi da incorporare offrirebbero campi simili e possono essere definiti da uno sviluppatore da seguendo la documentazione sviluppatore del componente Incorpora.

Finestra di dialogo di modifica per i componenti da incorporare

NOTA

Per essere disponibili per l'autore della pagina, è necessario abilitare le variabili da incorporare a livello di modello tramite la finestra di dialogo Progettazione.

HTML

È possibile aggiungere alla pagina codice HTML a forma libera utilizzando il componente Incorpora.

Finestra di dialogo di modifica del componente Incorpora per HTML

NOTA

Eventuali tag non sicuri, come gli script, verranno filtrati dall'HTML immesso e non verranno rappresentati nella pagina risultante.

Sicurezza

La marcatura HTML che l'autore può immettere viene filtrata a scopo di sicurezza per evitare attacchi di script tra siti che potrebbero, ad esempio, consentire agli autori di ottenere diritti amministrativi.

In generale, tutti gli script e style gli elementi, nonché tutti on* e style gli attributi, verranno rimossi dall'output.

Tuttavia, le regole sono più complicate perché il componente Incorpora segue AEM'insieme di regole di filtraggio del framework HTML antiSamy, che si trova in /libs/cq/xssprotection/config.xml. Se necessario, lo sviluppatore può sovrapporre la configurazione specifica per il progetto.

Ulteriori informazioni sulla sicurezza sono reperibili nella AEM documentazione per gli sviluppatori per le installazioni aziendali interne e in AEM come installazioni Cloud Service.

NOTA

Sebbene le regole del framework di sanificazione anti-Samy possano essere configurate sovrapponendo /libs/cq/xssprotection/config.xml, queste modifiche influiscono su tutti i comportamenti HTL e JSP e non solo sul componente core di incorporamento.

Finestra di dialogo Progettazione

La finestra di dialogo Progettazione consente all'autore del modello di definire le opzioni disponibili per l'autore del contenuto che utilizza il componente Incorpora e le impostazioni predefinite impostate al momento del posizionamento del componente Incorpora.

Finestra di dialogo di progettazione di Incorpora componente

  • Disattiva URL - Disattiva l'opzione ​URL per l'autore del contenuto quando è selezionata
  • Disabilita incorporabili - Disattiva l'opzione ​Incorpora per l'autore del contenuto quando è selezionata, indipendentemente da quali processori incorporabili sono consentiti.
  • Disattiva HTML - Disattiva l'opzione ​HTML per l'autore del contenuto quando è selezionata.
  • Embeddables consentiti - Multilegge che definisce quali processori incorporabili sono disponibili per l'autore del contenuto, a condizione che l'opzione ​Embeddable sia attiva.

In questa pagina