La función de puntuación e insignias de AEM Communities identifica y recompensa a los miembros de la comunidad.
Los detalles de configuración de la función se describen en
Esta página contiene detalles técnicos adicionales:
La estructura de implementación visible en CRXDE Lite está sujeta a cambios.
Si un distintivo se muestra como texto o imagen se controla en el lado del cliente en la plantilla HBS.
Por ejemplo, busque this.isAssigned
in /libs/social/forum/components/hbs/topic/list-item.hbs
:
{{#each author.badges}}
{{#if this.isAssigned}}
<div class="scf-badge-text">
{{this.title}}
</div>
{{/if}}
{{/each}}
{{#each author.badges}}
{{#unless this.isAssigned}}
<img class="scf-badge-image" alt="{{this.title}}" title="{{this.title}}" src="{{this.imageUrl}}" />
{{/unless}}
{{/each}}
Si el valor es True, isAssigned
indica que el distintivo se asignó a un rol y que el distintivo debe mostrarse como texto.
Si es false, isAssigned
indica que el distintivo se concedió por una puntuación ganada y que el distintivo debe mostrarse como una imagen.
Cualquier cambio en este comportamiento debe realizarse en un script personalizado (anulación o superposición). Consulte Personalización del lado del cliente.
Para depurar la puntuación y el distintivo, se puede configurar un archivo de registro personalizado. El contenido de este archivo de registro se puede proporcionar al servicio de atención al cliente si se producen problemas con la función.
Para obtener instrucciones detalladas, visite Crear un archivo de registro personalizado.
Para configurar rápidamente un archivo slinglog:
Acceda a la Compatibilidad con registros de la consola web de Adobe Experience Manager, por ejemplo
Seleccionar Añadir nuevo registrador
Seleccionar DEBUG
para Nivel de registro
Introduzca un nombre para Archivo de registro, por ejemplo
Introducir dos Logger Entradas (clase) (usando +
icon)
com.adobe.cq.social.scoring
com.adobe.cq.social.badging
Seleccione Guardar
Para ver las entradas de registro:
Desde la consola web
scoring-debug
En el disco local del servidor
El archivo de registro se encuentra en <server-install-dir>/crx-quickstart/logs/<nombre-archivo-registro>.log
Por ejemplo, .../crx-quickstart/logs/scoring-debug.log
Es posible ver el UGC relacionado con la puntuación y el distintivo cuando el SRP elegido es JSRP o MSRP, pero no ASRP. (Si no conoce estos términos, consulte Almacenamiento de contenido de comunidad y Resumen del proveedor de recursos de almacenamiento.)
Las descripciones para acceder a los datos de puntuación y distintivos utilizan JSRP, ya que el UGC es fácilmente accesible mediante CRXDE Lite.
JSRP en autor: la experimentación en el entorno de creación da como resultado un CGU que solo es visible desde el entorno de creación.
JSRP en publicación: del mismo modo, si realiza pruebas en el entorno de publicación, es necesario acceder a un CRXDE Lite con privilegios administrativos en una instancia de publicación. Si la instancia de publicación se ejecuta en modo de producción (modo de ejecución nosamplecontent), es necesario habilitar CRXDE Lite.
La ubicación base de UGC en JSRP es /content/usergenerated/asi/jcr/
.
Las siguientes API están disponibles para su uso:
Los últimos Javadocs para el paquete de funciones instalado están disponibles para los desarrolladores desde el repositorio de Adobe. Consulte Uso de Maven para comunidades: Javadocs.
La ubicación y el formato del UGC en el repositorio están sujetos a cambios sin previo aviso.
AEM Las capturas de pantalla de los datos del repositorio proceden de la configuración de la puntuación y el distintivo para un foro en dos sitios de diferentes:
AEM Un sitio con un id único (sitio de la comunidad creado con el asistente):
Uso del sitio Tutorial de introducción (participación) creado durante la tutorial de introducción
Busque el nodo de la página del foro
/content/sites/engage/en/forum/jcr:content
Añadir propiedades de puntuación e insignias
scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
/libs/settings/community/scoring/rules/forums-scoring]
badgingRules =[/libs/settings/community/badging/rules/comments-scoring,
/libs/settings/community/badging/rules/forums-scoring]
Busque el nodo del componente del foro
/content/sites/engage/en/forum/jcr:content/content/primary/forum
( sling:resourceType = social/forum/components/hbs/forum
)
Para mostrar insignias, agregue la propiedad
allowBadges = true
Un usuario inicia sesión, crea un tema de foro y se le otorga una insignia de bronce
AEM Un sitio sin un id único:
Busque el nodo de la página del foro
/content/community-components/en/forum/jcr:content
Añadir propiedades de puntuación e insignias
scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
/libs/settings/community/scoring/rules/forums-scoring]
badgingRules =[/libs/settings/community/badging/rules/comments-badging,
/libs/settings/community/badging/rules/forums-badging]
Busque el nodo del componente del foro
/content/community-components/en/forum/jcr:content/content/forum
( sling:resourceType = social/forum/components/hbs/forum
)
Para mostrar insignias, agregue la propiedad
allowBadges = true
Un usuario inicia sesión, crea un tema de foro y se le otorga una insignia de bronce
A un usuario se le asigna un distintivo de moderador mediante cURL :
curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/libs/settings/community/badging/images/moderator/jcr:content/moderator.png" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
Como un usuario ha obtenido dos insignias de bronce y se le ha otorgado una insignia de moderador, el usuario aparece con su entrada en el foro de la siguiente manera:
Este ejemplo no sigue estas prácticas recomendadas:
Los nombres de las reglas de puntuación deben ser únicos a nivel global; no deben terminar con el mismo nombre.
Un ejemplo de lo que no para hacer:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring
AEM Creación de imágenes de insignias únicas para diferentes sitios de
Uso del API se prefiere.
Para fines de investigación, con JSRP como ejemplo, la carpeta base que contiene puntuaciones es
/content/usergenerated/asi/jcr/scoring
El nodo secundario de scoring
es el nombre de la regla de puntuación. Por lo tanto, una práctica recomendada es que los nombres de reglas de puntuación en un servidor sean únicos a nivel global.
Para el sitio de Geometrixx Engage, el usuario y su puntuación se encuentran en una ruta construida con el nombre de la regla de puntuación, el ID de sitio de la comunidad ( engage-ba81p
), un id único y el id del usuario :
.../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley
Para el sitio de guía de componentes de la comunidad, el usuario y su puntuación se encuentran en una ruta creada con el nombre de la regla de puntuación, un ID predeterminado ( default-site
), un id único y el id del usuario :
.../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
La puntuación se almacena en la propiedad scoreValue_tl
que solo pueden contener un valor o hacer referencia indirectamente a un atomicCounter.
Uso del API se prefiere.
Para fines de investigación, utilizando JSRP para el ejemplo, la carpeta base que contiene información sobre insignias asignadas o concedidas es
/content/usergenerated/asi/jcr
Seguido de la ruta al perfil del usuario, que termina en una carpeta de distintivos, como:
/home/users/community/w271OOup2Z4DjnOQrviv/profile/badges
Para mostrar una lista ordenada de miembros basada en puntos: