Fichiers spécifiques des modules : Différence entre versions

De OviWiki
Aller à : navigation, rechercher
(→‎init.php)
(→‎addonini.php)
 
(10 révisions intermédiaires par un autre utilisateur non affichées)
Ligne 6 : Ligne 6 :
  
  
−
=== Sections du fichier INI ===
+
'''<nowiki>
 +
[general]</nowiki>''' : Variables de configuration
  
−
<nowiki>
+
Voir la liste des variables disponibles : [[Variables du fichier addonini]]
−
[general]</nowiki> : Variables de configuration
+
  
−
<nowiki>
 
−
[addons]</nowiki> : dépendances entre les modules
 
  
−
<nowiki>
 
−
[recommendations]</nowiki> : Variables de configuration pour le module mais non bloquante pour l'installation
 
  
−
=== Variables du fichier INI ===
+
'''<nowiki>
 +
[recommendations]</nowiki>''' : Variables de configuration pour le module mais non bloquante pour l'installation
  
 +
Voir la liste des variables disponibles : [[Variables du fichier addonini]]
  
−
Ces variables peuvent êtres mises dans la section "general" ou dans la section "recommendations"
 
  
−
{|class="prettytable"
+
'''<nowiki>
−
|-
+
[addons]</nowiki>''' : dépendances entre les modules
−
|| '''Nom de la variable''' || '''Description''' || '''Depuis la version'''
+
 
−
|-
+
Dans cette section il faut mettre le nom d'un module en nom de variable et le numéro de version minimale en valeur
−
|| name="addonname" || Nom du module || 5.0.0
+
 
−
|-
+
Exemple :
−
|| version="1.0" || Version du module || 4.0.0
+
 
−
|-
+
<source lang="php">
−
|| description="" || Description qui s'affiche dans la liste des modules sur la page réservée à l'administrateur || 5.0.0
+
[addons]
−
|-
+
jquery=1.5
−
|| longdesc="" || Description longue || 5.0.0
+
</source>
−
|-
+
 
−
|| author="Nom Prénom ( mail@exemple.com )" || Nom de l'auteur et éventuellement son adresse mail || 4.0.0
+
 
−
|-
+
'''<nowiki>
−
|| db_prefix="gds_" || préfixe utilisé pour le nom des tables dans la base mysql d'Ovidentia (le préfixe sera utilisé lors de la suppression du module) || 5.0.0
+
[functionalities]</nowiki>''' : dépendances entre les fonctionnalités
−
|-
+
 
−
|| delete="1" || <nowiki>1|0</nowiki> autoriser la suppression du module (défaut 0) || 5.0.0
+
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.
−
|-
+
 
−
|| addon_access_control="1" || <nowiki>1|0</nowiki> activer ou désactiver le contrôle d'accès par l'administrateur sur le module (défaut 1) || 6.6.90
+
Exemple :
−
|-
+
 
−
|| register_globals="Off" || Tester la valeur de la variable register_globals de php || 5.8.7
+
<source lang="php">
−
|-
+
[functionalities]
−
|| ov_version="6.6.0" || Version minimale d'ovidentia pour que le module fonctionne || 5.8.1
+
LibFileManagement="Available"
−
|-
+
</source>
−
|| php_version="5.0" || Version minimale de php pour que le module fonctionne  || 5.8.1
+
−
|-
+
−
|| mysql_version="5.0" || Version minimale de mysql pour que le module fonctionne || 5.8.7
+
−
|-
+
−
|| mysql_character_set_database="latin1" || Vérifier le code de caractère par défaut de mysql au niveau de la base || 6.6.0
+
−
|-
+
−
|| mysql_collation_database="latin1_swedish_ci" || Vérifier la collation par défaut de mysql au niveau de la base || 6.6.0
+
−
|-
+
−
|| mysql_max_allowed_packet=15M || Vérifier la valeur minimale de la variable max_allowed_packet de mysql || 6.6.0
+
−
|-
+
−
|| mysql_sql_mode="Undefined" || Vérifier la variable sql_mode n'est pas définie || 6.6.0
+
−
|-
+
−
|| upload_directory="Available" || Tester si il existe un répertoire d'upload correctement configuré || 5.8.7
+
−
|-
+
−
|| upload_max_file_size=30M || Vérifier la taille maximale d'un fichier téléchargé vers le serveur || 5.8.7
+
−
|-
+
−
|| lang_directory="Available" || Vérifier que le répertoire lang à la racine du site est accessible en écriture || 5.8.7
+
−
|-
+
−
|| images_directory="Available" || Vérifier que le répertoire images à la racine du site est accessible en écriture || 5.8.7
+
−
|-
+
−
|| mod_expect="Available" || Tester la présence du module expect de php || 6.6.90
+
−
|-
+
−
|| mod_mysql="Available" || Tester la présence du module mysql de php || 5.8.7
+
−
|-
+
−
|| mod_zlib="Available" || Tester la présence du module zlib de php || 5.8.7
+
−
|-
+
−
|| mod_xml="Available" || Tester la présence du module xml de php || 5.8.7
+
−
|-
+
−
|| mod_calendar="Available" || Tester la présence du module calendar de php || 5.8.7
+
−
|-
+
−
|| mod_ldap="Available" || Tester la présence du module ldap de php || 5.8.7
+
−
|-
+
−
|| mod_imap="Available" || Tester la présence du module imap de php || 5.8.7
+
−
|-
+
−
|| mod_gd2="Available" || Tester la présence du module gd de php en version 2 minimum || 5.8.7
+
−
|-
+
−
|| mod_mcrypt="Available" || Tester la présence du module mcrypt de php || 5.8.7
+
−
|-
+
−
|| mod_gettext="Available" || Tester la présence du module gettext de php || 5.8.7
+
−
|-
+
−
|| mod_pdf="Available" || Tester la présence du module pdf de php || 5.8.7
+
−
|-
+
−
|| mod_ftp="Available" || Tester la présence du module ftp de php || 5.8.7
+
−
|-
+
−
|| mod_curl="Available" || Tester la présence du module curl de php || 5.8.7
+
−
|-
+
−
|}
+
  
 
==history.txt==
 
