DokumentationAEM 6.4Användarhandbok om Communities

Viktiga meddelanden messaging-essentials

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

På den här sidan visas information om hur du arbetar med att använda meddelandekomponenten för att inkludera en meddelandefunktion på en webbplats.

Grundläggande för klientsidan essentials-for-client-side

Skriv meddelande

resourceType
social/messaging/components/hbs/composemage
klientlibs
cq.social.hbs.messaging
mallar
/libs/social/messaging/components/hbs/composemessage/composemessage.hbs
css
/libs/social/messaging/components/hbs/composemessage/clientlibs/composemessage.css
egenskaper
se Konfigurerar meddelanden
administratörskonfiguration
Konfigurerar meddelanden

Meddelandelista (för Inkorgen, Skickat och Papperskorgen)

resourceType
social/messaging/components/hbs/messagebox
klientlibs
cq.social.hbs.messaging
mallar
/libs/social/messaging/components/hbs/messagebox/messagebox.hbs
css
/libs/social/messaging/components/hbs/messagebox/clientlibs/messagebox.css
egenskaper
Se Konfigurerar meddelanden
administratörskonfiguration
Konfigurerar meddelanden

Se även Anpassningar på klientsidan

Grundläggande för serversidan essentials-for-server-side

CAUTION
String-parametern får inte *innehålla ett avslutande snedstreck (/) för följande MessageBuilder-metoder:
  • setInboxPath()
  • setSentItemsPath()
Till exempel:
code language-none 
valid: mb.setInboxPath( "/mail/inbox" );
 not valid: mb.setInboxPath( "/mail/inbox/" );

Community-webbplats community-site

En community-webbplatsstruktur som skapats med guiden innehåller meddelandefunktionen när den väljs. Se User Management inställningar för Konsolen Community Sites.

Exempelkod: Meddelande mottaget sample-code-message-received-notification

Funktionen för sociala meddelanden genererar händelser för åtgärder, till exempel send, marking read, marking delete. Dessa händelser kan fångas upp och åtgärder vidtas utifrån data i händelsen.

Följande exempel är en händelsehanterare som lyssnar efter message sent -händelsen och skickar ett e-postmeddelande till alla meddelandemottagare som använder Day CQ Mail Service.

Om du vill testa exempelskriptet på serversidan behöver du en utvecklingsmiljö och möjlighet att skapa ett OSGi-paket.

  1. Logga in som administratör för att [CRXDE|Lite](http://localhost:4502/crx/de)

  2. Skapa en bundle nodein /apps/engage/install med godtyckliga namn, som

    • Symbolic Name: com.engage.media.social.messaging.MessagingNotification
    • Name: Komma igång - meddelande om självstudiekurser
    • Description: en exempeltjänst för att skicka ett e-postmeddelande till användare när de får ett meddelande
    • Package: com.engage.media.social.messaging.notification

  3. Navigera till /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/src/main/java/com/engage/media/social/messaging/notification

    1. Ta bort Activator.java klass skapas automatiskt
    2. Skapa klass MessageEventHandler.java
    3. Kopiera/klistra in koden nedan i MessageEventHandler.java

  4. Klicka på Save All

  5. Navigera till /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/com.engage.media.social.messaging.MessagingNotification.bnd och lägga till alla import-satser som de är skrivna i MessageEventHandler.java kod.

  6. Bygg paketet

  7. Säkerställ Day CQ Mail ServiceOSGi-tjänsten är konfigurerad

  8. Logga in som en demoanvändare och skicka e-post till en annan

  9. Mottagaren bör få ett e-postmeddelande om ett nytt meddelande

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
5d37d7b0-a330-461b-814d-068612705ff6