DocumentationAEM 6.5Guide de Communities

Messaging Essentials messaging-essentials

Dernière mise à jour : 1 juillet 2026
  • S'applique à :
  • Experience Manager 6.5

Créé pour :

  • Admin

Cette page présente les détails de l’utilisation du composant Messagerie pour inclure une fonctionnalité de messagerie sur un site web.

Essentials pour le côté client essentials-for-client-side

Composer le message

resourceType
social/messaging/components/hbs/composemessage
clientllibs
cq.social.hbs.messaging
modèles
/libs/social/messaging/components/hbs/composemessage/composemessage.hbs
css
/libs/social/messaging/components/hbs/composemessage/clientlibs/composemessage.css
properties
Voir Configurer la messagerie
configuration admin
Configurer la messagerie

Liste de messages

(Pour la boîte de réception, l’envoi et la corbeille)

resourceType
social/messaging/components/hbs/messagebox
clientllibs
cq.social.hbs.messaging
modèles
/libs/social/messaging/components/hbs/messagebox/messagebox.hbs
css
/libs/social/messaging/components/hbs/messagebox/clientlibs/messagebox.css
properties
Voir Configurer la messagerie
configuration admin
Configurer la messagerie

Voir aussi Personnalisations côté client

Essentials pour côté serveur essentials-for-server-side

CAUTION
Le paramètre de chaîne ne doit pas contenir de barre oblique « / » pour les méthodes MessageBuilder suivantes :
  • setInboxPath()
  • setSentItemsPath()
Par exemple :
code language-none 
valid: mb.setInboxPath( "/mail/inbox" );
    not valid: mb.setInboxPath( "/mail/inbox/" );

Site de la communauté community-site

Une structure de site de communauté, créée à l’aide de l’assistant, inclut la fonctionnalité de messagerie lorsqu’elle est sélectionnée. Voir User Management paramètres de la console Sites de la communauté.

Exemple De Code : Notification De Réception De Message sample-code-message-received-notification

La fonctionnalité de messagerie sociale déclenche des événements pour les opérations, par exemple send, marking read, marking delete. Ces événements peuvent être capturés et des actions peuvent être entreprises sur les données contenues dans l’événement.

L’exemple suivant illustre un gestionnaire d’événements qui écoute l’événement message sent et envoie un e-mail à tous les destinataires du message à l’aide de l’Day CQ Mail Service .

Pour tester l’exemple de script côté serveur, vous avez besoin d’un environnement de développement et de la possibilité de créer un lot OSGi :

  1. Connectez-vous en tant qu’administrateur à [CRXDE|Lite](https://localhost:4502/crx/de).

  2. Créez un bundle nodedans /apps/engage/install avec des noms arbitraires, tels que :

    • Nom Symbolique : com.engage.media.social.messaging.MessagingNotification
    • Nom : Prise En Main De La Notification Du Message Du Tutoriel
    • Description : exemple de service permettant d’envoyer une notification par e-mail aux utilisateurs lorsqu’ils reçoivent un message
    • Package : com.engage.media.social.messaging.notification

  3. Accédez à /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/src/main/java/com/engage/media/social/messaging/notification, puis :

    1. Supprimez la classe Activator.java créée automatiquement.
    2. Créez des MessageEventHandler.java de classe.
    3. Copiez et collez le code ci-dessous dans MessageEventHandler.java.

  4. Cliquez sur Enregistrer tout.

  5. Accédez à /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/com.engage.media.social.messaging.MessagingNotification.bnd et ajoutez toutes les instructions d’importation telles qu’écrites dans le code MessageEventHandler.java.

  6. Créez le lot.

  7. Assurez-vous que le service Day CQ Mail ServiceOSGi est configuré.

  8. Connectez-vous en tant qu’utilisateur de démonstration et envoyez un e-mail à un autre utilisateur.

  9. Le destinataire reçoit un e-mail concernant un nouveau message.

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
experience-manager-65-help-communities