WebSVN – Applications.papyrus – Diff – /trunk/papyrus/bibliotheque/fonctions/pap_menu.fonct.php


<?php
/*vim: set expandtab tabstop=4 shiftwidth=4: */ 
// +------------------------------------------------------------------------------------------------------+
// | PHP version 4.1                                                                                      |
// +------------------------------------------------------------------------------------------------------+
// | Copyright (C) 2004 Tela Botanica (accueil@tela-botanica.org)                                         |
// +------------------------------------------------------------------------------------------------------+
// | This library is free software; you can redistribute it and/or                                        |
// | modify it under the terms of the GNU Lesser General Public                                           |
// | License as published by the Free Software Foundation; either                                         |
// | version 2.1 of the License, or (at your option) any later version.                                   |
// |                                                                                                      |
// | This library is distributed in the hope that it will be useful,                                      |
// | but WITHOUT ANY WARRANTY; without even the implied warranty of                                       |
// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU                                    |
// | Lesser General Public License for more details.                                                      |
// |                                                                                                      |
// | You should have received a copy of the GNU Lesser General Public                                     |
// | License along with this library; if not, write to the Free Software                                  |
// | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA                            |
// +------------------------------------------------------------------------------------------------------+
// CVS : $Id: pap_menu.fonct.php,v 1.12 2005-02-28 11:12:03 jpm Exp $
/**
* Bibliothèque de fonction sur le rendu.
*
* Cette bibliothèque contient des fonctions utilisé par le rendu des pages de Papyrus.
*
*@package Papyrus
*@subpackage Fonctions
//Auteur original :
*@author        Jean-Pascal MILCENT <jpm@tela-botanica.org>
//Autres auteurs :
*@author        Alexandre GRANIER <alexadandre@tela-botanica.org>
*@author        Laurent COUDOUNEAU <laurent.coudouneau@ema.fr>
*@copyright     Tela-Botanica 2000-2004
*@version       $Revision: 1.12 $ $Date: 2005-02-28 11:12:03 $
// +------------------------------------------------------------------------------------------------------+
*/
 
// +------------------------------------------------------------------------------------------------------+
// |                                            LISTE des FONCTIONS                                       |
// +------------------------------------------------------------------------------------------------------+
 
/** Fonction GEN_donnerProfondeurMax() - Renvoie le nombre de niveau de menu.
*
* Cette fonction calcule, pour un menu donné, le nombre de niveau de menu fils complétant 
* l'arbre des menus jusqu'au feuilles.
* Ici on l'utilise en passant l'argument égal à zéro c'est à dire
* en partant du menu racine d'un site gmr_id_menu_02 = 0.
* C'est une fonction récursive.
* Noter que la variable $prof est statique.
*
* @param integer identifiant du site sur lequel la profondeur est calculé.
* @param integer identifiant du menu à partir delaquelle on souhaite calculer la profondeur.
* @return integer le nombre de niveau de menu.
*/
function GEN_donnerProfondeurMax($id_site, $id_menu)
{
    global $db;
    static $prof = 0;
    
    // Requête sur les relations de type "avoir père" entre menus
    $requete =  'SELECT gmr_id_menu_01 '.
                'FROM gen_menu, gen_menu_relation '.
                'WHERE gmr_id_menu_02 = '.$id_menu.' '.
                'AND gmr_id_menu_01 = gm_id_menu '.
                'AND gm_ce_site = '.$id_site.' '.
                'AND gmr_id_valeur = 1 '.
                'ORDER BY gmr_ordre ASC';
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    if ($resultat->numRows() == 0) {
        return $prof;
    }
    $prof++;
    while ($ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT)) {
        $prof = GEN_donnerProfondeurMax($id_site, $ligne->gmr_id_menu_01);
    }
    return $prof;
}
 
