Aspectos básicos de la puntuación y los distintivos scoring-and-badges-essentials
La función de puntuación y distintivos de AEM Communities permite identificar y premiar a los miembros de la comunidad.
Los detalles de la configuración de la función se describen en
Esta página contiene detalles técnicos adicionales:
- Cómo mostrar un distintivo como imagen o texto
- Activación de registro de depuración
- Cómo acceder a UGC relacionados con la puntuación y el distintivo
Visualización de distintivos displaying-badges
Si un distintivo se muestra como texto o como imagen se controla en el lado del cliente en la plantilla HBS.
Por ejemplo, busque this.isAssigned en /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 es true, isAssigned indica que el distintivo se asignó a una función y que el distintivo debe mostrarse como texto.
Si es falso, si es asignado indica que el distintivo se concedió para una puntuación ganada y que el distintivo debe mostrarse como una imagen.
Cualquier cambio en este comportamiento debe realizarse en una secuencia de comandos personalizada (ya sea en una anulación o en una superposición). Consulte Personalización del lado del cliente.
Registro de depuración para la puntuación y el distintivo debug-log-for-scoring-and-badging
Para ayudar a 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 de registro de slinglog:
-
Acceda a la Compatibilidad de registro de la consola web de Adobe Experience Manager, por ejemplo
- http://localhost:4502/system/console/slinglog
-
Select Agregar nuevo registrador
-
Select
DEBUGpara Nivel de registro -
Escriba un nombre para Archivo de registro, por ejemplo
- logs/scoring-debug.log
-
Escriba dos Registrador (clase) entradas (utilizando
+icono)com.adobe.cq.social.scoringcom.adobe.cq.social.badging
-
Seleccione Guardar
-
Para ver las entradas de registro:
-
Desde la consola web
- En el Estado menú
- Select Archivos de registro
- Busque su nombre de archivo de registro, como
scoring-debug
-
En el disco local del servidor
- El archivo de registro se encuentra en <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
- Por ejemplo,
.../crx-quickstart/logs/scoring-debug.log.
UGC para puntuación y distintivo ugc-for-scoring-and-badging
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 está familiarizado con estos términos, consulte Almacenamiento de contenido de la comunidad y Información general del proveedor de recursos de almacenamiento.)
Las descripciones para acceder a los datos de puntuación e identificación 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 resulta en UGC que solo es visible desde el entorno de creación.
JSRP al publicar: del mismo modo, si realiza pruebas en el entorno de publicación, será necesario acceder a CRXDE Lite con privilegios administrativos en una instancia de publicación. Si la instancia de publicación se está ejecutando en modo de producción (nosamplecontent runmode), será necesario habilitar CRXDE Lite.
La ubicación de base del UGC en el JSRP es /content/usergenerated/asi/jcr/.
API de puntuación y asignación scoring-and-badging-apis
Las siguientes API están disponibles para su uso:
Los últimos Javadocs para los versiones 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.
Configuración de ejemplo example-setup
Las capturas de pantalla de los datos del repositorio provienen de la configuración de la puntuación y el distintivo para un foro en dos sitios AEM diferentes:
-
Un sitio AEM con un id único (sitio de comunidad creado mediante el asistente):
-
Uso del sitio Tutorial de introducción (participación) creado durante el tutorial de introducción
-
Busque el nodo de la página del foro
/content/sites/engage/en/forum/jcr:content
-
Agregar propiedades de puntuación y distintivo
-
scoringRules = [/etc/community/scoring/rules/comments-scoring,/etc/community/scoring/rules/forums-scoring] -
badgingRules =[/etc/community/badging/rules/comments-scoring,/etc/community/badging/rules/forums-scoring]
-
-
Busque el nodo de componente del foro
-
/content/sites/engage/en/forum/jcr:content/content/primary/forum(
sling:resourceType = social/forum/components/hbs/forum)
-
-
Agregar propiedad para mostrar distintivos
allowBadges = true
-
Un usuario inicia sesión, crea un tema de foro y recibe una insignia de bronce
-
-
Un sitio AEM without un id único:
-
Al usar la variable Guía de componentes de comunidad
-
Busque el nodo de la página del foro
/content/community-components/en/forum/jcr:content
-
Agregar propiedades de puntuación y distintivo
code language-none scoringRules = [/etc/community/scoring/rules/comments-scoring, /etc/community/scoring/rules/forums-scoring]code language-none badgingRules =[/etc/community/badging/rules/comments-scoring, /etc/community/badging/rules/forums-scoring] -
Busque el nodo de componente del foro
-
/content/community-components/en/forum/jcr:content/content/forum(
sling:resourceType = social/forum/components/hbs/forum)
-
-
Agregar propiedad para mostrar distintivos
allowBadges = true
-
Un usuario inicia sesión, crea un tema de foro y recibe 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=/etc/community/badging/images/moderator/jcr:content/moderator.png" http://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
Como un usuario ha ganado dos insignias de bronce y se le ha concedido una insignia de moderador, así es como aparece el usuario con su entrada en el foro:
-
los nombres de las reglas de puntuación deben ser únicos a nivel global; no deben terminar con el mismo nombre.
Un ejemplo de qué not para hacer:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring -
creación de imágenes de distintivo únicas para diferentes sitios de AEM
Acceso a UGC de puntuación access-scoring-ugc
Uso del API es preferible.
Para fines de investigación, con JSRP por ejemplo, la carpeta base que contiene puntuaciones es
/content/usergenerated/asi/jcr/scoring
El nodo secundario de scoringes 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 Participación de Geometrixx, el usuario y su puntuación se encuentran en una ruta construida con el nombre de la regla de puntuación, el ID del sitio del 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 la guía de componentes de comunidad, el usuario y su puntuación se encuentran en una ruta construida 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 puede contener directamente sólo un valor o hacer referencia indirectamente a un atomicCounter.
Acceso al distintivo UGC access-badging-ugc
Uso del API es preferible.
Para fines de investigación, utilizando JSRP para el ejemplo, la carpeta base que contiene información sobre distintivos asignados o concedidos es
- /content/usergenerated/asi/jcr
Seguido de la ruta al perfil del usuario, que termina en una carpeta de distintivos, como
- /home/users/community/w271Up2Z4DjnOQrviv/profile/badges
Distintivo adjudicado awarded-badge
distintivo asignado assigned-badge
Información adicional additional-information
Para mostrar una lista ordenada de miembros basada en puntos:
- Función del panel de instrumentos para su inclusión en un sitio de la comunidad o en una plantilla de grupo.
- Componente del panel de control, el componente destacado de la función del panel de vanguardia, para la creación de páginas.