Surcharge des pages virtuelles

Cette fonctionnalité est disponible à partir de la version 4.8.

Les pages virtuelles ont des configurations par défaut. Ces configurations contiennent un contenu et/ou des services. Ces pages virtuelles sont surchargeables par projet et par charte graphique.

  1. Format XML d'une configuration de pages virtuelles :
  2. Surcharge de la configuration de pages virtuelles
  3. Les pages virtuelles surchargeables

Format XML d'une configuration de pages virtuelles :

<model template="page">
<zone id="default">
<service id="org.ametys.web.service.SitemapService">
… paramètres du service…
</service>
<content view="main"/>
</zone>
</model>
  • Balise model: La balise racine
    • Attribut template: Le gabarit des pages virtuelles. S'il n'est pas renseigné, le gabarit "page" sera renseigné par défaut.
    • Balise zone: Ajout d'une zone. 
      • Attribut id: L'identifiant voulu pour la zone. Si l’identifiant choisi est déjà présent, la dernière zone avec l’identifiant sera gardée.
      • Balise service: Ajout d'un service
        • Attribut id: L'identifiant du service voulu
      • Balise content: Ajout du contenu de la page virtuelle. Permet de choisir l’endroit où sera affiché le contenu de la page.

La balise "content" ne peut pas être présente pour une page virtuelle qui n’a pas de contenu. Cela provoque une erreur : « Java.lang.UnsupportedOperationException: This virtual page does not have a content and the overriding configuration requires one. »

Surcharge de la configuration de pages virtuelles

Par défaut Ametys propose une configuration pour chaque ensemble/type de pages virtuelles. Celles-ci se trouvent dans les plugins dans le répertoire"main/<nomPlugin>/virtual-pages/".

Ces configurations par défaut sont toutes surchargeables.

Les surcharges sont lues dans cet ordre : 

  1. Surcharge par charte graphique
    • Trouver le nom du fichier XML associé au type de page qu'on veut surcharger (nomDuFichier.xml)
    • Redéfinir ce fichier XML dans {skin}/virtual-pages/nomDuFichier.xml
  2. Surcharge par projet
    • Trouver le nom du fichier XML associé au type de page qu'on veut surcharger (nomDuFichier.xml)
    • Redéfinir ce fichier XML dans {AmetysHome}/WEB-INF/param/view/virtual-pages/nomDuFichier.xml
  3. Configuration par défaut.

La configuration de charte sera donc prioritaire à la configuration du projet et toutes deux seront prioritaires sur la configuration par défaut.

Les pages virtuelles surchargeables

 

Retour en haut

Manuel de paramétrage et d'intégration