Affichage d'actualités: <actualités>

Limiter le nombre d'actualités

L'élément <actualités>, comme le montre l'exemple précédent, peut posséder un attribut maximum qui fixe le nombre maximum d'actualités à afficher. Il prendra les actualités dans l'ordre (qui respecte en général un ordre chronologique inverse: la plus récente d'abord), en ne gardant que les n premières où n est donné par cet attribut maximum.

Si cet attribut n'est pas présent, toutes les actualités seront affichées.

Lien vers plus d'actualités

Catégories des actualités

Les actualités sont souvent classées dans des catégories. Vous pouvez alors sélectionner la ou les catégories qui vous intéressent à l'aide d'un attribut catégories. La valeur de cet attribut prend la forme d'une liste de nombres séparés par des espaces. Chaque nombre correspond à une catégorie. La valeur de ces nombres doit vous être donné par le responsable des actualités en question.

<actualités maximum="3" catégories="3 2" bords="arrondis" style="voile-cadre">
   <source-actualités href="http://web2.ulb.ac.be/actulb/xmldata/newshome.xml"/>
</actualités>

Fixer un nombre minimum d'actualités

Si vous chercher des actualités dans des catégories, vous pouvez fixer un nombre minimum d'actualités à afficher, grâce à l'attribut minimum. Si vous trouvez le nombre minimum d'actualités dans ces catégories, pas de problème: elles seront affichées.

Par contre, si ce nombre n'est pas trouvé dans les catégories souhaitées, le système ira puiser dans le reste des actualités (c'est-à-dire dans les autres catégories que celles qui sont mentionnées).

Cet attribut minimum n'est pris en compte que si des catégories sont sélectionnées (attribut catégories présent).

<actualités minimum="2" maximum="3" catégories="3 2">
   <source-actualités href="http://web2.ulb.ac.be/actulb/xmldata/newshome.xml"/>
</actualités>

Message lorsque aucune actualité n'est disponible

Message en cas d'erreur lors de la lecture des actualités

Où trouver les actualités ?

L'élément <actualités> peut contenir lui-même les actualités à afficher, sous la forme d'éléments <actualité>. Toutefois, il est souvent plus commode de placer ces actualités dans une source xml séparée (demandez à la Cellule de vous en créer une).

Cela vous permettra d'éditer plus simplement votre site web d'un coté, et vos actualités de l'autre.

Vous pouvez également insérer dans vos pages des actualités que vous ne gérez pas directement, mais qui sont mises à votre disposition par d'autres. C'est le cas des actualités thématiques de l'ULB (recherche, enseignements, colloques...) que vous pouvez retrouver dans le système Act'ulb.

Vous pouvez bien entendu combiner les différentes sources d'actualités (en mettre, par exemple, dans l'élément <actualités> et en les complétant par d'autres, extraites du système Act'ULB).

Insérer une <actualité> dans l'élément <actualités>

Vous pouvez encoder vos actualités directement au sein de l'élément <actualités>, en utilisant des sous-éléments <actualité> dont le format est le suivant:

<actualités>
   ...
   <actualité date="10/12/2012">
      <catégorie id="2">Recherche</catégorie>
      <catégorie id="14">Actualités</catégorie>
      <titre>Découverte du Boson de Higgs</titre>
      <résumé>
         <p>Les récentes expériences du CERN on pu...</p>
         <p>Ce maillon manquant parmi les constituants les plus fondamentaux de...</p>
      </résumé>
      <image file="img/englert.jpg"/>
      <lien docref="ulb:institution:presentation:Boson"/>
   </actualité>
   ...
</actualités>

Seul un titre ou un résumé est obligatoire (un des deux), tout le reste est optionnel.

<actualités maximum="3">
   ...
   <actualité>
      <titre>N'oubliez pas la commémoration de la Saint-V!</titre>
   </actualité>
   ...
   <actualité>
      <résumé>
         <p>Comme chaque année, les primes relatives à l'assurance collective hospitalisation sont indexées.</p>
         <p>Plus d'infos sur le site du département financier.</p>
      </résumé>
   </actualité>
   ...
</actualités>

Les actualités seront prises dans l'ordre de leur apparition au sein de la balise <actualités>.

Un élément <actualité> peut contenir les informations suivantes:

