Fichiers spécifiques des modules
Sommaire
- 1 addonini.php
- 2 history.txt
- 3 init.php
- 3.1 addonname_getAdminSectionMenus(&$url, &$text)
- 3.2 addonname_getUserSectionMenus(&$url, &$text)
- 3.3 addonname_onSectionCreate(&$title, &$content)
- 3.4 addonname_searchinfos()
- 3.5 addonname_searchresults($q1, $q2, $option, $pos, $nb_result)
- 3.6 addonname_upgrade($version_base,$version_ini)
- 3.7 addonname_onDeleteAddon()
- 4 ovml.php
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
Exemple :
<source lang="php"> [addons] jquery=1.5 </source>
[functionalities] : dépendances entre les fonctionnalité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.
Exemple :
<source lang="php"> [functionalities] LibFileManagement="Available" </source>
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_addonsd'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