Guía de componentes de la comunidad community-components-guide
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 comunidades de Adobe Experience Manager AEM () 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.
Introducción getting-started
La guía está diseñada para utilizarse en instalaciones de desarrollo de instancias de autor (localhost:4502) e instancias de publicación (localhost:4503).
Para acceder al sitio de componentes de la comunidad, vaya a
Las interacciones con los componentes de las comunidades varían en función de:
- El servidor (autor o publicación).
- Si el visitante del sitio ha iniciado sesión o no.
- Si ha iniciado sesión, los privilegios asignados al miembro.
- Si el SRP predeterminado, JSRP, está en uso.
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:
Página principal home-page
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:
Páginas de componentes component-pages
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:
- Si se añade, el texto que se muestra es: "Este componente se incluye a través de su nodo de par".
- Si se incluye, el texto que se muestra es: "Este componente se incluye dinámicamente".
- Si no se puede incluir, no se muestra ningún texto
-
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.
Interacciones de autor author-interactions
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 utiliza el recurso existente en el repositorio (un nodo jcr que es secundario de un nodo par).
- El texto mostrado es: "Este componente se incluye a través de su nodo de par".
Si se selecciona, la Guía de componentes utiliza sling para incluir dinámicamente un componente del resourceType del nodo secundario (recurso no existente).
- El texto mostrado es: "Este componente se incluye dinámicamente".
El valor predeterminado está desmarcado.
Interacciones de publicación publish-interactions
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.
Bibliotecas de cliente client-side-libraries
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 procesar el componente en el explorador.
Para obtener más información, visite Componentes de Clientlibs para Communities.
Suplantación impersonation
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.
Personalización customization
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.
Habilitar la personalización enabling-customization
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
nodoPor ejemplo,
/content/community-components/en/comments/jcr:content
-
Añadir una propiedad
- Nombre
scg:showIde
- Tipo
String
- Valor
true
- Nombre
-
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 tres pestañas para plantillas, CSS y datos.
Pestaña Plantillas templates-tab
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.
Pestaña CSS css-tab
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.
Pestaña Datos data-tab
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.