Añadir Clientlibs

Añadir una ClientLibraryFolder (clientlibs)

Cree una ClientLibraryFolder con el nombre clientlibsque contendrá JS y CSS utilizados para procesar las páginas del sitio.

El valor de propiedad categoriesproporcionado a esta biblioteca de cliente es el identificador utilizado para incluir directamente esta clientlib desde una página de contenido o para incrustarla en otros clientlibs.

  1. Usando CRXDE Lite, expanda /etc/designs

  2. Haga clic con el botón derecho en an-scf-sandbox y seleccione Create Node

    • Nombre: clientlibs
    • Tipo: cq:ClientLibraryFolder

  3. Haga clic en Aceptar

chlimage_1-220

En la ficha Propiedades del nuevo nodo clientlibs, introduzca la propiedad categories:

  • Nombre: categorías
  • Tipo: Cadena
  • Valor: apps.an-scf-sandbox
  • Haga clic en Agregar
  • Haga clic en Guardar todo

Nota: anteponer el valor de categorías con 'aplicaciones'. es una convención para identificar la 'aplicación propietaria' como una carpeta /apps, no como /libs. IMPORTANTE: Añada los archivos de marcador de posición js.txt y css.txt. (No es oficialmente un cq:ClientLibraryFolder sin ellos).

  1. Haga clic con el botón derecho en /etc/designs/an-scf-sandbox/clientlibs

  2. Seleccione Crear archivo…

  3. Escriba Nombre: css.txt

  4. Seleccione Crear archivo…

  5. Escriba Nombre: js.txt

  6. Haga clic en Guardar todo

chlimage_1-221

La primera línea de css.txt y js.txt identifica la ubicación base desde la que se encuentran las siguientes listas de archivos.

Intente establecer el contenido de css.txt en:

#base=.
 style.css

A continuación, cree un archivo en clientlibs llamado style.css y defina el contenido en:

body {

background-color: #b0c4de;

}

Incrustar clientes SCF

En la ficha Propiedades del nodo clientlibs, introduzca la propiedad de varios valores String embed. Esto incorporará las bibliotecas del lado del cliente (clientlibs) necesarias para los componentes de SCF. Para este tutorial, agregaremos muchos de los clientlibs necesarios para los componentes Communities.

​​Tenga en cuenta que este método puede ser o no el deseado para un sitio de producción, ya que existen consideraciones de conveniencia en comparación con el tamaño y la velocidad de los clientes descargados para cada página.

Si solo utiliza una función en una página, puede incluir la clientlib completa de esa característica directamente en la página, por ejemplo: <% ui:includeClientLib categorías=cq.social.hbs.forum" %>

En este caso, los incluimos a todos, por lo que preferiríamos a los clientes más básicos de SCF, que son los clientes autores:

  • Nombre: embed

  • Tipo: String

  • Haga clic Multi

  • Value: cq.social.scf

    <enter> aparecerá un cuadro de diálogo

    Haga clic [+]​después de cada entrada para agregar las siguientes categorías clientlib:

    • cq.ckeditor
    • cq.social.author.hbs.comments
    • cq.social.author.hbs.forum
    • cq.social.author.hbs.rating
    • cq.social.author.hbs.reviews
    • cq.social.author.hbs.voting
    • Haga clic en Aceptar

  • Haga clic en Guardar todo

chlimage_1-222

Así es como /etc/designs/an-scf-sandbox/clientlibs debe aparecer ahora en el repositorio:

chlimage_1-223

Incluir Clientlibs en la plantilla PlayPage

Sin incluir la categoría apps.an-scf-sandbox ClientLibraryFolder en la página, los componentes SCF no funcionarán ni se les aplicará estilo, ya que no estarán disponibles los JavaScript y los estilos necesarios.

Por ejemplo, sin incluir clientlibs, el componente de comentarios de SCF no tiene estilo:

chlimage_1-224

Una vez que se incluye apps.an-scf-sandbox clientlibs, el componente de comentarios de SCF aparece con estilo:

chlimage_1-225

La sentencia include pertenece a la sección <head> de la secuencia de comandos <html>. El foundation head.jsp predeterminado incluye una secuencia de comandos que se puede superponer: headlibs.jsp.

Copie headlibs.jsp e incluya clientlibs:

  1. Utilizando CRXDE Lite, seleccione /libs/foundation/components/page/headlibs.jsp

  2. Haga clic con el botón derecho y seleccione Copiar (o seleccione Copiar en la barra de herramientas)

  3. Seleccione /apps/an-scf-sandbox/components/playpage

  4. Haga clic con el botón derecho y seleccione Pegar (o seleccione Pegar en la barra de herramientas)

  5. Haga clic en el doble headlibs.jsp para abrirlo

  6. Anexe la línea siguiente al final del archivo

    <ui:includeClientLib categories="apps.an-scf-sandbox"/>

  7. Haga clic en Guardar todo

<%@ page session="false" %><%
%><%@include file="/libs/foundation/global.jsp" %><%
%><ui:includeClientLib categories="cq.foundation-main"/><%
%>
<cq:include script="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp"/>
<% currentDesign.writeCssIncludes(pageContext); %>
<ui:includeClientLib categories="apps.an-scf-sandbox"/>

Cargue el sitio web en el navegador y vea si el fondo no es azul.

http://localhost:4502/content/an-scf-sandbox/en/play.html

chlimage_1-226

Guardando su trabajo hasta ahora

En este punto, existe un simulador de pruebas minimalista y puede que valga la pena guardarlo como paquete para que, mientras se reproduce, si el repositorio se daña y desea pasar el inicio, pueda desactivar el servidor, cambiar el nombre o eliminar la carpeta crx-quickstart/, activar el servidor, cargar e instalar este paquete guardado y no tener que repetir estos pasos más básicos.

Este paquete existe en el tutorial Crear una página de muestra para aquellos que no pueden esperar para simplemente saltar y reproducir el inicio…

Para crear un paquete:

  • En CRXDE Lite, haga clic en el icono Paquete

  • Haga clic en Crear paquete

    • Nombre del paquete: an-scf-sandbox-minimal-pkg
    • Versión: 0.1
    • Grupo: <dejar como predeterminado>
    • Haga clic en Aceptar

  • Haga clic en Editar

    • Seleccione la ficha Filtros

      • Haga clic en Añadir filtro
      • Ruta raíz: <examinar a /apps/an-scf-sandbox>
      • Haga clic en Listo
      • Haga clic en Añadir filtro
      • Ruta raíz: <examinar a /etc/designs/an-scf-sandbox>
      • Haga clic en Listo
      • Haga clic en Añadir filtro
      • Ruta raíz: <examinar a /content/an-scf-sandbox>
      • Haga clic en Listo

    • Haga clic en Guardar

  • Haga clic en Generar

Ahora puede seleccionar Descargar para guardarlo en el disco y Cargar paquete en otra parte, así como seleccionar Más > Replicar para insertar el simulador de pruebas en una instancia de publicación localhost para expandir el dominio del simulador de pruebas.

En esta página