Puntuación y distintivos de comunidades communities-scoring-and-badges

Información general overview

La función de puntuación e insignias de AEM Communities permite identificar y recompensar a los miembros de la comunidad.

Los principales aspectos de la puntuación y las insignias son:

Tenga en cuenta que la concesión de insignias está no habilitada de manera predeterminada.

CAUTION
La estructura de implementación visible en CRXDE Lite está sujeta a cambios una vez que la interfaz de usuario esté disponible.

Insignias badges

Las insignias se colocan bajo el nombre de un miembro para indicar su rol o su posición en la comunidad. Las insignias pueden mostrarse como una imagen o como un nombre. Cuando se muestra como una imagen, el nombre se incluye como texto alternativo para fines de accesibilidad.

De forma predeterminada, los distintivos se encuentran en el repositorio en las siguientes ubicaciones:

  • /libs/settings/community/badging/images

Si se almacenan en una ubicación diferente, todos deben poder acceder a ellas.

Las insignias se diferencian en UGC si se asignaron o se obtuvieron según las reglas. Actualmente, las insignias asignadas aparecen como texto y las insignias obtenidas aparecen como una imagen.

IU de administración de distintivos badge-management-ui

La consola Comunidades insignias le permite agregar insignias personalizadas que se pueden mostrar para un miembro cuando se ganan (se otorgan) o cuando asumen un rol específico en la comunidad (se asignan).

Insignias asignadas assigned-badges

Un administrador asigna las insignias basadas en funciones a los miembros de la comunidad en función de su función en la comunidad.

Las insignias asignadas (y las que se han concedido) se almacenan en el SRP seleccionado y no se puede acceder a ellas directamente. 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 de cURL, consulte la sección titulada Asignar y revocar insignias.

En la versión se incluyen tres distintivos basados en funciones:

  • moderador
    /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

  • administrador de grupo
    /libs/settings/community/badging/images/group-manager/jcr:content/group-manager.png

  • miembro con privilegios
    /libs/settings/community/badging/images/privileged-member/jcr:content/privileged-member.png

    insignias asignadas

Insignias premiadas awarded-badges

El servicio de puntuación otorga insignias basadas en recompensas 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 característica.
  • Las reglas de puntuación e identificación deben ser aplicadas a la página (o antecesor) en la que se coloca el componente.

En la versión se incluyen tres insignias basadas en recompensas:

  • oro
    /libs/settings/community/badging/images/gold-badge/jcr:content/gold.png

  • plata
    /libs/settings/community/badging/images/silver-badge/jcr:content/silver.png

  • bronce
    /libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png

    insignias otorgadas

NOTE
Las reglas de puntuación pueden configurarse para asignar puntos negativos a las publicaciones marcadas como inadecuadas y, por lo tanto, afectar al valor de la puntuación. Sin embargo, una vez que se obtiene un distintivo, no se eliminará automáticamente debido a la reducción de puntos de puntuación o a 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 custom-badges

Los distintivos personalizados se pueden instalar usando la consola Distintivos y se pueden asignar o especificar en las reglas de distintivos.

Cuando se instalan desde la consola Distintivos, los distintivos personalizados se replican automáticamente en el entorno de publicación.

Habilitar puntuación enable-scoring

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 rápida para habilitar la puntuación para un sitio de la comunidad mediante las reglas predeterminadas de puntuación e insignias para foros y comentarios.

Aplicar reglas al contenido apply-rules-to-content

Para habilitar la puntuación y las insignias, agregue las propiedades scoringRules y badgingRules a cualquier nodo del árbol de contenido del sitio.

Si el sitio ya se ha publicado, después de aplicar todas las reglas y habilitar los componentes, vuelva a publicar el sitio.

Las reglas que se aplican a un componente con distintivo habilitado son las del nodo actual o su antecesor.

Si el nodo es del tipo cq:Page (recomendado), usando CRXDE|Lite, agregue las propiedades a su nodo jcr:content.

