Show Menu
TEMAS×

Puntuación y distintivos de comunidades

Información general

La función de puntuación y distintivos para AEM Communities permite identificar y premiar a los miembros de la comunidad.
Los principales aspectos de la puntuación y las insignias son:
Tenga en cuenta que la asignación de distintivos no está habilitada de forma predeterminada .
La estructura de implementación visible en CRXDE Lite está sujeta a cambios una vez que la interfaz de usuario esté disponible.

Insignias

Las insignias se colocan bajo el nombre de un miembro para indicar su rol o su posición en la comunidad. Los distintivos pueden mostrarse como una imagen o como un nombre. Cuando se muestra como una imagen, el nombre se incluye como texto alternativo para la accesibilidad.
De forma predeterminada, los distintivos se encuentran en el repositorio en
  • /libs/settings/community/badging/images
Si se almacenan en una ubicación diferente, todos deben leerlos accesibles.
Los distintivos se diferencian en UGC en cuanto a si fueron asignados o ganados según las reglas. Actualmente, las insignias asignadas aparecen como texto y las insignias obtenidas aparecen como imágenes.

Interfaz de usuario de administración de distintivos

La consola de distintivos de comunidades permite agregar distintivos personalizados que se pueden mostrar para un miembro cuando se ganan (se otorgan) o cuando asumen un papel específico en la comunidad (se asignan).

Distintivos asignados

Un administrador asigna las insignias basadas en roles a los miembros de la comunidad según su función en la comunidad.
Los distintivos asignados (y adjudicados) se almacenan en el SRP seleccionado y no son directamente accesibles. Hasta que haya una GUI disponible, el único medio para asignar distintivos basados en roles es hacerlo con código o cURL. Para obtener instrucciones sobre cURL, consulte la sección titulada Asignar y revocar distintivos .
En la versión se incluyen tres distintivos basados en funciones:
  • moderador
    /libs/settings/community/badging/images/moderator/jcr:content/moderator.png
  • administrador de grupos
    /libs/settings/community/badging/images/group-manager/jcr:content/group-manager.png
  • miembro privilegiado
    /libs/settings/community/badging/images/privileged-member/jcr:content/privileged-member.png

Distintivos adjudicados

El servicio de puntaje otorga insignias basadas en premios a los miembros de la comunidad según las reglas aplicadas a su actividad en la comunidad.
Para que las insignias aparezcan como recompensa por la actividad, hay dos cosas que deben suceder:
  • El distintivo debe estar habilitado para el componente de función.
  • Las reglas de puntuación y de marcado deben aplicarse a la página (o antecesor) en la que se coloca el componente.
En la versión se incluyen tres distintivos basados en premios:
  • oro
    /libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
  • silver
    /libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
  • bronce
    /libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
Las reglas de puntuación se pueden configurar para asignar puntos negativos para anuncios marcados como inapropiados y, por lo tanto, afectar al valor de puntuación. Sin embargo, una vez obtenido un distintivo, no se eliminará automáticamente debido a la reducción de puntos de puntuación o a los cambios en las reglas de puntuación.
Las insignias otorgadas pueden ser revocadas de la misma manera que las insignias asignadas. Consulte la sección Asignar y revocar distintivos . Las futuras mejoras incluirán una interfaz de usuario para administrar las insignias de los miembros.

Distintivos personalizados

Las insignias personalizadas se pueden instalar mediante la consola Consola de distintivos Insignias y se pueden asignar o especificar en las reglas de identificación.
Cuando se instalan desde la consola Insignias, los distintivos personalizados se replican automáticamente en el entorno de publicación.

Habilitar puntuación

La puntuación no está habilitada de forma predeterminada. Los pasos básicos para configurar y habilitar la puntuación y la concesión de insignias son:
Consulte la sección Prueba Prueba rápida rápida para habilitar la puntuación para un sitio de comunidad mediante las reglas de puntuación y de identificación predeterminadas para los foros y comentarios.

