Fichiers spécifiques des modules

De OviWiki
Révision de 5 novembre 2008 à 16:33 par Paul (discussion | contributions) (addonname_getUserSectionMenus(&$url, &$text))

Aller à : navigation, rechercher


addonini.php

Fichier contenant les paramètres du module


[general] : Variables de configuration

Voir la liste des variables disponibles : Variables du fichier addonini


[recommendations] : Variables de configuration pour le module mais non bloquante pour l'installation

Voir la liste des variables disponibles : Variables du fichier addonini


[addons] : dépendances entre les modules

Dans cette section il faut mettre le nom d'un module en nom de variable et le numéro de version minimale en valeur


[functionalities] : dépendances entre les fonctionalités

Dans cette section, il faut mettre le nom d'un fonctionnalité et comme valeur "Available" ou "Recommended", il est nécessaire de mettre le chemin complet de la fonctionnalité dans le nom de la variable.

history.txt

Ce fichier est optionnel, il permet de saisir l'historique des modifications

init.php

Ce fichier contient les fonctions nécessaires pour relier le module au noyau d'Ovidentia. Toutes les fonction sont préfixées par le nom du module (le nom du répertoire)

addonname_getAdminSectionMenus(&$url, &$text)

Insérer un lien dans la section administration

Cette fonction sera remplacée par l'API du plan de site dans une future version d'Ovidentia

Exemple: <source lang="php">

function newsaddon_getAdminSectionMenus(&$url, &$text)
{
     static $j=0;
     if($j==0)
     {    
     $text = 'News Addon';
     $url = $GLOBALS['babAddonUrl']."admin";
     $j++;
     return true;
     }
     return false;
}

</source>

addonname_getUserSectionMenus(&$url, &$text)

Insérer un lien dans la section utilisateur

Cette fonction sera remplacée par l'API du plan de site dans une future version d'Ovidentia.

Exemple: <source lang="php">

function newsaddon_getUserSectionMenus(&$url, &$text)
{
     static $j=0;
     if($j==0)
     {    
          $text = 'News Addon';
          $url = $GLOBALS['babAddonUrl']."user";
          $j++;
          return true;
     }
return false;
}

</source>

addonname_onSectionCreate(&$title, &$content)

Créer une section

addonname_searchinfos()

Insérer une entrée dans le moteur de recherche d'Ovidentia

addonname_searchresults($q1, $q2, $option, $pos, $nb_result)

Afficher des résultats lors d'une recherche dans Ovidentia

addonname_upgrade($version_base,$version_ini)

  • $version_base : Numéro de version dans la table bab_addons d'Ovidentia, la variable contiens une chaîne vide si c'est une nouvelle installation.
  • $version_ini : Numéro de version dans le fichier INI du module.

Fonction appelée lors de l'installation du module. Elle doit retourner TRUE si la mise à jour c'est effectuée correctement ou FALSE si le module ne doit pas être activé. Uniquement dans le cas ou cette fonction retourne TRUE, le numéro de version du module dans Ovidentia sera mis a jour avec celui du fichier INI du module.

Voir l'article : Développement d'un programme de mise à jour

addonname_onDeleteAddon()

Fonction appelée lors de la suppression du module. Si la fonction devra retourner TRUE pour que la suppression puisse s'effectuer.

ovml.php

Ce fichier permet d'implémenter des containers OVML spécifiques au module

Documentation: Implémentation de containers OVML dans un module