Propiedad
Tipo
Descripción
badgingRules
Cadena
una lista de matriz de reglas de identificación
scoringRules
Cadena
una lista de matriz de reglas de puntuación
NOTE
Si una regla de puntuación parece no tener ningún efecto en la concesión de insignias, 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 Reglas de identificación.

Habilitar insignias para el componente enable-badges-for-component

Las reglas de puntuación y de marcado solo están en vigor para las instancias de componentes que han habilitado el distintivo al editar la configuración del componente en modo de creación.

Una propiedad booleana, allowBadges, habilita o deshabilita 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 los componentes de foro, control de calidad y comentarios mediante una casilla de verificación denominada Mostrar insignias.

Ejemplo : allowBadges para la instancia del componente Foro example-allowbadges-for-forum-component-instance

enable-badges-component

NOTE
Cualquier componente se puede superponer para mostrar insignias con el código HBS que se encuentra en foros, controles de calidad y comentarios como ejemplo.

Reglas de puntuación scoring-rules

Las reglas de puntuación son la base de la puntuación para la concesión de insignias.

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 aplican cuando se habilitan las insignias.

Las reglas de puntuación se heredan, pero no son aditivas. Por ejemplo:

  • Si la página 2 contiene la regla de puntuación2 y su página antecesora, la página 1 contiene la regla de puntuación1.

  • Una acción en un componente de página 2 invoca rule1 y rule2.

  • Si ambas reglas contienen subreglas aplicables para el mismo topic/verb:

    • Solo la subregla de rule2 afecta a la puntuación.
    • No se añaden las puntuaciones de ambas subreglas.

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 nodo jcr:content que especifican la lista de subreglas que lo definen.

Las puntuaciones se almacenan en SRP.

NOTE
Práctica recomendada: asigne un nombre único a cada regla de puntuación.
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 debe hacer:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring

Subreglas de puntuación scoring-sub-rules

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 específica de la comunidad está involucrada?
  • ¿Cuántos puntos se otorgan?

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 más reglas de puntuación.

El nombre de la subregla suele seguir el patrón de uso de subject, object y verb. Por ejemplo:

  • member-comment-create
  • miembro-recibir-voto

Las subreglas son nodos de tipo cq:Page con propiedades en su jcr:contentnodo que especifican los verbos y temas .

Propiedad
Tipo
Descripción del valor
VERB
Largo
  • obligatorio; el verbo corresponde a una acción de evento
  • debe haber al menos una propiedad de verbo
  • el verbo debe escribirse en MAYÚSCULAS
  • puede haber varias propiedades de verbo, pero no hay duplicados
  • el valor es la puntuación que se aplicará a este evento
  • el valor puede ser positivo o negativo
  • hay una lista de verbos admitidos en la versión 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 eventos
  • hay una lista de temas en la versión 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 sobre el contenido que posee
  • si es true, aplicar puntuación al propietario del contenido sobre el que se actúa
  • si es false, aplicar puntuación al miembro que realiza 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 es "avanzado", especifica el motor de puntuación en función de la calidad y la cantidad.
  • el valor predeterminado es "básico"

Reglas y subreglas de puntuación incluidas included-scoring-rules-and-sub-rules

En la versión se incluyen dos reglas de puntuación para la Función Foro (una para los componentes Foro y Comentarios de la función Foro):

  1. /libs/settings/community/scoring/rules/comments-scoring

    • subRules[] =
      /libs/settings/community/scoring/rules/sub-rules/member-comment-create
      /libs/settings/community/scoring/rules/sub-rules/member-receive-vote
      /libs/settings/community/scoring/rules/sub-rules/member-given-vote
      /libs/settings/community/scoring/rules/sub-rules/member-is-moderated
  2. /libs/settings/community/scoring/rules/forums-scoring

    • subRules[] =
      /libs/settings/community/scoring/rules/sub-rules/member-forum-create
      /libs/settings/community/scoring/rules/sub-rules/member-receive-vote
      /libs/settings/community/scoring/rules/sub-rules/member-given-vote
      /libs/settings/community/scoring/rules/sub-rules/member-is-moderated