Aplicar reglas al contenido

Para habilitar la puntuación y los distintivos, agregue las propiedades scoringRules y badgingRules a cualquier nodo del árbol de contenido del sitio.
Si el sitio ya está publicado, después de aplicar todas las reglas y activar los componentes, vuelva a publicar el sitio.
Las reglas que se aplican a un componente habilitado para distintivos son las del nodo actual o su antecesor.
Si el nodo es de tipo cq:Page (recomendado), con CRXDE|Lite, agregue las propiedades a su jcr:content nodo.
Propiedad
Tipo
Descripción
badgingRules
Cadena #
una lista de matriz de reglas de marcado
scoringRules
Cadena #
una lista de matriz de reglas de puntuación
Si una regla de puntuación parece no tener ningún efecto en la concesión de distintivos, asegúrese de que la propiedad scoringRules de la regla de puntuación no haya bloqueado la regla de puntuación. Consulte la sección titulada Reglas de asignación de distintivos .

Habilitar distintivos para el componente

Las reglas de puntuación y de clasificación solo se aplican a las instancias de componentes que han habilitado la creación de distintivos mediante la edición de la configuración del componente en el modo de creación.
Una propiedad booleana, allowBadges , activa o desactiva la visualización de distintivos para una instancia de componente. Se puede configurar en el cuadro de diálogo de edición de componentes para componentes de foro, control de calidad y comentarios mediante una casilla de verificación rotulada Mostrar distintivos .

Ejemplo: allowBadges para la instancia del componente Foro

Cualquier componente se puede superponer para mostrar distintivos mediante el código HBS que se encuentra en los foros, el control de calidad y los comentarios como ejemplo.

Reglas de puntuación

Las reglas de puntuación son la base de la puntuación con el fin de otorgar distintivos.
Muy sencillamente, cada regla de puntuación es una lista de una o más subreglas. Las reglas de puntuación se aplican al contenido del sitio de la comunidad para identificar las reglas que se aplicarán cuando los distintivos estén habilitados.
Las reglas de puntuación se heredan pero no son aditivas. Por ejemplo:
  • Si page2 contiene la regla de puntuación2 y su antecesor page1 contiene la regla de puntuación1.
  • Una acción en un componente page2 invocará tanto rule1 como rule2.
  • Si ambas reglas contienen subreglas aplicables para el mismo topic/verb :
    • Solo la subregla de la regla 2 afectará la puntuación.
    • Las puntuaciones de ambas subreglas no se suman.
Cuando hay más de una regla de puntuación, las puntuaciones se mantienen por separado para cada regla.
Las reglas de puntuación son nodos de tipo cq:Page con propiedades en su jcr:content nodo que especifican la lista de subreglas que la definen.
Las puntuaciones se almacenan en SRP.
Práctica recomendada: asigne un nombre exclusivo a cada regla de puntuación.
Los nombres de las reglas de puntuación deben ser únicos globalmente; no deben terminar con el mismo nombre.
Un ejemplo de lo que no se debe hacer: /libs/settings/community/scoring/rules/site1/forums-scoring /libs/settings/community/scoring/rules/site2/forums-scoring

Subreglas de puntuación

Las subreglas de puntuación contienen las propiedades que detallan los valores para participar en la comunidad.
Cada subregla de puntuación identifica:
  • ¿Qué actividades se rastrean?
  • ¿Qué función de comunidad específica está involucrada?
  • ¿Cuántos puntos se conceden?
De forma predeterminada, los puntos se otorgan al miembro que realiza la acción, a menos que la subregla especifique que el propietario del contenido recibe los puntos ( forOwner ).
Cada subregla puede incluirse en una o varias reglas de puntuación.
El nombre de la subregla suele seguir el patrón de uso de un asunto , objeto y verbo . Por ejemplo:
  • miembro-comentario-crear
  • miembro-recibo-voto
