Création d’un module « les départements français » pour Joomla 1.5

Création d’un module « les départements français » pour Joomla 1.5. Tutoriel 2.

Dans ce tutorial nous allons afficher le contenu d’une table de donnée. Avec phpmyadmin (par exemple) se positionner sur la base de données de joomla et exécuter le script suivant

CREATE TABLE `jos_dept` (
  `dept_num` char(3) NOT NULL default ’0’,
  `dept_lib` varchar(50) default NULL,
  `info` varchar(255) default NULL,
  PRIMARY KEY  (`dept_num`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 ;
INSERT INTO `jos_dept` (`dept_num`, `dept_lib`, `info`) VALUES 
(’01’, ’AIN’, NULL),
(’02’, ’AISNE’, NULL),
(’03’, ’ALLIER’, NULL),
(’04’, ’ALPES-DE-HAUTE-PROVENCE’, NULL),
(’05’, ’HAUTES-ALPES’, NULL),
(’06’, ’ALPES-MARITIMES’, NULL),
(’07’, ’ARDECHE’, NULL)

Créer un repertoire de développement qui contiendra les fichiers du module.

Dans le répertoire créer un fichier mod_dept.php /**
 * Point d'entrée du module
 * 
 * @license        GNU/GPL
 *
 * 
 */

// pas d'accès direct au module
defined( '_JEXEC' ) or die( 'Accès interdit' );

echo JText::_('Liste des départements français');

// référence vers la base de donnée
$db = & JFactory::getDBO() ;

// requête SQL
// #_ sera remplacé par le préfixe d'installation des tables
// dans notre cas ce sera jos_ (préfixe par défault)
$sql = "SELECT * FROM #__dept";

// exécution de la requête
$db->setQuery($sql);




//chargement du résultat de la requête dans un tableau
$departements = $db->loadObjectList();

echo '';
echo 'LibelléCode';
foreach ( $departements as $departement ) // parcourir le tableau
{   
     echo ''.$departement->dept_lib .'' .$departement->dept_num .''  ;
}  
echo '';


// explorons la base de données
// retourne le nombre d'enregistrements de la  requête SQL
$num = $db->getNumRows( $db->query() );
echo "
 - ".$num ." départements
";

// retourne le premier enregistrement sous forme de tableau
$dept_1 =  $db->loadRow() ;
echo "

";

echo print_r($dept_1) ;

echo "

";

// test si la base de donnée est disponible
echo  $db->test() ;

//retourne le prefixe des tables joomla
echo  '
 préfixe des tables : '.$db->getPrefix() ;

//retourne la dernière requête SQL 
echo '
'.$db->getQuery() ;
?>

Créer un fichier XML mod_dept.xml qui contiendra les différente information sur le module





        Les départements français
        Laurent Deschaumes
        Mars 2008
        </copyright>
        http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL
        ldeschaumes at free.fr
       
        1.5.0
        Module departement francais
         
       mod_dept.php
   




Zipper ces 2 fichiers (ex : mod_dept.zip)

Connectez vous en administration selectionnez le menu Extensions>Installer/Desinstaller/Installation et selectionnez le fichier zip crée précédemment (suivant l’endroit ou il se trouve en local sur votre disque dur ou son URL)

Si tout se passe bien vous devez avoir un message du style « Installateur Module Succès ».

Pour activer le module selectionner le menu Extention/Gestion des modules et activez le module (coche verte) et verifiez son appartition sur le site(par défaut il apparaît dans le bandeau de gauche), essayez les différents positionnement du module avec la liste déroulante( Menu Extensions>Gestion des modules ) du module « Les départements français ».

Dans cet exemple nous nous sommes servi de quelques objet de l’API de joomla notamment de l’objet JDatabase , en vous servant de ce tutoriel explorez toutes ses méthodes à cette adresse http://api.joomla.org/Joomla-Framework/Database/JDatabaseMySQL.html#loadRowList