Notas:

  • Los nodos rules y sub-rules son de tipo cq:Page.

  • subRules es un atributo de tipo Cadena[] en el nodo jcr:content de la regla.

  • sub-rules se puede compartir entre varias reglas de puntuación.

  • rules debe estar 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.

Activar reglas de puntuación personalizadas activating-custom-scoring-rules

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

Reglas de distintivos badging-rules

Las reglas de distintivos vinculan las reglas de puntuación a los distintivos especificando lo siguiente:

  • Regla de puntuación
  • Puntuación necesaria para conseguir una insignia específica

Las reglas de distintivos son nodos de tipo cq:Page con propiedades en su nodo jcr:content que correlacionan las reglas de puntuación con puntuaciones e insignias.

Las reglas para el distintivo consisten en una propiedad obligatoria thresholds que es una lista ordenada de puntuaciones asignadas a distintivos. Las puntuaciones deben ordenarse en un valor creciente. Por ejemplo:

  • 1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png

    • Se otorga una insignia de bronce por ganar un punto.
  • 60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png

    • Se otorga una insignia de plata cuando se han acumulado 60 puntos.
  • 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png

    • Se otorga una insignia de oro cuando se han acumulado 80 puntos.

Las reglas de distintivos están emparejadas con las reglas de puntuación, que determinan cómo se acumulan los puntos. Consulte la sección titulada Aplicar reglas al contenido.

La propiedad scoringRules de una regla de distintivos simplemente restringe qué reglas de puntuación se pueden emparejar con esa regla de distintivos en particular.

NOTE
AEM Práctica recomendada: crear imágenes de distintivo exclusivas de cada sitio de.

configuración-regla-distintivo

Propiedad
Tipo
Descripción del valor
umbrales
Cadena

(obligatorio) Una cadena de varios valores con el formato 'número|ruta'

  • number = score
  • | = el gráfico de líneas verticales (U+007C)
  • ruta = ruta completa al recurso de imagen de distintivo

Las cadenas deben ordenarse de modo que los números aumenten de valor y no aparezca ningún espacio en blanco entre el número y la ruta.
Entrada de ejemplo:
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 usar el motor de puntuación avanzada, consulte Puntuación avanzada e insignias. El valor predeterminado es "básico".
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 distintivos incluidas included-badging-rules

Esta versión incluye dos reglas de identificación 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 nodos son de tipo cq:Page.

  • rules debe estar 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.

Activar reglas de distintivos personalizadas activating-custom-badging-rules

Los cambios o adiciones realizados en las reglas de distintivo o en las imágenes en el entorno de creación deben instalarse en la publicación.

Asignar y revocar distintivos assign-and-revoke-badges

Las insignias se pueden asignar a los miembros mediante la consola members o mediante programación usando comandos cURL.

Los siguientes comandos cURL muestran lo necesario para una solicitud HTTP para asignar y revocar insignias. El formato básico es:

cURL -i -X POST -H encabezado -u inicio de sesión -F operación -F distintivo perfil de miembro-url

header = "Accept:application/json"
encabezado personalizado para pasar al servidor (obligatorio)

inicio de sesión = id. de administrador:contraseña
por ejemplo, admin:admin

operación = ":operation=social:assignBadge" O ":operation=social:deleteBadge"

badge = "badgeContentPath=badge-image-file"

archivo-imagen-distintivo = la ubicación del archivo de imagen de distintivo en el repositorio
por ejemplo, /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

member-profile-url = el extremo del perfil del miembro al publicar
por ejemplo, https://<server>:<port>/home/users/community/riley/profile.social.json

NOTE
La url-perfil-miembro:

Por ejemplo: examples

Asignar un distintivo de moderador assign-a-moderator-badge

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 revoke-an-assigned-silver-badge

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
NOTE
El uso de cURL para asignar y revocar insignias funciona para cualquier imagen de insignia, pero cuando se asigna en lugar de ganarse, se marcan como insignias asignadas y se gestionan en consecuencia.

