Typologies de sites

Ce chapitre est réservé .

Définition

Une typologie de site va permettre de déterminer les types de contenus, les services et les outils disponibles, adaptés au type de site (site institutionnel, blog, intranet, ...).

Le point d'extension org.ametys.web.repository.site.SiteTypesExtensionPoint permet de définir une typologie de site. Il s'agit d'un point d'extension multiple: c'est à dire que plusieurs implémentations de ce point d'extension peuvent être active au même moment.

A ce jour, il existe 2 typologies de sites dans Ametys :

  • org.ametys.web.sitetype.Default : site web avec un plan du site classique
  • org.ametys.plugins.blog.sitetype.Blog : site de type "blog"


On retrouve toutes les typologies de site lors de la création d'un nouveau site :

Déclaration un nouveau type de site

Un type de site est définit par:

  • un nom unique sans espace ni caractère spécial
  • un libellé
  • une description
  • 3 icônes de taille 16x16 pixels, 32x32 pixels et 48x48 pixels
  • 3 icônes de taille 16x16 pixels, 32x32 pixels et 48x48 pixels en cas de configuration incomplète

La déclaration d'un type de site s'effectue dans un fichier plugin.xml. Au besoin, vous serez amené à créer un nouveau plugin, suivez alors les instructions de la page Architecture d'un plugin Ametys.

Voici ci-dessous pour exemple la déclaration du type de site "default" :

<extension id="org.ametys.web.sitetype.Default"
           point="org.ametys.web.repository.site.SiteTypesExtensionPoint"
           class="org.ametys.web.repository.site.DefaultSiteType">
   	<name>default</name>
    <label i18n="true">PLUGINS_WEB_SITETYPE_DEFAULT_LABEL</label>
    <description i18n="true">PLUGINS_WEB_SITETYPE_DEFAULT_DESCRIPTION</description>
    <icons>
    	<small>img/sitetype/default_16.png</small>
        <medium>img/sitetype/default_32.png</medium>
        <large>img/sitetype/default_48.png</large>
    </icons>
    <invalid-icons>
    	<small>img/sitetype/default_invalid_16.png</small>
        <medium>img/sitetype/default_invalid_32.png</medium>
        <large>img/sitetype/default_invalid_48.png</large>
    </invalid-icons>
</extension>

Le chemin des icônes est relatif au répertoire "resources" dans lequel est déclaré le type de site.

Les icônes définies dans <icons> sont utilisées dans le cas normal :



Les icônes définies dans <invalid-icons> sont utilisées lorsque la configuration du site est incomplète :

Configuration

Pour chaque type de site, vous devrez créer 4 fichiers XML de configuration dans le répertoire WEB-INF/param de votre application: