Subversion Repositories Applications.projet

<?php

// +------------------------------------------------------------------------------------------------------+

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

// | General Public License for more details.                                                             |

// |                                                                                                      |

// | You should have received a copy of the GNU 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: participe.class.php,v 1.7 2008-09-16 14:11:31 alexandre_tb Exp $

/**

* Application projet

*

* La classe partiicpe assure la jointure entre projet et Auth

* Elle se base sur la table projet_statut_utilisateur

*

*@package projet

//Auteur original :

*@author        Alexandre Granier <alexandre@tela-botanica.org>

//Autres auteurs :

*@author        Aucun

*@copyright     Tela-Botanica 2000-2004

*@version       $Revision: 1.7 $

// +------------------------------------------------------------------------------------------------------+

*/

// +------------------------------------------------------------------------------------------------------+

// |                                            ENTETE du PROGRAMME                                       |

// +------------------------------------------------------------------------------------------------------+

/**

 * class participe

 * 

 */

class participe

{

    /*** Attributes: ***/

    /**

     * Date d'inscription au projet de l'utilisateur.

     * @access private

     */

    var $_date_inscription;

    /**

     * Statut de l'utilisateur, un entier.

     * @access private

     */

    var $_statut;

    /**

     * Connexion à la base de donnée.

     * @access private

     */

    var $_db;

    /**

     * Constructeur. Nécessite un objet DB valide connecté à la base contenant les

     * tables projets.

     *

     * @param DB objetDB Un objet PEAR:DB valide.

     * @return void

     * @access public

     */

    function participe( &$objetDB )

    {

        $this->_db = $objetDB ;

    } // end of member function participe

    /**

     * Renvoie la liste des inscrit à un projet avec leur statut.

     *

     * @return Array

     * @access public

     */

    function getInscrits($id_projet, $droits )

    {

        $tableau_resultat = array() ;

        $requete = 'select psu_id_utilisateur,'.PROJET_CHAMPS_NOM.','.PROJET_CHAMPS_PRENOM.',' ;

        $requete .= PROJET_CHAMPS_MAIL.', ' ;

        $requete .= 'psu_date_inscription,  ps_id_statut '.

                    ' from projet_statut_utilisateurs, projet_statut,'.PROJET_ANNUAIRE.

                    ' where psu_id_projet='.$this->_db->escapeSimple($id_projet).' and psu_id_utilisateur='.PROJET_CHAMPS_ID.

                    ' and psu_id_statut=ps_id_statut order by ps_id_statut,'.PROJET_CHAMPS_NOM;

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError($resultat)) {

            die ("Echec de la requete<br />".$resultat->getMessage()."<br />".$resultat->getDebugInfo()) ;

        }

        while ($ligne = $resultat->fetchRow(DB_FETCHMODE_ORDERED)) {

            array_push ($tableau_resultat, $ligne) ;

            $id = $ligne[0];

            $inscrits[$id]['nom'] = $ligne[1];

            $inscrits[$id]['prenom'] = $ligne[2];

            $inscrits[$id]['mail'] = $ligne[3];

            $inscrits[$id]['date'] = $ligne[4];

            $inscrits[$id]['id_statut'] = $ligne[5]; 

        }

        $resultat->free() ;