Puntuación e insignias para componentes personalizados scoring-and-badges-for-custom-components

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

Temas y verbos topics-and-verbs

Cuando los miembros interactúan con las características de las comunidades, se envían eventos que pueden almacenar en déclencheur a los oyentes asincrónicos, como notificaciones y puntuación.

La instancia SocialEvent de un componente registra los eventos como actions que se producen para un topic. SocialEvent incluye un método para devolver verb asociado con la acción. Hay una relación n-1 entre actions y verbs.

Para los componentes de comunidades entregados, las siguientes tablas describen los verbs definidos para cada topic disponibles para su uso en subreglas de puntuación.

NOTE
Una nueva propiedad booleana, allowBadges, habilita o deshabilita la visualización de distintivos para una instancia de componente. Se puede configurar en cuadros de diálogo de edición de componentes actualizados a través de una casilla de verificación denominada Mostrar insignias.

Componente de calendario
SocialEvent topic= com/adobe/cq/social/calendar

Verbo
Descripción
POST
el miembro crea un evento de calendario
AÑADIR
comentarios de miembros sobre un evento de calendario
ACTUALIZAR
el evento o comentario del calendario del miembro se ha editado
ELIMINAR
se elimina el evento o comentario del calendario del miembro

Componente Comentarios
SocialEvent topic= com/adobe/cq/social/comment

Verbo
Descripción
POST
el miembro crea un comentario
AÑADIR
el miembro responde al comentario
ACTUALIZAR
el comentario del miembro se ha editado
ELIMINAR
se ha eliminado el comentario del miembro

Componente de biblioteca de archivos
SocialEvent topic= com/adobe/cq/social/fileLibrary

Verbo
Descripción
POST
el miembro crea una carpeta
ADJUNTAR
el miembro carga un archivo
ACTUALIZAR
el miembro actualiza una carpeta o archivo
ELIMINAR
el miembro elimina una carpeta o archivo

Componente de foro
SocialEvent topic= com/adobe/cq/social/forum

Verbo
Descripción
POST
miembro crea tema de foro
AÑADIR
miembro responde al tema del foro
ACTUALIZAR
se edita el tema del foro o la respuesta del miembro
ELIMINAR
se elimina el tema o la respuesta del foro del miembro

Componente de diario
SocialEvent topic= com/adobe/cq/social/journal

Verbo
Descripción
POST
el miembro crea un artículo de blog
AÑADIR
comentarios de los miembros sobre 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

Componente QnA
SocialEvent topic = com/adobe/cq/social/qna

Verbo
Descripción
POST
el miembro crea una pregunta de control de calidad
AÑADIR
el miembro crea una respuesta de control de calidad
ACTUALIZAR
se ha editado la pregunta o respuesta de control de calidad del miembro
SELECT
la respuesta del miembro está seleccionada
DESELECCIONAR
la respuesta del miembro está desactivada
ELIMINAR
se elimina la pregunta o respuesta de control de calidad del miembro

Componente de críticas
SocialEvent topic= com/adobe/cq/social/review

Verbo
Descripción
POST
el miembro crea una revisión
ACTUALIZAR
se ha editado la revisión del miembro
ELIMINAR
se ha eliminado 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 ha subido de categoría
ELIMINAR CLASIFICACIÓN
el contenido del miembro no se ha valorado correctamente

Componente de votación
SocialEvent topic= com/adobe/cq/social/tally/vote

Verbo
Descripción
AGREGAR VOTO
el contenido del miembro se ha votado arriba
ELIMINAR VOTO
el contenido del miembro ha sido rechazado

Componentes habilitados para moderación
SocialEvent topic= com/adobe/cq/social/moderation

