Subversion Repositories Applications.papyrus

Compare Revisions

Ignore whitespace Rev 1127 → Rev 1974

/branches/v1.0-menes/papyrus/bibliotheque/classes/pap_url.class.php
New file
0,0 → 1,415
<?php
/*vim: set expandtab tabstop=4 shiftwidth=4: */
// +------------------------------------------------------------------------------------------------------+
// | PHP version 4.1 |
// +------------------------------------------------------------------------------------------------------+
// | Copyright (C) 2005 Tela Botanica (accueil@tela-botanica.org) |
// +------------------------------------------------------------------------------------------------------+
// | This file is part of Papyrus. |
// | |
// | Foobar 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 of the License, or |
// | (at your option) any later version. |
// | |
// | Foobar 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 Foobar; if not, write to the Free Software |
// | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
// +------------------------------------------------------------------------------------------------------+
// CVS : $Id: pap_url.class.php,v 1.4.2.1 2006-12-08 20:07:43 jp_milcent Exp $
/**
* Classe de gestion des url de Papyrus
*
* Permet de gérer la réecriture des url.
*
*@package Papyrus
*@subpackage Classes
//Auteur original :
*@author Jean-Pascal MILCENT <jpm@tela-botanica.org>
//Autres auteurs :
*@author Aucun
*@copyright Tela-Botanica 2000-2004
*@version $Revision: 1.4.2.1 $ $Date: 2006-12-08 20:07:43 $
// +------------------------------------------------------------------------------------------------------+
*/
 
// +------------------------------------------------------------------------------------------------------+
// | ENTETE du PROGRAMME |
// +------------------------------------------------------------------------------------------------------+
 
 
 
