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:

NOTE
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.

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:

community-component1

Páginas de componentes component-pages

Seleccione un componente de la lista que aparece en la parte izquierda de la página.

community-component-pages

Se muestra el cuerpo principal de la guía:

  1. Título: nombre del componente seleccionado

  2. Bibliotecas del lado cliente: una lista de una o más categorías requeridas

  3. 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
  4. 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.

NOTE
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.

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:

community-component3

En el Plantillas pestaña:

community-component4

  • 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.

NOTE
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.

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

NOTE
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:showIdeLa 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:

  1. Navegar a CRXDE Lite

    Por ejemplo, http://localhost:4503/crx/de

  2. Seleccione el de jcr:content nodo

    Por ejemplo, /content/community-components/en/comments/jcr:content

  3. Añadir una propiedad

    • Nombre scg:showIde
    • Tipo String
    • Valor true
  4. Seleccionar Guardar todo

  5. Vuelva a cargar la página Comentarios en la guía

    http://localhost:4503/content/community-components/en/comments.html

  6. Tenga en cuenta que ahora hay tres pestañas para plantillas, CSS y datos.

community-component5

community-component6

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.

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791