Messaging Essentials messaging-essentials

Esta página documenta los detalles de cómo trabajar con utilizando el componente Mensajería para incluir una función de mensajería en un sitio web.

Essentials para el lado del cliente essentials-for-client-side

Escribir mensaje

resourceType
social/messaging/components/hbs/composemessage
clientlibs
cq.social.hbs.messaging
templates
/libs/social/messaging/components/hbs/composemessage/composemessage.hbs
css
/libs/social/messaging/components/hbs/composemessage/clientlibs/composemessage.css
propiedades
Consulte Configurar la mensajería
configuración de administración
Configurar la mensajería

Lista de mensajes

(Para Bandeja de entrada, Enviado y Papelera)

resourceType
social/messaging/components/hbs/messagebox
clientlibs
cq.social.hbs.messaging
templates
/libs/social/messaging/components/hbs/messagebox/messagebox.hbs
css
/libs/social/messaging/components/hbs/messagebox/clientlibs/messagebox.css
propiedades
Consulte Configurar la mensajería
configuración de administración
Configurar la mensajería

Consulte también Personalizaciones del lado del cliente

Essentials para servidor essentials-for-server-side

CAUTION
El parámetro de cadena debe no contenga una barra diagonal "/" para los siguientes métodos de MessageBuilder:
  • setInboxPath()
  • setSentItemsPath()
Por ejemplo:
code language-none
valid: mb.setInboxPath( "/mail/inbox" );
 not valid: mb.setInboxPath( "/mail/inbox/" );

Sitio de la comunidad community-site

Una estructura de sitio de comunidad, creada con el asistente, incluye la función de mensajería cuando se selecciona. Consulte User Management configuración de Consola de sitios de la comunidad.

Código de ejemplo: Mensaje recibido notificación sample-code-message-received-notification

La función Mensajería social emite eventos para operaciones como, por ejemplo, send, marking read, marking delete. Estos eventos se pueden capturar y se pueden realizar acciones con los datos contenidos en el evento.

El siguiente ejemplo es de un controlador de eventos que escucha el message sent y envía un correo electrónico a todos los destinatarios de mensajes utilizando Day CQ Mail Service.

Para probar el script de ejemplo del lado del servidor, necesita un entorno de desarrollo y la capacidad de crear un paquete OSGi:

  1. Inicie sesión como administrador para [CRXDE|Lite](https://localhost:4502/crx/de).

  2. Crear un bundle nodein /apps/engage/install con nombres arbitrarios, como:

    • Nombre simbólico: com.engage.media.social.messaging.MessagingNotification
    • Nombre: Notificación de mensaje del tutorial de introducción
    • Descripción: Servicio de ejemplo para enviar una notificación por correo electrónico a los usuarios cuando reciben un mensaje
    • Paquete: com.engage.media.social.messaging.notification
  3. Vaya a /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/src/main/java/com/engage/media/social/messaging/notificationy, a continuación:

    1. Elimine el Activator.java clase creada automáticamente.
    2. Crear clase MessageEventHandler.java.
    3. Copie y pegue el código siguiente en MessageEventHandler.java.
  4. Haga clic en Guardar todo.

  5. Vaya a /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/com.engage.media.social.messaging.MessagingNotification.bndy agregue todas las instrucciones de importación tal como están escritas en la MessageEventHandler.java código.

  6. Genere el paquete.

  7. Asegurar Day CQ Mail ServiceServicio OSGi configurado.

  8. Inicie sesión como usuario de demostración y envíe un correo electrónico a otro usuario.

  9. El destinatario recibe un correo electrónico con respecto a un nuevo mensaje.

MessageEventHandler.java messageeventhandler-java

package com.engage.media.social.messaging.notification;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Reference;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.api.resource.ResourceResolverFactory;
import org.apache.sling.api.resource.Resource;
import org.apache.commons.mail.Email;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;
import org.apache.commons.mail.HtmlEmail;
import java.util.List;
import org.osgi.service.event.Event;
import org.osgi.service.event.EventHandler;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.adobe.cq.social.messaging.api.Message;
import com.adobe.cq.social.messaging.api.MessagingEvent;
import com.day.cq.mailer.MessageGatewayService;
import com.day.cq.mailer.MessageGateway;

@Component(immediate=true)
@Service(EventHandler.class)
@Properties({
        @Property(name = "event.topics", value = "com/adobe/cq/social/message")
})
public class MessagingEventHandler implements EventHandler {
    private Logger logger = LoggerFactory.getLogger(MessagingEventHandler.class);

    @Reference
    ResourceResolverFactory resourceResolverFactory;

    @Reference
    private MessageGatewayService messageGatewayService;

    ResourceResolver resourceResolver=null;
    MessageGateway messageGateway=null;

    public void sendMail(String from, String to,String subject, String content){
        Email email = new SimpleEmail();
        messageGateway = messageGatewayService.getGateway(SimpleEmail.class);
        try {
         email.addTo(to);
            email.addReplyTo(from);
            email.setFrom(from);
            email.setMsg(content);
            email.setSubject(subject);
         messageGateway.send(email);
        } catch(EmailException ex) {
            logger.error("MessageNotificaiton : Error sending email : "+ex.getMessage());
        }
        logger.info("**** MessageNotification **** Mail sent to " + to);
    }

    public void handleEvent(Event event) {
        //Get Message Path and originator User's ID from event
        String messagePath = (String) event.getProperty("path");
        String senderId = (String) event.getProperty("userId");
        MessagingEvent.MessagingActions action = (MessagingEvent.MessagingActions) event.getProperty("action");
        try{
            if(MessagingEvent.MessagingActions.MessageSent.equals(action)){
                resourceResolver = resourceResolverFactory.getAdministrativeResourceResolver(null);

                //Read message
                Resource resource = resourceResolver.getResource(messagePath);
                Message msg = resource.adaptTo(Message.class);

                //Get list of recipient Ids from message
                //For Getting Started Tutorial, Id is same as email. If that is not the case in your site,
                //an additional step is needed to retrieve the email for the Id
                List<String> reclist = msg.getRecipientIdList();
                for(int i=0;i<reclist.size();i++){
                    //Send Email using Mailing Service
                    sendMail("admin@cqadmin.qqq",reclist.get(i),"New message on Getting Started Tutorial", "Hi\nYou have received a new message from  " +  senderId + ". To read it, sign in to Getting Started Tutorial.\n\n-Engage Admin");
                }
            }
        } catch(Exception ex){
            logger.error("Error getting message info : " + ex.getMessage());
        } finally {
            resourceResolver.close();
        }

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