/** Fonction GEN_donnerDernierFreres() - Renvoie l'id du dernier menu frère.
*
* Cette fonction regarde si un menu donné possède au moins un frère dans l'arbre
* des menus. Elle retourne l'id du dernier menu frére en utilisant gmr_ordre.
* Cette fonction fait appel à la fonction : GEN_lireIdentifiantMenuPere().
*
* @param integer identifiant du menu.
* @return boolean renvoi l'id du dernier menu frère sinon faux.
*/
function GEN_donnerDernierFreres($id_menu)
{
    // Initialisation des variables.
    global $db;
    
    $requete =  'SELECT gmr_id_menu_01 '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_02 = '.GEN_lireIdentifiantMenuPere($id_menu).' '.
                'AND gmr_id_valeur = 1 '.
                'AND gmr_id_menu_01 <> '.$id_menu.' '.
                'ORDER BY gmr_ordre DESC';
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    $ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT);
    if ($resultat->numRows() > 0) {
        return $ligne->gmr_id_menu_01;
    } else {
        return false;
    }
}
 
/** Fonction GEN_etreFreres() - Renvoie vrai si les menus ont le même père.
*
* Cette fonction regarde si deux menus donnés sont frères dans l'arbre
* des menus. Nous regardons si les menus ont le même identifiant comme père.
*
* @param integer identifiant du premier menu.
* @param integer identifiant du seconde menu.
* @return boolean renvoi vrai si les deux menus sont frères sinon faux.
*/
function GEN_etreFreres($id_menu_1, $id_menu_2)
{
    // Initialisation des variables.
    global $db;
    
    $requete =  'SELECT gmr_id_menu_02 '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_01 = '.$id_menu_1.' '.
                'AND gmr_id_valeur = 1 ';
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    $ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT);
    $id_pere_1 = $ligne->gmr_id_menu_02;
    $resultat->free();
 
    $requete =  'SELECT gmr_id_menu_02 '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_01 = '.$id_menu_2.' '.
                'AND gmr_id_valeur = 1 ';
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    $ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT);
    $id_pere_2 = $ligne->gmr_id_menu_02;
    $resultat->free();
    
    return ($id_pere_1 == $id_pere_2);
}
 
/** Fonction GEN_etreAncetre() - Renvoie vrai si le premier argument (identifiant de menu) est un ancètre du second.
*
* Nous récupérons l'identifiant du père du menu passé en argument numéro 2. Puis,
* nous le comparons à l'argument 1. Si c'est les même on retourne faux. Sinon on rapelle
* la fonction avec l'identifiant du père trouvé pour l'argument 2. Ainsi de suite jusqu'a
* renvoyé vrai où tomber sur un menu racine (idetifiant du père = 0).
* Si les variable sont null nous retournons false.
* C'est une fonction récursive.
*
* @param integer identifiant d'un menu numéro 1.
* @param integer identifiant d'un menu numéro 2.
* @return boolean vrai si le menu numéro 1 est ancètre du second.
*/
function GEN_etreAncetre($id_menu_1, $id_menu_2)
{
    //Test erreur
    if (is_null($id_menu_1) || is_null($id_menu_2)) {
        return false;
    }
    
    // Initialisation des variables.
    global $db;
    
    $requete =  'SELECT gmr_id_menu_02 '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_01 = '.$id_menu_2.' '.
                'AND gmr_id_valeur = 1 ';
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die (BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    $ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT);
    $resultat->free();
    if ($ligne->gmr_id_menu_02 == 0) {
        return false;
    } else if ($ligne->gmr_id_menu_02 == $id_menu_1) {
        return true;
    } else {
        return GEN_etreAncetre($id_menu_1, $ligne->gmr_id_menu_02);
    }
}
 