// +------------------------------------------------------------------------------------------------------+
// | CORPS du PROGRAMME |
// +------------------------------------------------------------------------------------------------------+
class Pap_URL extends Net_URL {
/** Identifiant du menu
*
* @var integer
*/
var $id;
/** Chaine contenant le permalien.
*
* @var string
*/
var $permalien = '';
/** Booléen indiquant si on affiche ou pas un permalien.
*
* @var boolean
*/
var $permalien_bool;
/** Chaine indiquant le type d'url.
*
* @var string
*/
var $url_type = 'MENU';
/** Code numérique du menu courant
*
* @var integer
*/
var $code_num;
/** Code alphanumérique du menu courant
*
* @var string
*/
var $code_alpha;
/**
* PHP4 Constructeur
*
* @see __construct()
*/
function Pap_URL($url = null, $useBrackets = true)
{
$this->__construct($url, $useBrackets);
// Gestion de la réecriture d'url
if (defined('PAP_URL_REECRITURE') AND PAP_URL_REECRITURE == '1') {
$this->setPermalienBool(true);
}
}
/** Méthode setId() - Définit l'id du menu courant
*
* @param integer l'identifiant du menu courant.
* @return mixed false en cas d'erreur
* @access public
*/
function setId($id)
{
// Nous transformons en entier l'identifiant
settype($id, "integer");
// Nous vérifions que l'identifiant est bien un entier
if (is_integer($id)) {
$this->id = $id;
} else {
return false;
}
}
/** Méthode getId() - Retourne l'id du menu courant
*
* @return integer l'identifiant du menu courant.
* @access public
*/
function getId()
{
return $this->id;
}
/** Méthode setPermalien() - Définit le permaliens
*
* @param string valeur
* @return mixed false en cas d'erreur
* @access public
*/
function setPermalien($chaine = '')
{
// Nous vérifions que l'identifiant est bien un entier
if (is_string($chaine) && $chaine != '') {
if ($this->permalien != '') {
$this->permalien .= PAP_URL_REECRITURE_SEP;
} else {
$this->permalien = constant('PAP_URL_REECRITURE_'.$this->getUrlType()).PAP_URL_REECRITURE_SEP;
}
$this->permalien .= $chaine;
} else if ($chaine == '') {
$this->permalien = '';
} else {
return false;
}
}
/** Méthode getPermalien() - Retourne le permalien
*
* @return string le permalien
* @access public
*/
function getPermalien()
{
return $this->permalien;
}
/** Méthode setUrlType() - Définit le type d'URL
*
* @param string type d'URL (SITE ou MENU)
* @return mixed false en cas d'erreur
* @access public
*/
function setUrlType($type)
{
// Nous vérifions que l'identifiant est bien un entier
if (is_string($type) && ($type == 'MENU' || $type == 'SITE')) {
$this->url_type = $type;
} else {
return false;
}
}
/** Méthode getUrlType() - Retourne le type de l'URL
*
* @return string le type d'URL
* @access public
*/
function getUrlType()
{
return $this->url_type;
}
/** Méthode setPermalienBool() - Définit le type d'utilisation des permaliens
*
* @param boolean true ou false
* @return mixed false en cas d'erreur
* @access public
*/
function setPermalienBool($bool)
{
// Nous vérifions que l'identifiant est bien un entier
if (is_bool($bool)) {
$this->permalien_bool = $bool;
} else {
return false;
}
}
/** Méthode getPermalienBool() - Retourne booléen indiquant si on utilise ou pas les permaliens
*
* @return boolean true ou false
* @access public
*/
function getPermalienBool()
{
return $this->permalien_bool;
}
/** Méthode setCodeAlpha() - Définit le code alphanumérique de l'url
*
* @param string le code alphanumérique pour l'url du menu
* @return mixed false en cas d'erreur
* @access public
*/
function setCodeAlpha($code_alpha)
{
if (is_string($code_alpha)) {
$this->code_alpha = $code_alpha;
} else {
return false;
}
}
/** Méthode getCodeNum() - Retourne le code numérique de l'url
*
* @return string le code numérique pour l'url du menu
* @access public
*/
function getCodeNum()
{
return $this->code_num;
}
/** Méthode setCodeNum() - Définit le code numérique de l'url
*
* @param string le code numérique pour l'url du menu
* @return mixed false en cas d'erreur
* @access public
*/
function setCodeNum($code_num)
{
if (is_integer($code_num)) {
$this->code_num = $code_num;
} else {
return false;
}
}
/** Méthode getCodeAlpha() - Retourne le code alphanumérique de l'url
*
* @return string le code alphanumérique pour l'url du menu
* @access public
*/
function getCodeAlpha()
{
return $this->code_alpha;
}
/**
* Méthode getURL() - Retourne l'url
*
* @return string l'url complète.
* @access public
*/
function getURL()
{
// Identifiant de la langue choisie
if ( (isset($GLOBALS['_GEN_commun']['i18n'])) && (!empty($GLOBALS['_GEN_commun']['i18n'])) ) {
if ($GLOBALS['_GEN_commun']['i18n'] != GEN_I18N_ID_DEFAUT) {
$this->addQueryString(GEN_URL_CLE_I18N, $GLOBALS['_GEN_commun']['i18n']);
}
}
// Nous regardons si un id de menu existe
if ($this->getId() != '') {
// Préparation des noms des champs des codes pour le site et le menu
$champs_code_site = (GEN_URL_ID_TYPE_SITE == 'int') ? 'gs_code_num' : 'gs_code_alpha';
$champs_code_menu = (GEN_URL_ID_TYPE_MENU == 'int') ? 'gm_code_num' : 'gm_code_alpha';
if ($this->getUrlType() == 'MENU') {
// Récupération du nom de l'entrée du menu à afficher
$requete = 'SELECT gm_code_alpha, gm_code_num, gm_ce_i18n, gm_ce_site '.
'FROM gen_menu '.
'WHERE gm_id_menu = '.$this->id.' ';
$resultat = $GLOBALS['_GEN_commun']['pear_db']->query($requete);
(DB::isError($resultat)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat->getMessage(), $requete)) : '';
$ligne = $resultat->fetchRow(DB_FETCHMODE_ASSOC);
$resultat->free();
// Nous vérifions si nous avons à faire à un menu commun ou pas
if ($ligne['gm_ce_site'] != 0) {
// Récupération des infos sur le site
$bln_url_site = false;
$requete_site = 'SELECT gs_code_alpha, gs_code_num '.
'FROM gen_site '.
'WHERE gs_id_site = '.$ligne['gm_ce_site'].' ';
$resultat_site = $GLOBALS['_GEN_commun']['pear_db']->query($requete_site);
(DB::isError($resultat_site)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat_site->getMessage(), $requete_site)) : '';
$ligne_site = $resultat_site->fetchRow(DB_FETCHMODE_ASSOC);
$resultat_site->free();
} else {
// Menu commun
$bln_url_site = true;
$ligne_site[$champs_code_site] = $GLOBALS['_GEN_commun']['info_site']->$champs_code_site;
}
$this->addQueryString(GEN_URL_CLE_MENU, $ligne[$champs_code_menu]);
$this->setCodeAlpha($ligne['gm_code_alpha']);
$this->setCodeNum($ligne['gm_code_num']);
} else if ($this->getUrlType() == 'SITE') {
$bln_url_site = true;
$requete_site = 'SELECT gs_code_alpha, gs_code_num '.
'FROM gen_site '.
'WHERE gs_id_site = '.$this->getId().' ';
$resultat_site = $GLOBALS['_GEN_commun']['pear_db']->query($requete_site);
(DB::isError($resultat_site)) ? die(BOG_afficherErreurSql(__FILE__, __LINE__, $resultat_site->getMessage(), $requete_site)) : '';
$ligne_site = $resultat_site->fetchRow(DB_FETCHMODE_ASSOC);
$resultat_site->free();
$this->setCodeAlpha($ligne_site['gs_code_alpha']);
$this->setCodeNum($ligne_site['gs_code_num']);
// Suppression de l'éventuel identifiant de menu passé dans l'url...
$this->removeQueryString(GEN_URL_CLE_MENU);
} else {
$message = 'ERREUR Papyrus : le type d\'url est inconnu : seul "MENU" et "SITE" existent. <br />'.
'Type : '.$this->getUrlType().' <br />'.
'Ligne n° : '. __LINE__ .'<br />'.
'Fichier : '. __FILE__ ;
trigger_error($message, E_USER_ERROR);
}
// Préparation de l'url de l'entrée
if ($bln_url_site) {
$this->addQueryString(GEN_URL_CLE_SITE, $ligne_site[$champs_code_site]);
}
if ( (isset($GLOBALS['_GEN_commun']['url_i18n'])) && (!empty($GLOBALS['_GEN_commun']['url_i18n'])) ) {
$this->addQueryString(GEN_URL_CLE_I18N, $GLOBALS['_GEN_commun']['url_i18n']);
}
if ( (isset($GLOBALS['_GEN_commun']['url_date'])) && (!empty($GLOBALS['_GEN_commun']['url_date'])) ) {
$this->addQueryString(GEN_URL_CLE_DATE, $GLOBALS['_GEN_commun']['url_date']);
}
if ( (isset($GLOBALS['_GEN_commun']['url_format'])) && (!empty($GLOBALS['_GEN_commun']['url_format'])) ) {
$this->addQueryString(GEN_URL_CLE_FORMAT, $GLOBALS['_GEN_commun']['url_format']);
}
}
// Construction du permalien ou pas
if ($this->getPermalienBool()) {
// Récupération du chemin jusqu'au fichier principal de Papyrus
$this->path = (dirname($this->path) == DIRECTORY_SEPARATOR) ? DIRECTORY_SEPARATOR : dirname($this->path).DIRECTORY_SEPARATOR;
// On vide le permalien construite par les appels à getUrl() avant de le remplir
$this->setPermalien();
if (constant('GEN_URL_RACCOURCI_ID_TYPE_'.$this->getUrlType()) == 'int') {
$this->setPermalien($this->getCodeNum());
} else {
$this->setPermalien($this->getCodeAlpha());
}
$this->removeQueryString(GEN_URL_CLE_SITE);
$this->removeQueryString(GEN_URL_CLE_MENU);
$querystring = $this->getQueryString();
} else {
$querystring = $this->getQueryString();
}
// Construction de l'url
$this->url = $this->protocol . '://'
. $this->user . (!empty($this->pass) ? ':' : '')
. $this->pass . (!empty($this->user) ? '@' : '')
. $this->host . ($this->port == $this->getStandardPort($this->protocol) ? '' : ':' . $this->port)
. $this->path
. $this->getPermalien()
. (!empty($querystring) ? '?' . $querystring : '')
. (!empty($this->anchor) ? '#' . $this->anchor : '');
return $this->url;
}
/** Méthode retournant la valeur d'un paramêtre de l'URL.
*
* @return mixed la valeur du paramêtre demandé ou false
* @access public
*/
function retournerUnParametre($parametre)
{
if (!empty($this->querystring)) {
if (isset($this->querystring[$parametre])) {
return $this->querystring[$parametre];
}
}
return FALSE;
}
 
}
 
// +------------------------------------------------------------------------------------------------------+
// | PIED du PROGRAMME |
// +------------------------------------------------------------------------------------------------------+
 
 
 
/* +--Fin du code ----------------------------------------------------------------------------------------+
*
* $Log: not supported by cvs2svn $
* Revision 1.4 2006/10/11 18:04:11 jp_milcent
* Gestion avancée de la réecriture d'URL.
*
* Revision 1.3 2006/03/02 10:49:49 ddelon
* Fusion branche multilinguisme dans branche principale
*
* Revision 1.2.2.1 2005/12/27 15:56:00 ddelon
* Fusion Head vers multilinguisme (wikini double clic)
*
* Revision 1.2 2005/04/18 16:40:50 jpm
* Modifications pour contrôler les permaliens.
*
* Revision 1.1 2005/04/14 13:56:25 jpm
* Ajout de la classe URL de Papyrus.
*
*
* +-- Fin du code ----------------------------------------------------------------------------------------+
*/
?>