Verbo
Descripción
DENEGAR
se ha denegado el contenido del miembro
MARCAR COMO INAPROPIADO
el contenido del miembro está marcado
NO MARCAR COMO INAPROPIADO
el contenido del miembro no está marcado
ACEPTAR
el moderador aprueba el contenido del miembro
CERRAR
el miembro cierra el comentario a las ediciones y respuestas
ABRIR
miembro reabre comentario

Eventos de componentes personalizados custom-component-events

Para un componente personalizado, se crea una instancia de SocialEvent para registrar los eventos del componente como actions que se producen para un topic.

Para admitir la puntuación, SocialEvent necesita anular el método getVerb() para que se devuelva un verb apropiado para cada action. El verb devuelto para una acción puede ser uno usado con frecuencia (como POST) o uno especializado para el componente (como ADD RATING). Hay una relación n-1 entre actions y verbs.

Resolución de problemas troubleshooting

Las insignias no aparecen badges-are-not-appearing

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

Consulte Habilitar distintivos para el componente.

La regla de puntuación no tiene efecto scoring-rule-has-no-effect

Si se han aplicado reglas de puntuación y de distintivo al contenido del sitio web y se otorgan insignias para algunas acciones, pero no para otras, compruebe que la regla de distintivo no haya restringido las reglas de puntuación a las que se aplica.

Ver la propiedad scoringRules de Reglas de identificación.

Error con distinción de mayúsculas y minúsculas case-sensitive-typo

La mayoría de las propiedades y valores, especialmente los verbos, distinguen entre mayúsculas y minúsculas. Los verbos deben estar en MAYÚSCULAS cuando se utilizan en una subregla de puntuación.

Si la función no funciona como se espera, asegúrese de que los datos se hayan introducido correctamente.

Prueba rápida quick-test

Es posible probar rápidamente la puntuación y la insignia usando el sitio Tutorial de introducción (participación) :

  • Acceder al CRXDE Lite en autor.

  • Vaya a la página base:

    • /content/sites/engage/en/jcr:content
  • Agregue la propiedad badgingRules:

    • Nombre: badgingRules
    • Tipo: String
    • Seleccionar Multi
    • Seleccionar Agregar
    • Ingresar /libs/settings/community/badging/rules/forums-badging
    • Seleccionar +
    • Ingresar /libs/settings/community/badging/rules/comments-badging
    • Seleccionar Aceptar
  • Agregue la propiedad scoringRules:

    • Nombre: scoringRules
    • Tipo: String
    • Seleccionar Multi
    • Seleccionar Agregar
    • Ingresar /libs/settings/community/scoring/rules/forums-scoring
    • Seleccionar +
    • Ingresar /libs/settings/community/scoring/rules/comments-scoring
    • Seleccionar Aceptar
  • Seleccione Guardar todo.

distintivo de puntuación de prueba

A continuación, asegúrese de que los componentes foro y comentarios permiten que se muestren insignias:

  • Otra vez con el CRXDE Lite.

  • Navegación al componente del foro

    • /content/sites/engage/en/forum/jcr:content/content/primary/forum
  • Agregue la propiedad booleana allowBadges, si es necesario, y asegúrese de que sea verdadera.

    • Nombre: allowBadges
    • Tipo: Boolean
    • Valor: true

test-forum-component

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

  • Post crea un nuevo tema de foro.

  • Se debe actualizar la página para que se muestre el distintivo.

    • Cierre la sesión e inicie sesión como otro miembro de la comunidad (por ejemplo: aaron.mcdonald@mailinator.com/password).
  • Seleccione el foro.

Esto debería otorgarle al miembro de la comunidad una insignia de bronce visible con su entrada en el foro debido a que el primer umbral de la regla de insignias en los foros es una puntuación de 1.

placa bronceadora

Información adicional additional-information

Encontrará más información en la página Aspectos básicos de puntuación e insignias para desarrolladores.

Para obtener información sobre el motor de puntuación avanzada, consulte Puntuación avanzada e insignias.

La tabla de clasificación component y la función configurables simplifican la visualización de los miembros y sus puntuaciones en un sitio de la comunidad.

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