Las subreglas son nodos de tipo cq:Page con propiedades en su jcr:content nodo que especifican los verbos y los temas .
Propiedad Tipo Value Descripción
VERB Largo
  • requerido; el verbo corresponde a una acción de evento
  • debe haber al menos una propiedad verbo
  • el verbo debe introducirse en MAYÚSCULAS
  • puede haber varias propiedades de verbo, pero no duplicados
  • el valor es la puntuación que se aplicará a este evento
  • el valor puede ser positivo o negativo
  • una lista de verbos admitidos en la versión se encuentra en la sección Temas y verbos
topics Cadena[]
  • opcional; restringe la subregla a los componentes de la comunidad identificados por los temas de evento
  • si se especifica : el valor es una cadena de varios valores de temas de evento
  • una lista de los temas de la versión se encuentra en la sección Temas y verbos
  • el valor predeterminado es aplicar a todos los temas asociados con los verbos
forOwner Booleano
  • opcional; no es relevante cuando el miembro actúa con el contenido que posee
  • si es true, aplique una puntuación al propietario del contenido en el que se actúa
  • si es false, aplique una puntuación a los miembros que realicen una acción
  • el valor predeterminado es false
scoringType Cadena
  • opcional; identifica el motor de puntuación
  • si es "básico", especifica el motor de puntuación en función de la cantidad
    • incluido en la versión
  • si "avanzado", especifica el motor de puntuación en función de la calidad y la cantidad
  • el valor predeterminado es "basic"

Reglas y subreglas de puntuación incluidas

En la versión se incluyen dos reglas de puntuación para la función Función Foro Foro (una para los componentes Foro y otra para los comentarios de la función Foro):
  1. /libs/settings/community/scoring/rules/comments-scoring
    • subRules # =/libs/settings/community/scoring/rules/sub-rules/miembro-comment-create/libs/settings/community/scoring/rules/sub-rules/miembro-welcome-vote/libs/settings/scoring/rules/sub-rules/miembro-dar-voto/libs/settings/community/scoring/rules/sub-rules/miembro-is-moderated
  2. /libs/settings/community/scoring/rules/forums-scoring
    • subRules # =/libs/settings/community/scoring/rules/sub-rules/miembro-forum-create/libs/settings/community/scoring/rules/sub-rules/miembro-welcome-vote/libs/settings/scoring/rules/sub-rules/miembro-dar-voto/libs/settings/community/scoring/rules/sub-rules/miembro-is-moderated
Notas:
  • Los nodos rules y sub-rules los nodos son de tipo cq:Page.
  • subRules es un atributo de tipo String # en el jcr:content nodo de la regla.
  • sub-rules puede compartirse entre varias reglas de puntuación.
  • rules debe estar ubicado en una ubicación de repositorio con permiso de lectura para todos.
    • Los nombres de las reglas deben ser únicos independientemente de la ubicación.

Activación de reglas de puntuación personalizadas

Los cambios o adiciones realizados en las reglas de puntuación o subreglas realizados en el entorno de creación deben instalarse en la publicación.

Reglas de insignia

Las reglas de asignación de distintivos vinculan las reglas de puntuación a los distintivos especificando:
  • Regla de puntuación.
  • Puntuación necesaria para que se le otorgue una insignia específica.
Las reglas de asignación de distintivos son nodos de tipo cq:Page con propiedades en su jcr:content nodo que correlacionan las reglas de puntuación con puntuaciones y distintivos.
Las reglas para la identificación consisten en una thresholds propiedad obligatoria que es una lista ordenada de puntuaciones asignadas a distintivos. Las puntuaciones deben ordenarse en valor creciente. Por ejemplo:
  • 1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
    • Se concede una insignia de bronce para ganar 1 punto.
  • 60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
    • Se otorga una insignia de plata cuando se acumulan 60 puntos.
  • 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
    • Se otorga una insignia de oro cuando se acumulan 80 puntos.