• date: l'attribut date contient la date de l'actualité (c'est une simple chaine de caractères qui ne sera affichée que si cet attribut est présent; cette date ne sert pas à trier chronologiquement les actualités, seul l'ordre d'apparition dans la balise <actualités> est pris en compte).

• <catégorie>: un ou plusieurs éléments <catégorie> peuvent servir à classer les actualités par catégories. Seul l'attribut id est pris en compte pour la sélection des actualités dans ces catégories. Le contenu pourra, à l'avenir, servir à afficher le nom des catégories en question.

• <titre>: l'élément <titre> contient le titre de l'actualité.

• <résumé>: l'élément <résumé> contient le texte de l'actualité, sous la forme d'une suite de un ou plusieurs paragraphes. Il s'agit en général d'un résumé de l'actualité, le texte complet étant accessible via un lien hypertexte donné par la balise <lien> définie ci-après.

• <image>: l'élément <image> sert à définir l'image de type "vignette" à afficher à coté de l'actualité. Par souci de cohérence, utilisez des images carrées de taille 80px par 80px. Les attributs à utiliser pour renseigner l'adresse de l'image sont ceux d'un lien hypertexte, comme pour une image classique.

• <lien>: l'élément <lien> sert à définir l'adresse d'une page à afficher pour connaître la suite de l'actualité, sous la forme d'un lien LIRE LA SUITE... (READ MORE..., LEES MEER...). Les attributs à utiliser sont ceux d'un lien hypertexte.

Insérer les actualités provenant d'une autre source xml

Pour insérer les actualités encodées dans une autre source xml, il suffit de placer un élément <source-actualités source="..."/> comme le montre l'exemple suivant:

<actualités>
   <source-actualités source="news"/>
</actualités>

La valeur de l'attribut source vous sera donnée par la Cellule web. Il est à noter que cette source ne doit pas nécessairement être une source présente dans votre projet. Il peut très bien s'agir d'une source existante dans un autre projet que le votre.

Vous pouvez également mentionner dans cet élément le nombre maximum d'actualités à sélectionner dans cette source, grâce à l'attribut maximum.

<actualités>
   <source-actualités source="news" maximum="5"/>
</actualités>

Si la source qui contient les actualités utilise des catégories, vous pouvez mentionner la liste des catégories qui vous intéresse dans l'attribut catégories (liste de nombres séparés par des espaces), grâce à l'attribut catégories. Le système tentera de prendre les actualités d'abord dans la première catégorie, puis dans la deuxième et ainsi de suite jusqu'à ce que le nombre maximum d'actualités est atteint (attribut maximum). Si maximum n'est pas spécifié, il prendra alors toutes les actualites des catégories mentionnées (et dans l'ordre de celles-ci).

<actualités>
   <source-actualités source="news" maximum="5" catégories="3 8 2"/>
</actualités>

Si ce nombre maximum n'est pas atteint, on peut complèter avec des actualités puisées dans les autres catégories (autres que celles mentionnées), grâce à un attribut minimum qui fixe le nombre minimum d'actualités à obtenir depuis cette source.

<actualités>
   <source-actualités source="news" minimum="3" maximum="5" catégories="3 8 2"/>
</actualités>

Le contenu de la source visée par cette instruction <source-actualités source="..."/> doit être un élément <actualités>, contenant des actualités sous la forme d'éléments <actualité> dont le format est décrit plus haut (ou des éléments <source-actualités> allant chercher des actualités encore ailleurs).

Insérer les actualités provenant d'une source externe

Pour aller chercher des actualités ailleurs que dans une source XML (dans un document xml que vous gérez sur votre serveur, dans l'application Act'ULB, dans une application sur votre serveur, etc.), il suffit d'utiliser le même élément <source-actualités>, mais avec un attribut href.

Les attributs maximum, catégories et minimum présentés ci-dessus restent valables.

<actualités>
   <source-actualités href="http://web2.ulb.ac.be/actulb/xmldata/newshome.xml" catégories="3 2" minimum="2" maximum="5"/>
</actualités>

Dans l'exemple ci-dessus, l'adresse utilisée est celle de l'application Act'ULB générale alimentée par le Service communication.

Les catégories disponibles dans Act'ULB peuvent être retrouvée dans la page principale d'Act'ULB. Sur cette page, les catégories sont affichées sous la forme d'un nuage de tag. Quand vous cliquez sur le nom d'une catégorie (Recherche, Enseignement, Vie culturelle...), l'URL de la page appelée contient une valeur cat=xxx qui indique le numéro de la catégorie correspondante.

Si vous devez gérer vous-même un grand nombre d'actualités (pour une faculté, par exemple), vous pouvez contacter la Cellule web qui mettra à votre disposition une application dédiée.

L'URL utilisée doit retourner un document XML dont la racine est un élément <actualités>, contenant des actualités sous la forme d'éléments <actualité> dont le format est décrit plus haut (ou des éléments <source-actualités> allant chercher des actualités encore ailleurs).

Style des actualités

Un élément <actualités> est considéré comme un bloc. Tous les attributs (style, bords et ses variantes, ajuster-hauteur...) définis pour les blocs peuvent être utilisés, ainsi que l'élément <titre>.

En voici quelques exemples:

Séparateur entre les actualités

Comme dans une liste, on peut choisir la ligne de séparation qui apparaît entre deux actualités, grâce à l'attribut séparateur. Lorsque vous ne précisez pas cet attribut, une ligne de séparation par défaut sera utilisée (à la différence d'une liste où c'est une puce par défaut qui est utilisée).

<actualités style="noteVerte" bords="arrondis" maximum="3" séparateur="colorBar5">
   ...
</actualités>	

Puces et numérotation devant les actualités

Comme dans une liste, on peut faire apparaître une puce ou un numéro devant chaque actualité, grâce aux attributs puce et numérotation. Lorsque vous ne précisez pas ces attributs, seule une ligne de séparation apparaîtra (à la différence d'une liste où une puce par défaut est utilisée).

<actualités style="class1" bords="arrondis" maximum="3" puce="rectangle">
   ...
</actualités>	

<actualités style="blow1" bords="arrondis" maximum="3" séparateur="colorDots1" numérotation="A)">
   ...
</actualités>