La función de puntuación y distintivos de AEM Communities permite identificar y premiar a los miembros de la comunidad.
Los principales aspectos de la puntuación y las insignias son:
Asignar distintivos para identificar la función de un miembro en la comunidad
Concesión básica de distintivos a los miembros para fomentar su participación (cantidad de contenido creado)
Concesión avanzada de distintivos para identificar a los miembros como expertos (calidad del contenido creado)
Tenga en cuenta que la concesió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.
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
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.
La consola Communities Badges permite agregar distintivos personalizados que se pueden mostrar para un miembro cuando se ganan (se otorgan) o cuando asumen un rol específico en la comunidad (se asignan).
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
/etc/community/badging/images/moderator/jcr:content/moderator.png
Administrador de grupos
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
Miembro privilegiado
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
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:
En la versión se incluyen tres distintivos basados en premios:
Oro
/etc/community/badging/images/gold-badge/jcr:content/gold.png
Plata
/etc/community/badging/images/silver-badge/jcr:content/silver.png
Bronce
/etc/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.
Los distintivos personalizados se pueden instalar mediante la consola Badges y se pueden asignar o especificar en las reglas de distintivo.
Cuando se instalan desde la consola Insignias, los distintivos personalizados se replican automáticamente en el entorno de publicació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:
Identifique las reglas para obtener puntos (reglas de puntuación)
Para los puntos acumulados por reglas de puntuación, asigne distintivos (reglas de identificación)
Aplicar las reglas de puntuación y de identificación a un sitio de la comunidad
Habilitar la identificación para las funciones de la comunidad
Consulte la sección Prueba rápida para habilitar la puntuación para un sitio de la comunidad mediante las reglas de puntuación y marca predeterminadas para los foros y comentarios.
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 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 |
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 Badging.
Las reglas de puntuación y de clasificación solo se aplican a las instancias de componentes que han habilitado la identificación mediante la edición de la configuración de componentes 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 forum, QnA y comment mediante una casilla de verificación rotulada Display Badges.
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.
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 página antecesora1 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
:
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 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 debe hacer:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
Las subreglas de puntuación contienen las propiedades que detallan los valores para participar en la comunidad.
Cada subregla de puntuación identifica
De forma predeterminada, los puntos se otorgan al miembro que realiza la acción, a menos que la subregla especifique el propietario del contenido como receptor de 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 utilizar un asunto, objeto y verbo. Por ejemplo:
Las subreglas son nodos de tipo cq:Page
con propiedades en su nodo jcr:content
que especifican los verbos y temas.
Propiedad | Tipo | Value Descripción |
---|---|---|
VERB |
Largo |
|
topics |
Cadena[] |
|
forOwner |
Booleano |
|
scoringType |
Cadena |
|
En la versión se incluyen dos reglas de puntuación para la Función de foro (una para los componentes Foro y Comentarios de la función Foro):
/etc/community/scoring/rules/comments-scoring
subRules[] =
/etc/community/scoring/rules/sub-rules/miembro-comment-create
/etc/community/scoring/rules/sub-rules/miembro-recibo-voto
/etc/community/scoring/rules/sub-rules/miembro-dar-voto
/etc/community/scoring/rules/sub-rules/miembro-es-moderado
/etc/community/scoring/rules/forums-scoring
subRules[] =
/etc/community/scoring/rules/sub-rules/miembro-forum-create
/etc/community/scoring/rules/sub-rules/miembro-recibo-voto
/etc/community/scoring/rules/sub-rules/miembro-dar-voto
/etc/community/scoring/rules/sub-rules/miembro-es-moderado
Notas:
Los nodos rules
y sub-rules
son de tipo cq:Page
subRules
es un atributo de tipo [] Cadena en el jcr:content
nodo de la regla
sub-rules
pueden compartirse entre varias reglas de puntuación
rules
debe ubicarse en una ubicación de repositorio con permiso de lectura para todos
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.
Las reglas de asignación de distintivos vinculan las reglas de puntuación a los distintivos especificando:
Las reglas de asignación de distintivos son nodos de tipo cq:Page
con propiedades en su nodo jcr:content
que correlacionan las reglas de puntuación con puntuaciones y distintivos.
Las reglas para el marcado consisten en una propiedad thresholds
obligatoria que es una lista ordenada de puntuaciones asignadas a distintivos. Las puntuaciones deben ordenarse en valor creciente. Por ejemplo:
1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/etc/community/badging/images/silver-badge/jcr:content/silver.png
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
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 propiedad scoringRules
de una regla de marcado simplemente restringe qué reglas de puntuación se pueden emparejar con esa regla de marcado en particular.
Práctica recomendada: cree imágenes de distintivo únicas para cada sitio AEM.
Propiedad | Tipo | Valor Descripción |
---|---|---|
umbrales | Cadena[] | (requerido) Una cadena de varios valores del formulario 'number|path'
Ejemplo de entrada: 80|/etc/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 |
En la versión se incluyen dos reglas de identificación que corresponden a las reglas de puntuación de los foros y comentarios.
Notas:
rules
los nodos son del tipo cq:Page
rules
debe ubicarse en una ubicación de repositorio con permiso de lectura para todos
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.
Los distintivos pueden asignarse a miembros mediante la consola miembros o mediante programación mediante comandos cURL.
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 encabezado -u *inicio de sesión * -F *operación * -F *distintivo * miembro-perfil-url
header = "Accept:application/json"
encabezado personalizado para pasar al servidor (requerido)
inicio de sesión = id-administrador:contraseña
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: /etc/community/badging/images/moderator/jcr:content/moderator.png
miembro-perfil-url = el extremo del perfil del miembro al publicar
por ejemplo: https://<servidor>:<puerto>/home/users/community/riley/profile.social.json
El miembro-perfil-url
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" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/etc/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.
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.
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 como actions
que se producen para un topic
. SocialEvent incluye un método para devolver un verb
asociado a la acción. Existe una relación n-1 entre actions
y verbs
.
Para los componentes de comunidades entregados, las tablas siguientes describen el verbs
definido para cada topic
subreglas de puntuación disponibles para su uso en subreglas de puntuación.
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 mediante una casilla de verificación rotulada Insignias de visualización.
Calendario
ComponenteSocialEvent 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 |
Comments
ComponentSocialEvent 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 |
File Library
ComponentSocialEvent 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
ComponenteSocialEvent 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 |
Historial
ComponentSocialEvent 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
ComponentSocialEvent 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 |
Revisa
ComponentSocialEvent 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 |
Rating
ComponentSocialEvent 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 |
Votación
ComponentSocialEvent 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ón
SocialEvent 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 |
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, el evento de SocialEvent tendría que 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 de uso común (como POST
) o uno especializado para el componente (como ADD RATING
). Existe una relación n-1 entre actions
y verbs
.
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.
Consulte Habilitar distintivos para el componente.
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 propiedad scoringRules
de Reglas de identificación.
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.
Es posible probar rápidamente la puntuación y la identificación mediante el sitio Tutorial de introducción (participación):
CRXDE Lite de acceso al autor
Vaya a la página base:
Añada la propiedad badgingRules:
badgingRules
String
/etc/community/badging/rules/forums-badging
+
/etc/community/badging/rules/comments-badging
Añada la propiedad scoringRules:
scoringRules
String
/etc/community/scoring/rules/forums-scoring
+
/etc/community/scoring/rules/comments-scoring
Seleccione Guardar todo
A continuación, asegúrese de que los componentes de foro y comentarios permiten que se muestren distintivos:
Volver a usar 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
allowBadges
Boolean
true
A continuación, vuelva a publicar el sitio de 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
Se debe actualizar la página 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.
Puede encontrar más información en la página Esenciales de puntuación y distintivos para desarrolladores.
Para obtener información sobre el motor de puntuación avanzado, consulte Puntuación avanzada y distintivos.
El Leaderboard configurable component y function simplifica la visualización de los miembros y sus puntuaciones en un sitio de la comunidad.