Las reglas de asignación de distintivos están emparejadas con reglas de puntuación que determinan la acumulación de puntos. Consulte la sección titulada Aplicar reglas al contenido .
La scoringRules propiedad de una regla de distintivo simplemente restringe qué reglas de puntuación se pueden emparejar con esa regla de distintivo en particular.
Práctica recomendada: cree imágenes de distintivo únicas para cada sitio de AEM.
Propiedad Tipo Value Descripción
umbrales Cadena[] (obligatorio) Una cadena de varios valores del formulario 'number|path'
  • number = score
  • | = el carácter de línea vertical (U+007C)
  • path = ruta completa al recurso de imagen de distintivo
Las cadenas deben ordenarse de modo que los números aumenten en valor y no debería aparecer espacio en blanco entre el número y la ruta. Ejemplo de entrada: 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
badgingType Cadena (opcional) Identifica el motor de puntuación como "básico" o "avanzado". Si desea el motor de puntuación avanzado, consulte Puntuación avanzada y distintivos . El valor predeterminado es "basic".
scoringRules Cadena[] ( opcional ) Una cadena de varios valores para restringir la regla de identificación a los eventos de puntuación identificados por las reglas de puntuación

Reglas de identificación incluidas

En la versión se incluyen dos reglas de asignación de distintivos que corresponden a las reglas de puntuación de foros y comentarios.
  • /libs/settings/community/badging/rules/comments-badging
  • /libs/settings/community/badging/rules/forums-badging
Notas:
  • rules los nodos son del tipo cq:Page.
  • rules debe estar ubicado en una ubicación de repositorio con permiso de lectura para todos.
    • Los nombres de las reglas deben ser únicos independientemente de la ubicación.

Activación de reglas de distintivo personalizadas

Cualquier cambio o adición que se realice en las reglas de marcado o en las imágenes realizadas en el entorno del autor debe instalarse en la publicación.

Asignar y revocar distintivos

Los distintivos pueden asignarse a miembros mediante la consola de miembros o mediante comandos cURL programáticamente.
Los siguientes comandos cURL muestran lo que es necesario para una solicitud HTTP para asignar y revocar distintivos. El formato básico es:
cURL -i -X POST -H header -u inicio de sesión -F operación -F distintivo miembro-perfil-url
header = "Accept:application/json"encabezado personalizado para pasar al servidor (requerido)
signin = admin-id:password, por ejemplo: admin:admin
operation = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"
badge = "badgeContentPath= badge-image-file "
badge-image-file = la ubicación del archivo de imagen del distintivo en el repositorio, por ejemplo: /libs/settings/community/badging/images/moderator/jcr:content/moderator.png
miembro-perfil-url = el punto final del perfil del miembro en la publicación, por ejemplo: https://<servidor>:<puerto>/home/users/community/riley/profile.social.json
El miembro-perfil-url :
  • Puede hacer referencia a una instancia de autor si el servicio de túnel está habilitado.
  • Puede ser un nombre oscuro y aleatorio; consulte Lista de comprobación de seguridad con respecto a un ID autorizado.

Ejemplos:

Asignar una insignia de moderador

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" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

Revocar una insignia de plata asignada

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/libs/settings/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

El uso de cURL para asignar y revocar insignias funciona para cualquier imagen de insignia, pero cuando se asignan en lugar de ganarse, se marcan como insignias asignadas y se gestionan en consecuencia.

Puntuación y distintivos para componentes personalizados

Las reglas de puntuación y de distintivo se pueden crear para componentes personalizados asociando los temas de evento creados para el componente con verbos.

Temas y verbos

