Voir la source de Catégorie:Développement OVML

== Syntaxe ==


Le langage OVML permet de dynamiser les pages du portail en permettant au webmaster un accès au
contenu du portail. Ainsi le webmaster pourra accéder à la liste complète des informations publiées et les
restituer afin de donner des points d'entrée à son site.
Exemples : affichage de la liste des catégories d'articles dans une section, affichage des derniers articles
publiés en pages d'accueil...
Le langage a une syntaxe proche de l'HTML et du XML par ses balises. Le code doit être placé dans un
fichier situé dans le répertoire ovml de votre skin (racine d'Ovidentia/skins/votreskin/ovml/).
Il existe plusieurs syntaxes d'appels selon le contexte :

=== Afficher le contenu interprété d'un fichier OVML dans le corps d'OVIDENTIA ===

* <code>index.php?tg=oml&file=monfichier.ovml</code>
* <code>index.php?tg=oml&file=agendas/monfichier.ovml</code> si le fichier est situé dans un sous-répertoire 'agendas' du répertoire ovml de votre skin


=== Afficher le contenu interprété d'un fichier OVML en pleine page ===

<code>index.php?tg=oml&file=monfichier.ovml&echo=1</code>

=== Afficher le contenu interprété d'un fichier OVML par l'éditeur wysiwyg (par exemple, dans une section ou dans un article) ===

* <code>$OVML(monfichier.ovml)</code>
* <code>$OVML(agendas/monfichier.ovml)</code> si le fichier est situé dans un sous-répertoire 'agendas' du répertoire ovml de votre skin


=== Afficher le contenu interprété d'un fichier OVML depuis un fichier template (par exemple dans page.html) ===
          
* <code>{ $OVML(monfichier.ovml) }</code>
* <code>{ $OVML(agendas/monfichier.ovml) }</code> si le fichier est situé dans un sous-répertoire 'agendas' du répertoire ovml de votre skin

Voici les syntaxes courantes :

Création d'une variable : <code><OFPutVar name="compteur" value="0"></code>

Après la déclaration de la variable 'compteur', sa valeur peut s'afficher avec la syntaxe <code><Ovcompteur></code>

Tests de comparaisons : <code><OCIfEqual></code>, <code><OCIfNotEqual></code>, <code><OCIfGreaterThan></code>...

Exemples :

<source lang="xml">
 <OCIfEqual expr1="<OVBAB_SESS_USERID>" expr2="6">
 Vous êtes l'utilisateur ayant l'identifiant 6
 </OCIfEqual>
</source>

Affichage d'une variable globale : <code><OFPutVar></code> permet de définir la variable afin de récupérer sa valeur

Exemple :
<source lang="xml">
 <OFPutVar name="babSkin">
 <img src="skins/<OVbabSkin>/images/bandeau.jpg" alt="Bandeau" title="">
</source>

Pour plus de détails sur la syntaxe et les possibilités du langage, veuillez voir les 2 documentations existantes sur ovidentia.org (ovi-ovml et ovi-ovml utilisation).



== Pages d'accueil ==

Les pages d'accueil publique et privée d'OVIDENTIA peuvent être personnalisées par le webmaster grâce au langage OVML. Il existe 2 fonctionnements utilisables pour la gestion des pages d'accueil :

# Si vous supprimez les fichiers private.html et public.html de votre skin (racine d'Ovidentia/skins/votreskin/ovml/), OVIDENTIA utilisera le template 'entry.html' qui affichera les articles proposés en pages d'accueil (voir les options des thèmes d'articles pour plus de détails).
# Si vous voulez personnaliser les pages d'accueil, vous pouvez utilisez les fichiers 'public.html' (gestion de la page d'accueil publique) et 'private.html' (gestion de la page d'accueil privée) présents dans votre skin (racine d'Ovidentia skins/votreskin/ovml/).

Les 2 fichiers 'private.html' et 'public.html' peuvent contenir des codes html classiques (html, javascript,
css...) et ont aussi l'avantage d'y ajouter l'interprétation de codes OVML.


Exemple :

Ce code affichera les 5 derniers articles publiés (introduction et corps) en tenant compte des droits d'accès :

<source lang="xml">
<OCRecentArticles last="5">
   <p>
      <h2><OVArticleTitle></h2>
      <OVArticleHead>
      <OVArticleBody>
   </p>
</OCRecentArticles>
</source>