/** Fonction GEN_lireIdentifiantMenuAncetre() - Renvoie l'identifiant du menu ancètre du menu passé en paramètre.
*
*   Cette fonction parcours la table gen_menu_relation et retourne l'identifiant du
*   menu dont le père est le menu racine (identifiant = 0) pour le menu passé en paramètre.
*
*   @global mixed   objet Pear DB de connexion à la base de données..
*   @param  int     identifiant du menu dont il faut rechercher le père.
*   @return int     identifiant du menu ancètre du menu passé en paramètre.
*/
function GEN_lireIdentifiantMenuAncetre($id_menu)
{
    global $db;
    // On teste si on est au niveau d'un menu racine i.e GM_ID_PERE=0
    $requete =  'SELECT gmr_id_menu_02 '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_01 = '.$id_menu.' '.
                'AND gmr_id_valeur = 1 ';// 1 = avoir "père"
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    $ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT);
    $resultat->free();
    
    // Dans le cas où le menu en paramètre est un menu racine
    if ($ligne->gmr_id_menu_02 == 0) {
        return $id_menu;
    }
    
    return GEN_lireIdentifiantMenuAncetre($ligne->gmr_id_menu_02);
}
 
/** Fonction GEN_lireIdentifiantMenuPere() - Renvoie l'identifiant du père du menu passé en paramètre.
*
*   Cette fonction parcours la table gen_menu_relation et retourne l'identifiant du
*   menu père du menu passé en paramètre.
*
*   @global mixed   objet Pear DB de connexion à la base de données..
*   @param  int     l'identifiant du fils
*   @return mixed   l'identifiant du père,ou false en cas d'erreur.
*/
function GEN_lireIdentifiantMenuPere($id_menu)
{
    global $db;
    
    $requete =  'SELECT gmr_id_menu_02 '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_01 = '.$id_menu.' '.
                'AND gmr_id_valeur = 1 ';// 1 = avoir "père"
    
    $resultat = $db->getOne($requete) ;
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    return $resultat;
}
 
/** Fonction GEN_lireInfoMenu() - Renvoie un objet ou un tableau contenant une ligne de la table gen_menu
*
* Retourne la ligne de la table gen_menu concernant le menu ayant pour identifiant la valeur
* passée en paramètre.
* Ancien nom : getLevel()
*
* @param  mixed     une instance de la classse Pear DB.
* @param  int       l'identifiant d'un menu.
* @param  string    le mode dans Pear DB dans lequel on veut recevoir les infos du menu.
* @return  mixed    un objet ou tableau résultat de Pear DB contenant une ligne de la table gen_menu, ou false en cas d'erreur.
*/
function GEN_lireInfoMenu($db, $id_menu, $mode = DB_FETCHMODE_OBJECT)
{
    //----------------------------------------------------------------------------
    // Gestion des erreurs
    
    //----------------------------------------------------------------------------
    // Recherche des informations sur le menu
    $requete =  'SELECT * '.
                'FROM gen_menu '.
                'WHERE gm_id_menu = '.$id_menu;
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    if ($resultat->numRows() != 1) {
        return false;
    }
    
    //----------------------------------------------------------------------------
    // Récupération des infos
    $info_menu = $resultat->fetchRow($mode);
    $resultat->free();
    
    return $info_menu;
}
 
/** Fonction GEN_lireContenuMenu() - Renvoie un objet ou un tableau contenant une ligne de la table gen_menu_contenu
*
* Retourne la ligne de la table gen_menu_contenu concernant le menu ayant pour identifiant la valeur
* passée en paramètre.
*
* @param  mixed     une instance de la classse Pear DB.
* @param  int       l'identifiant d'un menu.
* @param  string    le mode dans Pear DB dans lequel on veut recevoir les infos du menu.
* @return  mixed    un objet ou tableau résultat de Pear DB contenant une ligne de la table gen_menu_contenu, ou false en cas d'erreur.
*/
function GEN_lireContenuMenu($db, $id_menu, $mode = DB_FETCHMODE_OBJECT)
{
    //----------------------------------------------------------------------------
    // Gestion des erreurs
    
    //----------------------------------------------------------------------------
    // Recherche des informations sur le menu
    $requete =  'SELECT * '.
                'FROM gen_menu_contenu '.
                'WHERE gmc_ce_menu = '.$id_menu;
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    if ($resultat->numRows() != 1) {
        return false;
    }
    
    //----------------------------------------------------------------------------
    // Récupération des infos
    $info_menu = $resultat->fetchRow($mode);
    $resultat->free();
    
    return $info_menu;
}
 