Cuando los miembros interactúan con las funciones de la comunidad, se envían eventos que pueden activar oyentes asincrónicos, como notificaciones y puntuación.
La instancia de SocialEvent de un componente registra los eventos actions que se producen para un topic . SocialEvent incluye un método para devolver un verb asociado a la acción. Hay una relación n-1 entre actions y verbs .
Para los componentes de comunidades entregados, las siguientes tablas describen la verbs definición de cada uno de los topic disponibles para su uso en las subreglas de puntuación.
Una nueva propiedad booleana, allowBadges , activa o desactiva la visualización de distintivos para una instancia de componente. Se puede configurar en los cuadros de diálogo de edición de componentes actualizados mediante una casilla de verificación rotulada Mostrar distintivos .
Calendario Componente ​SocialEvent topic = com/adobe/cq/social/calendar
Verbo
Descripción
POST
miembro crea un evento de calendario
AÑADIR
comentarios de miembros en un evento de calendario
ACTUALIZAR
se edita el evento o comentario del calendario del miembro
ELIMINAR
se elimina el evento o comentario del calendario del miembro
Componente ​ComentariosSocialEvent topic = com/adobe/cq/social/comment
Verbo
Descripción
POST
miembro crea un comentario
AÑADIR
respuestas de los miembros al comentario
ACTUALIZAR
se edita el comentario del miembro
ELIMINAR
se elimina el comentario del miembro
Componente ​Biblioteca de archivosSocialEvent topic = com/adobe/cq/social/fileLibrary
Verbo
Descripción
POST
miembro crea una carpeta
ATTACH
miembro carga un archivo
ACTUALIZAR
Un miembro actualiza una carpeta o un archivo
ELIMINAR
elimina una carpeta o un archivo
Foro Componente ​SocialEvent topic = com/adobe/cq/social/forum
Verbo
Descripción
POST
miembro crea un tema del foro
AÑADIR
respuestas de los miembros al tema del foro
ACTUALIZAR
se edita el tema o la respuesta del foro del miembro
ELIMINAR
se elimina el tema o la respuesta del foro del miembro
Componente ​HistorialSocialEvent topic = com/adobe/cq/social/historial
Verbo
Descripción
POST
miembro crea un artículo de blog
AÑADIR
comentarios de miembros en un artículo de blog
ACTUALIZAR
se edita el artículo o comentario del blog del miembro
ELIMINAR
se elimina el artículo o comentario del blog del miembro
QnA Component ​SocialEvent topic = com/adobe/cq/social/qna
Verbo
Descripción
POST
miembro crea una pregunta QnA
AÑADIR
miembro crea una respuesta de QnA
ACTUALIZAR
se edita la pregunta o la respuesta de control de calidad del miembro
SELECCIONAR
la respuesta del miembro está seleccionada
DESSELECCIONAR
se anula la selección de la respuesta del miembro
ELIMINAR
se elimina la pregunta o la respuesta de control de calidad del miembro
Reseñas del componente ​SocialEvent topic = com/adobe/cq/social/review
Verbo
Descripción
POST
miembro crea revisión
ACTUALIZAR
se edita la revisión del miembro
ELIMINAR
se elimina la revisión del miembro
Componente ​de clasificación SocialEvent topic = com/adobe/cq/social/tally/rating
Verbo
Descripción
AÑADIR CLASIFICACIÓN
el contenido del miembro se ha valorado
QUITAR CLASIFICACIÓN
el contenido del miembro se ha reducido
Componente ​de votaciónSocialEvent topic = com/adobe/cq/social/tally/vote
Verbo
Descripción
AÑADIR VOTACIÓN
el contenido de los miembros ha sido votado
ELIMINAR VOTACIÓN
el contenido de los miembros ha sido rechazado
Componentes habilitados para moderaciónSocialEvent topic = com/adobe/cq/social/moderation
Verbo
Descripción
DENEGAR
se deniega el contenido del miembro
INDICADOR COMO INAPROPIADO
se marca el contenido del miembro
DESALOG-AS-INAPROPIADO
el contenido del miembro no está marcado
ACEPTAR
el moderador aprueba el contenido del miembro
CERRAR
el miembro cierra los comentarios a las ediciones y las respuestas
ABRIR
miembro vuelve a abrir el comentario

