Una guida video dettagliata sull’installazione e l’utilizzo di Apache Sling Dynamic Include con Dispatcher AEM in esecuzione Apache HTTP Web Server.
Assicurati che AEM Dispatcher sia installata localmente la versione più recente.
Scarica e installa la Sling Dynamic Include fascio.
Configura Sling Dynamic Include tramite OSGi Configuration Factory a http://<host>:<port>/system/console/configMgr/org.apache.sling.dinamicinclude.Configuration.
Oppure, per aggiungere a una base di codice AEM, crea la sling:OsgiConfig nodo in:
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0"
xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="sling:OsgiConfig"
include-filter.config.enabled="{Boolean}true"
include-filter.config.path="/content"
include-filter.config.resource-types="[my-app/components/content/highly-dynamic]"
include-filter.config.include-type="SSI"
include-filter.config.add_comment="{Boolean}false"
include-filter.config.selector="nocache"
include-filter.config.ttl=""
include-filter.config.required_header="Server-Agent=Communique-Dispatcher"
include-filter.config.ignoreUrlParams="[]"
include-filter.config.rewrite="{Boolean}true"
/>
<!--
* include-filter.config.include-type="SSI | ESI | JSI"
* include-filter.config.ttl is # of seconds (requires AEM Dispatcher 4.1.11+)
-->
(Facoltativo) Ripeti l’ultimo passaggio per consentire l’attivazione dei componenti contenuto bloccato (iniziale) dei modelli modificabili da servire tramite SDI anche. La ragione della configurazione aggiuntiva è che il contenuto bloccato dei modelli modificabili viene servito da /conf
anziché /content
.
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0"
xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="sling:OsgiConfig"
include-filter.config.enabled="{Boolean}true"
include-filter.config.path="/conf"
include-filter.config.resource-types="[my-app/components/content/highly-dynamic]"
include-filter.config.include-type="SSI"
include-filter.config.add_comment="{Boolean}false"
include-filter.config.selector="nocache"
include-filter.config.ttl=""
include-filter.config.required_header="Server-Agent=Communique-Dispatcher"
include-filter.config.ignoreUrlParams="[]"
include-filter.config.rewrite="{Boolean}true"
/>
<!--
* include-filter.config.include-type="SSI | ESI | JSI"
* include-filter.config.ttl is # of seconds (requires AEM Dispatcher 4.1.11+)
-->
Aggiorna Apache HTTPD Web servers httpd.conf
per abilitare Include modulo .
$ sudo vi .../httpd.conf
LoadModule include_module libexec/apache2/mod_include.so
Aggiorna vhost file da rispettare include direttive.
$ sudo vi .../vhosts/aem-publish.local.conf
<VirtualHost *:80>
...
<Directory /Library/WebServer/docroot/publish>
...
# Add Includes to enable SSI Includes used by Sling Dynamic Include
Options FollowSymLinks Includes
# Required to have dispatcher-handler process includes
ModMimeUsePathInfo On
# Set includes to process .html files
AddOutputFilter INCLUDES .html
...
</Directory>
...
</VirtualHost>
Aggiorna il file di configurazione dispatcher.any per supportare (1) nocache
e (2) abilitare il supporto TTL.
$ sudo vi .../conf/dispatcher.any
/rules {
...
/0009 {
/glob "*.nocache.html*"
/type "deny"
}
}
Lasciare il finale *
fuori nel glob *.nocache.html*
regola precedente, può problemi nelle richieste di risorse secondarie.
/cache {
...
/enableTTL "1"
}
Riavvia sempre Apache HTTP Web Server dopo aver apportato modifiche ai relativi file di configurazione o dispatcher.any
.
$ sudo apachectl restart
Se utilizzi Sling Dynamic Includes per il server edge-side include (ESI), assicurati di memorizzare nella cache le informazioni rilevanti intestazioni di risposta nella cache del dispatcher. Le intestazioni possibili includono: