Integration manual

Integration

Display of next appointments and number of unread mail in a frame with the user's name

Follow this chapter if you want to insert a frame in your chart with the name of the logged-in user, his next appointments and the number of unread e-mails.

In your graphic charter, you must :

  • importer la XSL du plugin Messaging connector
    <xsl:import href="plugin:messaging-connector://stylesheets/messaging-connector.xsl" />

  • call the "script -js-messaging-connector " template, which loads the JS

    Example

    <xsl:template name="additionnal-script">  
   ...  
   <xsl:call-template name="script-js-messaging-connector">  
        <xsl:with-param name="css-class-prefix">exchange</xsl:with-param>  
   </xsl:call-template>  
</xsl:template> 

  • call up the "messaging-connector-card" rendering template where you want to insert the information retrieved from the mail server

    <xsl:call-template name="messaging-connector-card">  
        <xsl:with-param name="css-class-prefix">exchange</xsl:with-param>  
</xsl:call-template>  
            

The XSL templates are configurable.

For "script-js-messaging-connector":

  • css-class-prefix: prefix for CSS classes applied to rendering elements, "messaging" by default
  • max-days: search period for upcoming events, default 7 days
  • max-events: maxiumn number of events to display, default 1
  • email-none: key i18n when there are no mail unread messages, default "No unread message(s)".
  • email-single: key i18n when there is 1 mail unread message, default "1 unread message(s)".
  • email-several: key i18n when there are several mail unread messages, default "X unread message(s)".

For "messaging-connector-card" :

  • css-class-prefix: prefix for CSS classes applied to rendering elements, "messaging" by default
  • all messages used in rendering are configurable: email-title, email-waiting, email-error, agenda-title, ... See XSL "messaging-connector-card.xsl".

By default, this helper displays the person's Last Name First Name, then the number of unread messages, then upcoming appointments. Appointments include subject - date - location.
If you don't want to display the location (for example), you'll need to override the "messaging-event-location" template and leave it empty.

Warning
If you override the CSS "messaging" prefix in one of the templates, you must also override it for the other.

The default HTML product is as follows:

<ul class="user-infos exchange-user-infos">  
  <li class="user-infos-person messaging-user-infos-person">  
    <span class="user-infos-person-title messaging-user-infos-person-title">Michel Durand</span>  
  </li>  
  <li class="user-infos-mail messaging-user-infos-mail">  
    <span class="user-infos-mail-title messaging-user-infos-mail-title">Messagerie :</span>  
    <span class="user-infos-waiting messaging-user-infos-waiting" style="display: none;">Chargement en cours...</span>  
    <span style="display:none;" class="user-infos-error messaging-user-infos-error">Une erreur est survenue. Impossible de retrouver les informations.</span>  
    <span style="" class="user-infos-info messaging-user-infos-info">  
      <span id="messaging-nb-msg">5 messages</span>non lu(s)</span>  
  </li>  
  <li class="user-infos-agenda messaging-user-infos-agenda">  
    <span class="user-infos-agenda-title messaging-user-infos-agenda-title">Prochain(s) RDV :</span>  
    <span class="user-infos-waiting messaging-user-infos-waiting" style="display: none;">Chargement en cours...</span>  
    <span style="display:none;" class="user-infos-error messaging-user-infos-error">Une erreur est survenue. Impossible de retrouver les informations.</span>  
    <ul style="" class="user-infos-events messaging-user-infos-events">  
      <li class="user-infos-event messaging-user-infos-event">  
        <span class="user-infos-event-title messaging-user-infos-event-title">Copil Abcd</span>  
        <span class="user-infos-event-separator messaging-user-infos-event-separator" style="display: none;"></span>  
        <span class="user-infos-event-date messaging-user-infos-event-date">lun. 10 juil. 15h00</span>  
        <span class="user-infos-event-separator messaging-user-infos-event-separator" style="display: none;"></span>  
        <span class="user-infos-event-location messaging-user-infos-event-location">Salle Royans-Vercors</span>  
      </li>  
    </ul>  
    <span style="display:none;" class="user-infos-noevent messaging-user-infos-noevent">  
      <span>Aucun évènement</span>d'ici  
      <span class="user-infos-maxdays messaging-user-infos-maxdays"></span>jour(s).</span>  
  </li>  
</ul>  

Using directory links with data input

You can use the link directory and dynamic information display to show upcoming unread appointments and mail .

Please refer to the link directory documentation:

Back to top

Zimbra