Eventos de componentes personalizados

Para un componente personalizado, se crea una instancia de SocialEvent para registrar los eventos del componente actions como los que se producen para un topic .
Para admitir la puntuación, el evento de SocialEvent tendría que anular el método de getVerb() modo que se verb devuelva un valor apropiado para cada action . El verb resultado de una acción puede ser uno de uso común (como POST ) o uno especializado para el componente (como ADD RATING ). Hay una relación n-1 entre actions y verbs .

Solución de problemas

Los distintivos no aparecen

Si se han aplicado reglas de puntuación y de distintivo al contenido del sitio web, pero no se han otorgado distintivos para ninguna actividad, asegúrese de que se hayan habilitado las insignias para la instancia del componente.

La regla de puntuación no tiene efecto

Si se han aplicado reglas de puntuación y de identificación al contenido del sitio web, y se están adjudicando insignias para algunas acciones, pero no para otras, compruebe que la regla de insignia no haya restringido las reglas de puntuación a las que se aplica.
Consulte la scoringRules propiedad de las reglas de asignación de distintivos .

Typo sensible a mayúsculas y minúsculas

La mayoría de las propiedades y los valores, especialmente los verbos, distinguen entre mayúsculas y minúsculas. Los verbos deben ser todos MAYÚSCULAS cuando se utilizan en una subregla de puntuación.
Si la función no funciona correctamente, asegúrese de que los datos se hayan introducido correctamente.

Prueba rápida

Es posible probar rápidamente la puntuación y la identificación mediante el sitio Tutorial de introducción (participación):
  • Acceda a CRXDE Lite en el autor.
  • Vaya a la página base:
    • /content/sites/engagement/es/jcr:content
  • Añada la propiedad badgingRules:
    • Nombre : badgingRules
    • Tipo : String
    • Seleccionar varios
    • Seleccionar Añadir
    • Enter /libs/settings/community/badging/rules/forums-badging
    • Seleccione +
    • Enter /libs/settings/community/badging/rules/comments-badging
    • Seleccione Aceptar
  • Añada la propiedad scoringRules:
    • Nombre : scoringRules
    • Tipo : String
    • Seleccionar varios
    • Seleccionar Añadir
    • Enter /libs/settings/community/scoring/rules/forums-scoring
    • Seleccione +
    • Enter /libs/settings/community/scoring/rules/comments-scoring
    • Seleccione Aceptar
  • Seleccione Guardar todo .
A continuación, asegúrese de que los componentes de foro y comentarios permiten que se muestren distintivos:
  • De nuevo con CRXDE Lite.
  • Vaya al componente de foro
    • /content/sites/engage/en/forum/jcr:content/content/primary/forum
  • Añada la propiedad booleana allowBadges, si es necesario, y asegúrese de que es verdadera.
    • Nombre : allowBadges
    • Tipo : Boolean
    • Valor : true
A continuación, vuelva a publicar el sitio de la comunidad.
Finalmente,
  • Vaya al componente en la instancia de publicación.
  • Inicie sesión como miembro de la comunidad (por ejemplo: weston.mccall@dodgit.com / contraseña).
  • Publicar un nuevo tema del foro.
  • La página debe actualizarse para que se muestre el distintivo.
  • Seleccione el foro.
Esto debería ganar al miembro de la comunidad una insignia de bronce visible con su publicación en el foro debido a que el primer umbral de la regla de identificación de foros es una puntuación de 1.

Información adicional

Puede encontrar más información en la página Puntuación y distintivos esenciales para desarrolladores.
Para obtener información sobre el motor de puntuación avanzado, consulte Puntuación avanzada y distintivos .
El componente y la función configurables de la tabla de clasificación simplifica la visualización de los miembros y sus puntuaciones en un sitio de la comunidad.