Manuel d'intégration

Installation

• Arrêter le serveur

• Télécharger les jars du plugin et ajouter-les (ametys-plugin-blog-1.4.0.jar et ametys-plugin-blog-resources-1.4.0.jar)  dans le répertoire WEB-INF/lib de votre application Ametys

• Un blog est une nouvelle typologie de site. En tant que tel il possède son propre ruban (ribbon), ses propres types de contenus et ses propres services.
  
  Dans le répertoire WEB-INF/param de votre CMS, ajouter les fichiers suivants:
  
  • cms-ribbon-blog.xml : liste des boutons disponibles dans le ruban pour les types de site "blog"
  • cms-uitools-blog.xml: onglets ouverts par défaut quand on ouvre le CMS sur un site de type blog
  • content-types-blog.xml : liste des types de contenus disponibles sur un site de type blog
  • services-blog.xml : liste des services disponibles sur un site de type blog
    
    

• Les billets (ou posts) ont leur propre workflow simplifié (brouillon, validé).
  Téléchargez le fichier de description du workflow pour les billets 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 "blog", comme ci-dessous:
  
  

  Oups !

  La copie dans le presse papier a échouée. Ouvrez le code et copier-le manuellement.

  <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>
  

  <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>
  

  <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

Intégration graphique

Cette extension nécessite obligatoirement que les chartes graphiques utilisées par les blogs possède un gabarit nommé "blog" avec trois zones obligatoires:

• une zone principale "default"
• une zone latérale "about"
• une zone latérale "aside"

Autres gabarits

4 autres gabarits optionnels vous permettent de personnaliser l'affichage en fonction du type de page :

• blog-tag: pour les pages destinées à afficher la liste des billets d'une étiquette
• blog-year: pour les pages destinées à afficher la liste des billets d'une année
• blog-month: pour les pages destinées à afficher la liste des billets d'un mois
• blog-post: pour les pages destinées à afficher un billet

Si ces gabarits n'existent pas, le template "blog" sera automatiquement utilisé.

Comme pour le template "blog", les zones "default", "about" et "aside" sont obligatoire.