Il componente core Incorpora consente di incorporare contenuto esterno in una pagina di contenuto AEM.
Il componente core Incorpora consente all’autore di contenuto di definire un contenuto esterno selezionato da incorporare all’interno di una pagina di contenuto AEM. Inoltre, è disponibile un’opzione per definire anche codice HTML in forma libero da incorporare.
La versione corrente del componente Incorpora è la v2, introdotta con la versione 2.18.0 dei Componenti core a febbraio 2022, ed è quella descritta in questo documento.
La tabella che segue descrive tutte le versioni supportate del componente, le versioni di AEM con cui le versioni del componente sono compatibili e i collegamenti alla documentazione delle versioni precedenti.
Versione del componente | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | - | Compatibile | Compatibile |
v1 | Compatibile | Compatibile | Compatibile |
Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.
Per avere un’idea del componente Incorpora e vedere esempi delle opzioni di configurazione e dell’output HTML e JSON, visita la libreria dei componenti.
La documentazione tecnica più recente sul componente Incorpora è disponibile su GitHub.
Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.
La finestra di dialogo per configurazione consente all’autore di contenuto di definire la risorsa esterna da incorporare nella pagina.
Scegli innanzitutto il tipo di risorsa da incorporare:
Per ogni tipo di risorsa incorporabile, puoi definire un ID. Questa opzione consente di controllare l’identificatore univoco del componente nel codice HTML e nel Data Layer.
L’URL è il tipo di risorsa più facile da incorporare. È sufficiente incollare l’URL della risorsa da incorporare nel campo URL. Il componente tenterà di accedere alla risorsa e, se uno dei processori potrà eseguirne il rendering, visualizzerà un messaggio di conferma sotto il campo URL. In caso contrario, il campo verrà contrassegnato come in errore.
Il componente Incorpora viene fornito con i relativi processori per i seguenti tipi di risorse:
Gli sviluppatori possono aggiungere processori URL aggiuntivi seguendo la documentazione per gli sviluppatori del componente Incorpora.
L’opzione Contenuto incorporabile consente un’ulteriore personalizzazione della risorsa incorporata, che può essere parametrizzata e includere informazioni aggiuntive. Un autore può scegliere tra vari tipi di contenuto affidabile preconfigurato e il componente viene fornito con YouTube incorporabile pronto per l’uso.
Il campo Contenuto incorporabile definisce il tipo di processore vuoi utilizzare. Nel caso di YouTube, puoi quindi definire:
Altre risorse incorporabili potrebbero offrire campi simili, che possono essere definiti da uno sviluppatore seguendo la documentazione per gli sviluppatori del componente Incorpora.
Per poter essere disponibile per l’autore di pagine, l’opzione Contenuto incorporabile deve essere abilitata a livello di modello tramite la finestra di dialogo per progettazione.
Puoi aggiungere alla pagina codice HTML in formato libero utilizzando il componente Incorpora.
Eventuali tag non sicuri, come gli script, verranno filtrati dal codice HTML inserito e non ne verrà eseguito il rendering nella pagina risultante.
Il markup HTML che l’autore può inserire viene filtrato a scopo di sicurezza per evitare attacchi di script tra i siti, che potrebbero, ad esempio, consentire agli autori di ottenere diritti amministrativi.
In generale, tutti gli script e gli elementi style
nonché tutti gli attributi on*
e style
verranno rimossi dall’output.
Tuttavia, le regole sono più complicate, perché il componente Incorpora segue a livello globale il set di regole di filtro del framework di bonifica AntiSamy HTML di AEM, reperibile in /libs/cq/xssprotection/config.xml
. Se necessario, uno sviluppatore può sostituire temporaneamente questa impostazione per la configurazione specifica di un progetto.
Ulteriori informazioni sulla sicurezza sono disponibili nella documentazione sulle installazioni on-premise per gli sviluppatori di AEM e in Installazioni di AEM as a Cloud Service.
Anche se le regole del framework di bonifica AntiSamy possono essere configurate sostituendo temporaneamente /libs/cq/xssprotection/config.xml
, queste modifiche influiscono sul comportamento di tutti gli elementi HTL e JSP e non solo su quello del componente core Incorpora.
Il componente Incorpora supporta il sistema di stili di AEM.
Utilizza il menu a discesa per selezionare gli stili da applicare al componente. Le selezioni effettuate nella finestra di dialogo di modifica hanno lo stesso effetto di quelle selezionate nella barra degli strumenti del componente.
Gli stili devono essere configurati per questo componente nella finestra di dialogo di progettazione affinché il menu a discesa sia disponibile.
La finestra di dialogo per progettazione consente all’autore del modello di definire le opzioni disponibili per l’autore di contenuto che utilizza il componente Incorpora e le impostazioni predefinite scelte al momento dell’inserimento di questo componente.