Installation

  • Arrêter le serveur
  • Ce plugin nécessite une table sql "Newsletter_Subscribers". Rendez-vous sur la base de données de l'application et exécutez le script correspondant au type de base de donnée utilisée:
  • Télécharger les jars du plugin et ajouter-les (ametys-plugin-newsletter-1.x.y.jar et ametys-plugin-newsletter-resources-1.x.y.jar)  dans le répertoire WEB-INF/lib de votre application Ametys

  • Ajouter le bouton permettant d'ouvrir l'outil de gestion des lettres d'information dans le fichier WEB-INF/params/cms-ribbon-default.xml. L'identifiant du bouton est org.ametys.newsletter.userinterface.Newsletters.
    Il est conseillé de l'ajouter dans l'onglet Accueil, dans le group "Outils avancés"

  • Dans ce même fichier, importer le fichier de ribbon propre aux newsletters plugin:newsletter://cms-ribbon.xml
<tabs>
    <tab label="RIBBON_TABS_TAB_HOME_LABEL">
        <groups>
            [...]
            <group label="RIBBON_TABS_TAB_HOME_GROUPS_GROUP_ADVANCED_TOOL_LABEL" icon="">
                <large>
                    [...]
                    <control id="org.ametys.newsletter.userinterface.Newsletters"/>
                </large>
                <medium>
                    [...]
                    <control id="org.ametys.newsletter.userinterface.Newsletters"/>
                </medium>
                <small/>
            </group>
            [...]
        </groups>
    <tab>
    [...]
 
    <import>plugin:newsletter://cms-ribbon.xml</import>
</tabs>

Attention ! Si le groupe contient une description <large>, <medium> et <small> , il faut ajouter le bouton dans les 3.

 

  • Les lettres d'information ont leur propre workflow (brouillon, proposé, validé). L'action de validation envoie la lettre de diffusion aux inscrits.
    Téléchargez le fichier de description du workflow pour les lettres de d'information et copier-le dans le répertoire WEB-INF/param de votre application.
    Modifiez ensuite le fichier WEB-INF/param/workflows.xml afin d'ajouter la référence à ce fichier en utilisant le nom "newsletter", comme ci-dessous:

    <workflows>
      <workflow name="content" type="file" location="workflow.xml"/>
      <workflow name="newsletter" type="file" location="workflow-newsletter.xml"/>
      <workflow name="blog" type="file" location="workflow-blog.xml"/>
    </workflows>
    
  • Redémarrer le serveur