La guía de componentes de la comunidad es una herramienta de desarrollo interactiva para marco de componentes sociales (SCF). Proporciona una lista de los componentes de AEM Communities disponibles o las funciones más complejas creadas de varios componentes.
Junto con la información básica de cada componente, la guía permite experimentar cómo funcionan los componentes o funciones de SCF y cómo se pueden configurar o personalizar.
Para obtener información sobre los aspectos básicos del desarrollo relacionados con cada componente, consulte Aspectos básicos de funciones y componentes.
La guía está diseñada para utilizarse en instalaciones de desarrollo de instancias de autor (localhost:4502) y publicación (localhost:4503).
Para acceder al sitio de componentes de la comunidad, vaya a
Las interacciones con los componentes de las comunidades variarán en función de lo siguiente:
En Autor, para entrar en el modo de edición, inserte una de las siguientes opciones editor.html
o cf#
como el primer segmento de ruta después del nombre del servidor:
IU estándar:
https://<server>:<port>/editor.html/content/community-components/en.html
IU clásica:
https://<server>:<port>/cf#/content/community-components/en.html
En el modo Autor y en el modo Edición, los vínculos de una página no están activos.
Para navegar a una página de componente, seleccione primero el modo Vista previa para activar los vínculos.
Con la página del componente mostrada en el explorador, vuelva al modo Editar para abrir el cuadro de diálogo de edición del componente.
Para obtener información general sobre la creación de, consulte guía rápida para la creación de páginas.
AEM Si no está familiarizado con el uso de la, consulte la documentación de en manipulación básica.
La guía proporciona una lista de los componentes de SCF disponibles para la vista previa y la creación de prototipos en la parte izquierda de la página.
Guía de componentes tal y como se ve en una instancia de autor en el modo de edición:
Seleccione un componente de la lista que aparece en la parte izquierda de la página.
Se muestra el cuerpo principal de la guía:
Título: nombre del componente seleccionado
Bibliotecas del lado cliente: una lista de una o más categorías requeridas
Incluible: si el componente se puede incluir dinámicamente, el estado se puede alternar en el modo de edición de autor:
Componente o función de muestra: una instancia activa del componente o función. Si es un componente, puede modificarse con los cambios realizados en las plantillas, CSS y datos proporcionados en la sección de la pestaña.
Después de realizar una selección desde el lado izquierdo, el componente aparecerá debajo, en lugar de junto, a la lista de componentes cuando la ventana del explorador sea demasiado estrecha.
Al utilizar la guía en una instancia de autor, es posible experimentar la configuración de un componente al abrir su cuadro de diálogo. La información para los desarrolladores se proporciona en la Aspectos básicos de componentes y funciones de la documentación, mientras que la configuración del cuadro de diálogo se describe en Componentes de Communities para autores.
Para la guía de componentes de la comunidad, algunos ajustes del cuadro de diálogo de componentes se superponen con la variable Incluible estado de alternancia. Para alternar entre el uso del recurso existente o un recurso incluido dinámicamente, en el modo de edición, seleccione el componente y el texto que se puede incluir y haga doble clic para abrir el cuadro de diálogo de edición:
En el Plantillas pestaña:
Incluir el componente secundario con sling:include
Si no se selecciona, la Guía de componentes utilizará el recurso existente en el repositorio (un nodo jcr que es secundario de un nodo par).
Si se selecciona, la Guía de componentes utilizará sling para incluir dinámicamente un componente del resourceType del nodo secundario (recurso no existente).
El valor predeterminado está desmarcado.
Al utilizar la guía en una instancia de publicación, es posible experimentar los componentes y las funciones como un visitante del sitio (sin iniciar sesión) y como miembros con varios privilegios al iniciar sesión.
Tenga en cuenta que si se deja el SRP de forma predeterminada en JSRP, UGC introducidos en la instancia de publicación solo serán visibles en la publicación, y no ser visible desde el moderación en la instancia de autor.
Las bibliotecas de cliente (clientlibs) enumeradas para cada componente son las siguientes obligatorio se debe hacer referencia a él cuando el componente se coloca en una página. Los clientlibs proporcionan un medio para administrar y optimizar la descarga de JavaScript y CSS utilizados para representar el componente en el explorador.
Para obtener más información, visite Componentes de Clientlibs para Communities.
En la instancia de autor, donde a menudo se inicia sesión como administrador o desarrollador, para experimentar cómo ha iniciado sesión el componente como otro usuario, utilice el cuadro de texto a la izquierda del Suplantar para escribir el nombre de usuario o seleccionar en la lista desplegable y, a continuación, haga clic en el botón. Haga clic en Revertir para cerrar la sesión y finalizar la suplantación.
La instancia de publicación no necesita suplantar. Simplemente utilice el vínculo Inicio/Cierre de sesión para suplantar a varios usuarios, como el de usuarios de demostración.
Cuando se habilita, cada componente SCF está disponible para crear prototipos de posibles personalizaciones mediante la modificación temporal de la plantilla, CSS y datos del componente.
Esta herramienta es de solo lectura. Ninguna de las ediciones realizadas en plantillas, CSS o datos se guarda en el repositorio.
Para experimentar rápidamente con las personalizaciones, la variable scg:showIde
La propiedad debe añadirse al nodo JCR de contenido de la página del componente y establecerse en true.
Con el componente Comentarios como ejemplo, en la instancia de autor o publicación, ha iniciado sesión con privilegios de administrador:
Navegar a CRXDE Lite
Por ejemplo, http://localhost:4503/crx/de
Seleccione el de jcr:content
nodo
Por ejemplo, /content/community-components/en/comments/jcr:content
.
Añadir una propiedad
scg:showIde
String
true
Seleccionar Guardar todo
Vuelva a cargar la página Comentarios en la guía
http://localhost:4503/content/community-components/en/comments.html
Tenga en cuenta que ahora hay 3 pestañas para plantillas, CSS y datos.
Seleccione la pestaña plantillas para ver las plantillas asociadas al componente.
El Editor de plantillas permite compilar las ediciones locales y aplicarlas a la instancia del componente de muestra en la parte superior de la página sin afectar al componente en el repositorio.
La ejecución de compilaciones en ediciones locales resaltará los errores colocando un punto en el margen interno y marcando el texto en rojo.
Seleccione la pestaña CSS para ver el CSS asociado al componente.
Si un componente está compuesto por varios componentes, parte del CSS puede aparecer enumerado en uno de los demás componentes.
El editor CSS permite modificar el CSS y aplicarlo a la instancia del componente de ejemplo en la parte superior de la página.
Se puede seleccionar una regla para resaltar las partes del DOM que utilizan esa regla haciendo clic en junto a la regla en el margen.
Seleccione la pestaña Datos para mostrar los datos del extremo .social.json. Estos datos son editables y se aplican a la instancia de componente de ejemplo.
Los errores de sintaxis se pueden marcar en el margen interno y resaltar en el editor.