==history.txt==
Ligne 107 : Ligne 57 :
  
 
Cette fonction sera remplacée par l'API du plan de site dans une future version d'Ovidentia
 
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) ===
 
=== addonname_getUserSectionMenus(&$url, &$text) ===
Ligne 112 : Ligne 78 :
 
Insérer un lien dans la section utilisateur
 
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
+
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) ===
 
=== addonname_onSectionCreate(&$title, &$content) ===
Ligne 128 : Ligne 110 :
 
=== addonname_upgrade($version_base,$version_ini) ===
 
=== addonname_upgrade($version_base,$version_ini) ===
  
−
Fonction appellée lors de l'installation du module
+
* $version_base : Numéro de version dans la table <code>bab_addons</code> d'Ovidentia, la variable contiens une chaîne vide si c'est une nouvelle installation.
 +
* $version_ini : Numéro de version dans le [[Variables du fichier addonini|fichier INI]] du module.
 +
 
 +
Fonction appelée lors de l'installation du module. Elle doit retourner <code>TRUE</code> si la mise à jour c'est effectuée correctement ou <code>FALSE</code> si le module ne doit pas être activé. Uniquement dans le cas ou cette fonction retourne <code>TRUE</code>, 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() ===
 
=== addonname_onDeleteAddon() ===
  
−
Fonction appellée lors de la suppression du module
+
Fonction appelée lors de la suppression du module. Si la fonction devra retourner <code>TRUE</code> pour que la suppression puisse s'effectuer.
  
 
==ovml.php==
 
==ovml.php==

Version actuelle en date du 12 juin 2009 à 08:57


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_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

Récupérée de « https://wiki.ovidentia.fr/index.php?title=Fichiers_spécifiques_des_modules&oldid=4447 »