/** Fonction GEN_retournerMenus() - Renvoie un tableau contenant les id de l'ensemble des menus
*
* Retourne un tableau contenant les id de l'ensemble des menus des différents sites de Papyrus.
*
* @param  mixed     une instance de la classse Pear DB.
* @return array    tableau contenant les id de chaque menu.
*/
function GEN_retournerMenus($db)
{
    //----------------------------------------------------------------------------
    // Gestion des erreurs
    
    //----------------------------------------------------------------------------
    // Recherche des informations sur le menu
    $requete =  'SELECT gm_id_menu '.
                'FROM gen_menu ';
    
    $resultat = $db->query($requete);
    (DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
    
    //----------------------------------------------------------------------------
    // Récupération des infos
    $tab_retour = array();
    while ($info_menu = $resultat->fetchRow(DB_FETCHMODE_OBJECT)) {
        array_push($tab_retour, $info_menu->gm_id_menu);
    }
    $resultat->free();
    
    return $tab_retour;
}
 
/** Fonction GEN_lireInfoMenuRelation() - Renvoie un objet ou un tableau contenant une ligne de la table gen_menu_relation
*
* Par défaut recherche une relation de type père.
* Ancien nom : getMenuRelation().
*
* @param  mixed   Une instance de la classse PEAR_DB
* @param  int  l'identifiant d'un menu.
* @param  int  l'identifiant d'une valeur de relation.
* @param  string  le mode dans Pear DB dans lequel on veut recevoir les infos du menu.
* @return  mixed   n objet ou tableau résultat Pear DB, ou false en cas d'erreur.
*/
function GEN_lireInfoMenuRelation($db, $menuid, $id_valeur = 1, $mode = DB_FETCHMODE_OBJECT)
{
    //----------------------------------------------------------------------------
    // Recherche des informations sur la relation de menu
    $requete =  'SELECT * '.
                'FROM gen_menu_relation '.
                'WHERE gmr_id_menu_01 = '.$menuid.' '.
                'AND gmr_id_valeur = '.$id_valeur;
    
    $result = $db->query($requete);
    (DB::isError($result)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $result->getMessage(), $requete)) : '';
    
    if ($result->numRows() != 1) {
        return false;
    }
    
    //----------------------------------------------------------------------------
    // Récupération des infos
    $info_menu_relation = $result->fetchRow($mode);
    $result->free();
    
    return $info_menu_relation;
}
 
/** Fonction GEN_verifierPresenceCodeMenu() - Vérifie l'existence d'un code de menu
*
* Permet de vérifier dans la base de données si le code fournie (alphanumérique ou numérique) a déjà
* été attribué à un menu ou pas!
*
* @param  mixed   Une instance de la classse PEAR_DB
* @param  string  le type du code (int ou string).
* @param  integer l'identifiant du menu courant.
* @param  mixed   le code numérique ou alphanumérique.
* @return mixed   retourne l'identifiant du menu possédant le code sinon false.
*/
function GEN_verifierPresenceCodeMenu($db, $type, $id_menu, $code)
{
    // Gestion des erreurs
    if ($code == '') {
        return true;
    }
    
    // Requete pour vérifier l'abscence du code numérique et alphanumérique de la table gen_menu
    $requete =  'SELECT gm_id_menu '.
                'FROM gen_menu '.
                'WHERE gm_id_menu <> '.$id_menu.' ';
    
    // Complément de requête en fonction du type de code
    if ($type == 'int') {
        $requete .= 'AND gm_code_num = '.$code;
    } else {
        $requete .= 'AND gm_code_alpha = "'.$code.'"';
    }
    $resultat = $db->query($requete);
    if (DB::isError($resultat)) {
            die( BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete) );
    }
    $nombre_reponse = $resultat->numRows();
    if ($nombre_reponse >= 1) {
        return true;
    } else {
        return false;
    }
}
 
