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:
Asignar distintivos para identificar el papel 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 creada).
Nota que la concesión de insignias es no está habilitado 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. 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.
Las Comunidades Consola Insignias permite añadir insignias personalizadas que se pueden mostrar para un miembro cuando se obtiene (se otorga) o cuando asume una función específica en la comunidad (se asigna).
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 otorgadas) se almacenan en el SRP y no son accesibles 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 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 grupo
/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
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:
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
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 Asignar y revocar distintivos sección. Las futuras mejoras incluirán una interfaz de usuario para administrar las insignias de los miembros.
Los distintivos personalizados se pueden instalar utilizando Consola Insignias y asignadas o especificadas en las reglas de identificación.
Cuando se instalan desde la consola Distintivos, 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:
Identificar 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.
Consulte la Prueba rápida para habilitar la puntuación para un sitio de la comunidad mediante las reglas predeterminadas de puntuación e insignias en 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 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) y, a continuación, utilizando CRXDE|Lite, añada las propiedades a su jcr:content
nodo.
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 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 titulada Reglas de distintivos.
Las reglas de puntuación y marcado solo están en vigor para instancias de componentes que han habilitado el distintivo al editar la configuración del componente en modo de creación.
Una propiedad booleana, allowBadges
, activa/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 a través de una casilla de verificación denominada Mostrar distintivos.
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.
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
:
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
que especifican la lista de subreglas que la definen.
Las puntuaciones se almacenan en SRP.
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 para hacer:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/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 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 una sujeto, objeto, y verbo. Por ejemplo:
Las subreglas son nodos de tipo cq:Page
con propiedades en su jcr:content
que especifican el verbos y temas .
Propiedad | Tipo | Valor Descripción |
---|---|---|
VERB |
Largo |
|
topics |
Cadena |
|
forOwner |
Booleano |
|
scoringType |
Cadena |
|
Esta versión incluye dos reglas de puntuación para Función Foro (una para los componentes Foro y Comentarios de la función Foro ):
/libs/settings/community/scoring/rules/comments-scoring
/libs/settings/community/scoring/rules/forums-scoring
Notas:
Ambos rules
y sub-rules
Los nodos son de tipo cq:Page.
subRules
es un atributo de tipo cadena[] en la regla de jcr:content
nodo.
sub-rules
pueden compartirse entre varias reglas de puntuación.
rules
debe estar 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 en el entorno de creación deben instalarse en la publicación.
Las reglas de distintivos vinculan las reglas de puntuación a los distintivos especificando lo siguiente:
Las reglas de identificación son nodos de tipo cq:Page
con propiedades en su jcr:content
que correlacionan las reglas de puntuación con puntuaciones e insignias.
Las reglas para el distintivo consisten en una thresholds
propiedad que es una lista ordenada de puntuaciones asignadas a insignias. Las puntuaciones deben ordenarse en un valor creciente. Por ejemplo:
1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
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.
El scoringRules
La propiedad de en una regla de distintivo simplemente restringe qué reglas de puntuación se pueden emparejar con esa regla de distintivo en particular.
AEM Práctica recomendada: crear imágenes de distintivo exclusivas de cada sitio de.
Propiedad | Tipo | Valor Descripción |
---|---|---|
umbrales | Cadena | (obligatorio) Una cadena de varios valores con el formato 'número|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 utilizar el motor de puntuación avanzada, consulte Puntuación avanzada y distintivos. 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 |
En la versión se incluyen dos reglas de identificación que corresponden a las siguientes 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 de tipo cq:Page.
rules
debe estar en una ubicación de repositorio con permiso de lectura para todos.
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.
Las insignias se pueden asignar a los miembros mediante el consola de miembros o mediante programación utilizando 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 firma -F operación -F distintivo member-profile-url
encabezado = Encabezado personalizado "Accept:application/json" para pasarlo al servidor (obligatorio)
firma = administrator-id:contraseña por ejemplo, admin:admin
operación = ":operation=social:assignBadge" O ":operation=social:deleteBadge"
distintivo = "badgeContentPath=badge-image-file"
badge-image-file = 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 punto final del perfil del miembro al publicar, por ejemplo, https://<server>:<port>/home/users/community/riley/profile.social.json
El member-profile-url:
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
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 asigna en lugar de ganarse, se marcan como insignias asignadas y se gestionan en consecuencia.
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.
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 una topic
. SocialEvent incluye un método para devolver un verb
asociado con la acción. Hay un n-1 relación entre actions
y verbs
.
Para los componentes de comunidades entregados, las siguientes tablas describen los siguientes verbs
definido para cada topic
disponible para su uso en subreglas de puntuación.
Una nueva propiedad booleana, allowBadges
, activa/desactiva la visualización de distintivos para una instancia de componente. Se puede configurar en cuadros de diálogo de edición de componentes mediante una casilla de verificación etiquetada como Mostrar distintivos.
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 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 de control de calidad
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/votación
Verbo | Descripción |
---|---|
AGREGAR VOTO | el contenido del miembro se ha votado arriba |
ELIMINAR VOTO | el contenido del miembro ha sido rechazado |
Componentes con moderación habilitada
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 |
Para un componente personalizado, se crea una instancia de un SocialEvent para registrar los eventos del componente como actions
que se producen para una topic
.
Para admitir la puntuación, SocialEvent debe anular el método getVerb()
para que un adecuado verb
se devuelve para cada action
. El verb
devuelto por una acción puede ser uno de uso común (como POST
) o uno especializado para el componente (como ADD RATING
). Hay un n-1 relación entre actions
y verbs
.
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 insignias para el componente.
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.
Consulte la scoringRules
propiedad de Reglas de distintivos.
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.
Es posible probar rápidamente la puntuación y el distintivo con la variable Tutorial de introducción (participación) sitio :
Acceder al CRXDE Lite en autor.
Vaya a la página base:
Agregue la propiedad badgingRules:
badgingRules
String
/libs/settings/community/badging/rules/forums-badging
/libs/settings/community/badging/rules/comments-badging
Agregue la propiedad scoringRules:
scoringRules
String
/libs/settings/community/scoring/rules/forums-scoring
/libs/settings/community/scoring/rules/comments-scoring
Seleccionar Guardar todo.
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.
allowBadges
Boolean
true
Siguiente, volver 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 de foro.
Se debe actualizar la página para que se muestre el distintivo.
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.
Puede encontrar más información en la Elementos esenciales de puntuación e insignias para desarrolladores.
Para obtener información sobre el motor de puntuación avanzada, consulte Puntuación avanzada y distintivos.
La tabla de posiciones configurable componente y función simplifica la presentación de los miembros y sus puntuaciones en un sitio de la comunidad.