Grâce à ces quelques lignes de codes vous pourrez utiliser pleinement l’API avec notamment les class d’accès à la Base de données, aux informations utilisateurs, aux informations session etc… Bref tout ce qui existe dans Joomla pour vous faciliter la tâche (merci JFactory).

Voici donc le code miraculeux :

// On définie que c'est un fichier familier à Joomla
define('_JEXEC', 1 );

define('JPATH_BASE', '../../../' );

define( 'DS','/' );

// On inclue les constantes
require_once ( JPATH_BASE.DS.'includes'.DS.'defines.php' );
// On inclue le framework
require_once ( JPATH_BASE.DS.'includes'.DS.'framework.php' );

// On inclue la fameuse class JFactory
require(JPATH_BASE.DS.'libraries/joomla/factory.php');

$mainframe =& JFactory::getApplication('site');
$mainframe->initialise();

Cependant pour la constante JPATH c’est à vous de trouver le bon chemin par rapport à là où vous exécutez votre fichier (dans mon cas je suis dans dossier comme ça : modules/mod_mon_module/dossier/mon_fichier.php)

Voilà j’espère que ça vous aura aidé autant que pour moi.

Aujourd’hui nous allons donc voir comment utiliser le framework de Joomla! 1.5. Je ne vais pas me lancer dans un étalage complet du framework mais plutôt du strict minimum, indispensable pour hacker, ou même créer des modules ou composants.

1. Se connecter à la base de données

Rien de plus simple, il faut créer une instance de la class JFactory :

$database = &JFactory::getDBO();

2. Exécuter une requête (insertion de données dans la base)

Maintenant que nous avons notre objet $database il suffit d’appeler la méthode setQuery pour déterminer la requête à éxécuter :

//j'insère dans la table users et dans le champ username, le pseudo TOTO.
$database->setQuery("INSERT INTO #__users (`username`) VALUES ('TOTO')");

#__users est en fait jos_users dans ma base de données, mais Joomla! reconnait #__ comme étant le préfixe de vos tables (le mien est jos, mais le votre peut être différent, cela permet donc à Joomla! de s’adapter quelque soit le préfixe de vos tables).

Puis on éxécute la requête :

$database->query();

3. Exécuter une requête (sélection de données dans la base)

C’est bien beau d’insérer des données dans la base, mais il est parfois utile de récupérer des données, c’est très simple encore une fois, toujours avec le même objet, il suffit d’appeler la méthode setQuery encore une fois (cette fois je met la requête dans une variable, que j’appelle dans la méthode setQuery :

$query = "SELECT username FROM #__user WHERE id=1"; //Je sélectionne
le pseudo où le champs id vaut 1
$database->setQuery($query); //J'exécute la requête

Ensuite on traite les données récupérées pour en faire quelque chose (par exemple dans ce cas précis, les afficher) :

echo $database->LoadResult(); //Ce qui écrira toto si
l'utilisateur avec l'id 1 dans ma base s'appelle toto

Par contre si vous faites une requête qui renvoie plusieurs résultats vous devez appeler la méthode loadObjectList :

$query = "SELECT * FROM #__categories"; //On prépare la requête
$database->setQuery($query); //On éxécute la requête
$rows = $database->loadObjectList(); //On charge les
résultats de la requête dans l'objet $rows 

foreach ($rows as $row) {

echo $row->title ." : ". $row->description."<br />"; //On affiche le
titre de chaque catégorie et sa description

}

Et voilà vous avez les cartes en main pour effectuer des choses simples dans Joomla! 1.5 en utilisant son Framework et donc en limitant les failles de sécurités.

Pour toutes questions ça se passe à la suite de l’article dans les commentaires.

Enjoy !

Nous allons aborder un thème très utile lorsque vous souhaitez créer des modules ou composants ou même plugins dans Joomla! 1.5. Il s’agit de travailler avec les données liées à la session de l’utilisateur connecté sur votre site. Ainsi vous pourrez effectuer des scripts en fonction du statut de l’utilisateur (registered,redactor etc…) ou encore affiché simplement son pseudo, son nom, son adresse mail etc.

Pour commencer vous devez créer une instance de la class JFactory en appelant la méthode getUser(), comme suit :

$UserInfo =& JFactory::getUser();

Ensuite vous n’avez plus qu’à utiliser cet objet pour ressortir chacune des informations qui vous intéressent :

echo $UserInfo->id; //Affichera l'id de l'utilisateur
echo $UserInfo->name; //Affichera le nom de l'utilisateur
echo $UserInfo->username; //Affichera le pseudo de
l'utilisateur
echo $UserInfo->email //Affichera son addresse e-mail
echo $UserInfo->password //Le mot de passe crypté de
l'utilisateur
echo $UserInfo->usertype //Permet de connaitre le
statut de l'utilisateur (registered, administrator etc.)
echo $UserInfo->gid //L'id du statut auquel il
appartient (si le statut Administrator est enregistré
avec l'id 1 dans la base de données, alors
echo $UserInfo->gid affichera 1)
echo $UserInfo->registerDate //Affiche la date a
laquelle l'utilisateur s'est enregistré sur le site
echo $UserInfo->lastvisitDate //Affiche la date
de dernière visite de l'utilisateur sur le site
echo $UserInfo->block //Affiche 1 si l'utilisateur
est bloqué (banni du site) ou 0 s'il ne l'est pas
echo $UserInfo->guest //Affiche 1 si l'utilisateur
est un simple visiteur sur le site, 0 s'il est membre.

A partir de la on pourrait imaginer un script qui testerait si l’utilisateur est enregistré sur le site et qui auquel cas afficherait son nom, son pseudo, la date à laquelle il s’est inscrit sur le site et la date de sa dernière visite (le script en entier):

//On créer l'objet $UserInfo
$UserInfo =& JFactory::getUser();

//Si l'utilisateur est enregistré on lui écrit ses informations
if(!$UserInfo->guest)
{

echo "Salut" . $UserInfo->name . " ou plutôt
 " . $UserInfo->username . "<br />";
echo "Tu es membre de ce site depuis le
 " . $UserInfo->registerDate . " et ta
dernière visite date du " . $UserInfo->lastvisitDate;

//Si c'est un simple visiteur on lui demande de s'inscrire
}else{

echo "Vous n'êtes pas autorisé a
voir cette page, veuillez vous inscrire, merci";

}

Et voilà, ce n’est qu’un exemple, vous pouvez faire preuve de plus d’imagination.

Pour toute questions ça se passe à la suite de l’article, merci.