        return $tableau_resultat ;

    } // end of member function getInscrits

    /**

     * Renvoie un tableau contenant la liste des identifiants des projets et des statuts

     * d'un inscrit. 0 => ['psu_id_utilisateur']          ['psu_id_statut'] 1 => ...

     *

     * @param int id_utilisateur Un identifiant d'utilisateur pour le champs

     * projet_statut_utilisateurs:psu_id_utilisateur

     * @return Array

     * @access public

     */

    function getIdProjetsStatuts( $id_utilisateur )

    {

        $tableau_resultat = array() ;

        $requete = "select psu_id_utilisateur, psu_id_statut from projet_statut_utilisateurs".

                    " where psu_id_utilisateur=".$this->_db->escapeSimple($id_utilisateur) ;

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError($resultat)) {

            die ("Echec de la requete<br />".$resultat->getMessage()."<br />".$resultat->getDebugInfo()) ;

        }

        while ($ligne = $resultat->fetchRow(DB_FETCHMODE_ASSOC)) {

            array_push ($tableau_resultat, $ligne) ;

        }

        $resultat->free() ;

        return $tableau_resultat ;

    } // end of member function getIdProjetsStatuts

    /**

     * Renvoie un tableau à 2 dimensions avec les informations sur l'inscription aux

     * différents projets d'un utilisateur. 0 => ['p_titre']         Le titre du projet 

     *         ['ps_label']    Le statut de l'utilisateur 1 => .... (autant que de

     * projets)

     *

     * @param int id_utilisateur L'identifiant d'un utilisateur.

     * @return Array

     * @access public

     */

    function getInformationsUtilisateurs( $id_utilisateur )

    {

        $tableau_resultat = array() ;

        $requete = "select p_titre, ps_statut_nom, psu_id_statut, psu_id_projet from projet_statut_utilisateurs, projet, projet_statut".

                    " where psu_id_utilisateur=".$this->_db->escapeSimple($id_utilisateur).

                    " and psu_id_projet = p_id and psu_id_statut = ps_id_statut" ;

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError($resultat)) {

            die ("Echec de la requete<br />".$resultat->getMessage()."<br />".$resultat->getDebugInfo()) ;

        }

        while ($ligne = $resultat->fetchRow()) {

            array_push ($tableau_resultat, $ligne) ;

        }

        $resultat->free() ;

        return $tableau_resultat ;

    } // end of member function getInformationsUtilisateurs

    /**

     * Renvoie le statut du projet passé en paramètre.

     *

     * @param int id_utilisateur 

     * @param int id_projet 

     * @param int dbObject 

     * @return int

     * @static

     * @access public

     */

    function getStatutSurProjetCourant( $id_utilisateur,  $id_projet,  &$dbObject )

    {

        if (participe::isAdministrateur($id_utilisateur, $dbObject)) return PROJET_DROIT_ADMINISTRATEUR;

        $requete = 'select psu_id_statut from projet_statut_utilisateurs'.

                    ' where psu_id_utilisateur='.$this->_db->escapeSimple($id_utilisateur).' and psu_id_projet ='.$this->_db->escapeSimple($id_projet) ;

        $resultat = $dbObject->query ($requete) ;

        if (DB::isError ($resultat)) {

            return DB::raiseError('Echec de la requete : '.$requete.'<br />'.$resultat->getMessage()) ;

        }

        $ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT) ;

        if (!$resultat->numRows()) {

            return 4 ;      // Le statut ne participe pas

        }

        return $ligne->psu_id_statut ;

    } // end of member function getStatutSurProjetCourant

    /**

     * Réalise une requête dans projet_statut_utilisateurs et renvoie true si l'utilisateur

     * est administrateur de l'application projet.

     *

     * @param int id_utilisateur L'identifiant d'un utilisateur.

     * @param DB objetDB Un objet PEAR::DB

     * @return bool

     * @access public

     */

    function isAdministrateur( $id_utilisateur, $objetDB = "" )

    {

        // La table projet_statut_utilisateurs possède une entré avec psu_id_projet = 0

        // pour indiquer un administrateur

        $requete = "select psu_id_statut from projet_statut_utilisateurs where psu_id_utilisateur=".$this->_db->escapeSimple($id_utilisateur)." ".

                    " and psu_id_projet=0" ;

        if (is_object ($objetDB)) {

            $resultat = $objetDB->query ($requete) ;

        } else {

            $resultat = $this->_db->query ($requete) ;

        }

        if ($resultat->numRows () != 0) {

            return true;

        }

        return false ;

    } // end of member function isAdministrateur

    /**

     * Met à jour le statut d'un utilisateur sur un projet

     *

     * @param int id_statut L'identifiant du statut à ajouter ou mettre à jour

     * @param int id_utilisateur Identifiant de l'utilisateur

     * @param int id_projet Identifiant du projet

     * @return bool

     * @access public

     */

    function setStatut( $id_statut,  $id_utilisateur,  $id_projet )

    {    	

        $requete = 'update projet_statut_utilisateurs set psu_id_statut='.$this->_db->escapeSimple($id_statut).

                    ' where psu_id_utilisateur='.$this->_db->escapeSimple($id_utilisateur).' and psu_id_projet='.$this->_db->escapeSimple($id_projet);

        if (participe::getStatutSurProjetCourant($id_utilisateur, $id_projet, $this->_db) == 4) {

            $requete = 'insert into projet_statut_utilisateurs set psu_id_statut='.$this->_db->escapeSimple($id_statut).

                    ', psu_id_utilisateur='.$this->_db->escapeSimple($id_utilisateur).',psu_id_projet='.$this->_db->escapeSimple($id_projet).

                    ', psu_date_inscription=NOW()';

        }

        if ($id_statut == 4) {  // Si le statut est ne participe pas, on supprime l'inscrit

            $requete = 'delete from projet_statut_utilisateurs where psu_id_utilisateur='.$this->_db->escapeSimple($id_utilisateur).

            			' and psu_id_projet='.$this->_db->escapeSimple($id_projet) ;

        }

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError ($resultat)) {

            die ('Echec de la requete : '.$requete.'<br />'.$resultat->getMessage()) ;

        }

        return true ;

    } // end of member function setStatut

    /**

     * Renvoie vrai si l'utilisateur est coordinateur, faux dans les autres cas

     *

     * @param int id_utilisateur L'identifiant d'un utilisateur

     * @param DB objetDB Optionnel, nécessaire si on appelle cette méthode statiquement

     * @return bool

     * @static

     * @access public

     */

    function isCoordinateur( $id_utilisateur, $id_projet, &$objetDB )

    {

        if (!is_object($objetDB)) $objetDB = $this->_db;

        $statut = $this->getStatutSurProjetCourant($id_utilisateur,  $id_projet, $objetDB) ;

        if ($statut == 1) {

            return true;

        }

        return false ;

    } // end of member function isCoordinateur

    /**

     * Renvoie la liste des projets auquels l'utilisateur passé en paramètre ne

     * participe pas.

     *

     * @param int id_utilisateur L'identifiant de l'utilisateur.

     * @return Array

     * @access public

     */

    function getProjetsNonParticipant( $id_utilisateur )

    {

        $tableau_resultat = array() ;

        $requete = 'select p_id from projet'.

                    ' where p_id not in (select psu_id_projet from projet_statut_utilisateurs where psu_id_utilisateur='.$this->_db->escapeSimple($id_utilisateur).')' ;

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError($resultat)) {

            die ("Echec de la requete<br />".$resultat->getMessage()."<br />".$resultat->getDebugInfo()) ;

        }

        while ($ligne = $resultat->fetchRow(DB_FETCHMODE_OBJECT)) {

            array_push ($tableau_resultat, new projet ($this->_db, $ligne->p_id)) ;

        }

        $resultat->free() ;

        return $tableau_resultat ;

    } // end of member function getProjetsNonParticipant

    /**

     * Renvoie true si l'utilisateur passé en paramètre est observateur du projet passé

     * en paramètre.

     *

     * @param int id_utilisateur L'identifiant de l'utilisateur

     * @param int id_projet L'identifiant du projet

     * @return bool

     * @access public

     */

    function isObservateur( $id_utilisateur,  $id_projet, &$objetDB )

    {

        if (!is_object($objetDB)) $objetDB = $this->_db;

        if ($this->getStatutSurProjetCourant($id_utilisateur, $id_projet, $objetDB) == 3) {

            return true;

        }

        return false ;

    } // end of member function isObservateur

    /**

     * Renvoie true si l'utilisateur passé en paramètre est contributeur du projet passé

     * en paramètre.

     *

     * @param int id_utilisateur L'identifiant de l'utilisateur

     * @param int id_projet L'identifiant du projet

     * @return bool

     * @access public

     */

    function isContributeur( $id_utilisateur,  $id_projet, &$objetDB )

    {

        if (!is_object($objetDB)) $objetDB = $this->_db;

        if ($this->getStatutSurProjetCourant($id_utilisateur, $id_projet, $objetDB) == 4) return false; 

        if ($this->getStatutSurProjetCourant($id_utilisateur, $id_projet, $objetDB) == 2) {

            return true;

        }

        return false ;

    } // end of member function isObservateur

    /**

     * Renvoie true si l'utilisateur passé en paramètre est contributeur du projet passé

     * en paramètre.

     *

     * @param int id_utilisateur L'identifiant de l'utilisateur

     * @param int id_projet L'identifiant du projet

     * @return bool

     * @access public

     */

    function isEnAttente( $id_utilisateur,  $id_projet, &$objetDB )

    {

        if ($this->getStatutSurProjetCourant($id_utilisateur, $id_projet, $objetDB) == 3) {

            return true;

        }

        return false ;

    } // end of member function isObservateur

	/**

     * Renvoie les infos sur les coordinateurs d'un projet

     *

     * @param int id_projet L'identifiant du projet

     * @return array	Un tableau contenant les infos concernants les coordinateurs du projet

     * @access public

     */

    function getCoordinateurs($id_projet)

    {

        $tableau_resultat = array() ;

        $requete = 'select psu_id_utilisateur,'.PROJET_CHAMPS_NOM.','.PROJET_CHAMPS_PRENOM.',' ;

        $requete .= PROJET_CHAMPS_MAIL.', ' ;

        $requete .= 'psu_date_inscription,  ps_id_statut '.

                    ' from projet_statut_utilisateurs, projet_statut,'.PROJET_ANNUAIRE.

                    ' where psu_id_projet='.$this->_db->escapeSimple($id_projet).' and psu_id_utilisateur='.PROJET_CHAMPS_ID.

                    ' and psu_id_statut=ps_id_statut and psu_id_statut=1 order by ps_id_statut,'.PROJET_CHAMPS_NOM;

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError($resultat)) {

            return ("Echec de la requete<br />".$resultat->getMessage()."<br />".$resultat->getDebugInfo()) ;

        }

        while ($ligne = $resultat->fetchRow(DB_FETCHMODE_ORDERED)) {

            array_push ($tableau_resultat, $ligne) ;

        }

        $resultat->free() ;

        return $tableau_resultat ;

    } // end of member function getCoordinateurs

    function getAdministrateurs () {

    	$tableau_resultat = array() ;

    	$requete = 'select psu_id_utilisateur,'.PROJET_CHAMPS_NOM.','.PROJET_CHAMPS_PRENOM.',' ;

        $requete .= PROJET_CHAMPS_MAIL.', ' ;

        $requete .= 'psu_date_inscription,  ps_id_statut '.

                    ' from projet_statut_utilisateurs, projet_statut,'.PROJET_ANNUAIRE.

                    ' where psu_id_utilisateur='.PROJET_CHAMPS_ID.

                    ' and psu_id_statut=ps_id_statut and psu_id_statut=0 order by ps_id_statut,'.PROJET_CHAMPS_NOM;

        $resultat = $this->_db->query ($requete) ;

        if (DB::isError($resultat)) {

            die ("Echec de la requete<br />".$resultat->getMessage()."<br />".$resultat->getDebugInfo()) ;

        }

        while ($ligne = $resultat->fetchRow(DB_FETCHMODE_ORDERED)) {

            array_push ($tableau_resultat, $ligne) ;

        }

        $resultat->free() ;

        return $tableau_resultat ;

    }

    /** 

     * Renvoie la constante de statut d un utilisateur

     * 

     * define ('PROJET_DROIT_ADMINISTRATEUR', 1) ;

	 * define ('PROJET_DROIT_COORDINATEUR', 2) ;

	 * define ('PROJET_DROIT_PROPRIETAIRE', 4) ;

	 * define ('PROJET_DROIT_CONTRIBUTEUR', 8) ;

	 * define ('PROJET_DROIT_AUCUN', 16) ;

	 * define ('PROJET_DROIT_EN_ATTENTE', 32);

	 * 

	 * @access	public

	 * @return int	La constante de statut

     */

     function getStatut($id_utilisateur, $id_projet)

     {

     	$statut = $this->getStatutSurProjetCourant($id_utilisateur, $id_projet, $this->_db);

     	switch ($statut) 

     	{

     		case 0 : return PROJET_DROIT_ADMINISTRATEUR;

     		break;

     		case 1 : return PROJET_DROIT_COORDINATEUR;

     		break;

     		case 2 : return PROJET_DROIT_CONTRIBUTEUR;

     		break;

     		case 3 : return PROJET_DROIT_EN_ATTENTE;

     		break;

     		default : return PROJET_DROIT_AUCUN;

     	}

     }

} // end of participe

?>