/* +--Fin du code ---------------------------------------------------------------------------------------+
* $Log: not supported by cvs2svn $
* Revision 1.11  2004/12/06 19:49:35  jpm
* Ajout d'une fonction permettant de récupérer le contenu d'un menu.
*
* Revision 1.10  2004/12/06 17:53:55  jpm
* Ajout fonction GEN_retournerMenus().
*
* Revision 1.9  2004/11/29 18:34:42  jpm
* Correction bogue.
*
* Revision 1.8  2004/11/10 17:25:51  jpm
* Modification de fonction suite à des bogues.
*
* Revision 1.7  2004/11/09 17:55:26  jpm
* Suppresion de fonctions inutiles et mise en conformité.
*
* Revision 1.6  2004/11/08 17:39:32  jpm
* Suppression d'une fonction inutile.
* GEN_etreFils() n'est pas utile. On peut utiliser GEN_etreAncetre() à la place.
*
* Revision 1.5  2004/11/04 12:51:45  jpm
* Suppression de message de débogage.
*
* Revision 1.4  2004/11/04 12:23:50  jpm
* Nouvelles fonctions sur les menus frères.
*
* Revision 1.3  2004/10/25 14:16:21  jpm
* Suppression de code commenté.
*
* Revision 1.2  2004/10/21 18:15:21  jpm
* Ajout de gestion d'erreur aux fonctions.
*
* Revision 1.1  2004/06/15 15:11:37  jpm
* Changement de nom et d'arborescence de Genesia en Papyrus.
*
* Revision 1.43  2004/05/05 06:13:27  jpm
* Extraction de la fonction générant le "vous êtes ici", transformée en applette.
*
* Revision 1.42  2004/05/04 16:24:06  jpm
* Amélioration de la fonction générant le "vous êtes ici".
*
* Revision 1.41  2004/05/04 16:17:31  jpm
* Ajout de la fonction générant le "vous êtes ici".
*
* Revision 1.40  2004/05/03 11:18:17  jpm
* Normalisation de deux fonctions issues du fichier fontctions.php.
*
* Revision 1.39  2004/05/01 16:17:11  jpm
* Suppression des fonctions liées à la création des listes de menu. Elles ont été transformées en applette.
*
* Revision 1.38  2004/05/01 11:43:16  jpm
* Suppression des fonction GEN_afficherMenuCommun() et GEN_afficherSelecteurSites() transformées en applette.
*
* Revision 1.37  2004/04/30 16:18:41  jpm
* Correction d'un bogue dans les fonctions de gestion des scripts.
*
* Revision 1.36  2004/04/28 12:04:40  jpm
* Changement du modèle de la base de données.
*
* Revision 1.35  2004/04/09 16:23:41  jpm
* Prise en compte des tables i18n.
*
* Revision 1.34  2004/04/02 16:34:44  jpm
* Extraction de variable globale des fonction, remplacé par un passage en paramètre.
*
* Revision 1.33  2004/04/01 11:24:51  jpm
* Ajout et modification de commentaires pour PhpDocumentor.
*
* Revision 1.32  2004/03/31 16:52:30  jpm
* Modification du code vis à vis du modèle revision 1.9 de Génésia.
*
* Revision 1.31  2004/03/29 17:13:05  jpm
* Suppression de fonction, passer en code classique.
*
* Revision 1.30  2004/03/27 11:11:58  jpm
* Début changement nom de variable dans fonction creerInfoPageEtApplication().
*
* Revision 1.29  2004/03/26 12:52:25  jpm
* Ajout des fonctions creerInfoPageEtApplication() et donnerIdPremiereApplicationLiee().
*
* +-- Fin du code ----------------------------------------------------------------------------------------+
*/
?>
Subversion Repositories Applications.papyrus

(root)/trunk/papyrus/bibliotheque/fonctions/pap_menu.fonct.php – Rev 216 → 285
