Afficher les x derniers billets de Dotclear en page d'accueil

J'ai récemment appris qu'il y avait des personnes encore plus faignantes que moi dans l'informatique. C'est sûr ça fait plaisir (et ça rassure), mais ça aide pas quand on cherche quelque chose qui a déjà été fait ! Donc voila, je ne sais pas si ça a déjà été codé et documenté quelque part mais si ça peut servir à quelques uns d'entre vous, c'est déjà ça :-)

Pour ceux qui sont pressés

Il suffit de rajouter ce petit bout de code PHP à votre page d'accueil en vérifiant que la troisième ligne contient bien le chemin vers votre fichier de configuration de Dotclear, normalement si tout se passe bien vous pouvez voir ce que ça va donner en consultant la page d'accueil de ce site.

<?php
define('CONF_ONLY','1');
include('./dotclear/conf/config.php');

@ $db = mysql_pconnect(DB_HOST,DB_USER,DB_PASS);
if(!$db) { echo 'Erreur de connexion'; exit; }

mysql_select_db(DB_DBASE);
$query =
' SELECT post_id,post_titre,post_titre_url,post_dt
  FROM '.DB_PREFIX.'post
  ORDER BY post_id DESC LIMIT 5';
$result = mysql_query($query);
$num_results = mysql_num_rows($result);

echo '<ul>';
for($i = 0 ; $i < $num_results ; $i++)
{
  $row = mysql_fetch_array($result);
  $date = explode(' ',$row['post_dt']);
  $date_slash = str_replace('-','/',$date[0]);
  echo '<li><a href="http://www.biologeek.com/dotclear/index.php/'.$date_slash.'/'
    .$row['post_id'].'-'.$row['post_titre_url'].'" title="'
    .$row['post_titre'].'">'.$row['post_titre'].'</a></li>';
}
echo '</ul>';
?>

Bug connu, une erreur du type :

Warning: mysql_num_rows(): supplied argument is not a valid MySQL result resource...

Si vous avez cette erreur c'est très probablement que vous utilisez depuis quelques temps déjà Dotclear et que votre fichier de configuration contient la variable DB_BASE à la place de la variable DB_DBASE, il suffit alors de changer la ligne du précédent script mysql_select_db(DB_DBASE); en mysql_select_db(DB_BASE);

Pour ceux qui veulent comprendre

• La première ligne du script est peut-être la plus mystérieuse pour ceux qui n'ont jamais mis le nez dans le code de Dotclear, elle permet juste de définir CONF_ONLY pour ne pas que le fichier de configuration que l'on appelle à la ligne suivante aille chercher d'autres fichiers qui nous sont inutiles dans le cas présent.
• On essaye ensuite de se connecter à la base en utilisant les informations issues du fichier de configuration en renvoyant un message en cas d'échec, si vous obtenez ce message, c'est probablement dû au fait que vous n'avez pas entré le bon chemin d'accès au fichier de configuration.
• On sélectionne la base de donnée de votre blog et on effectue la requête qui va nous permettre d'afficher le titre des liens et de recomposer l'adresse pour accéder au billet qui lui est associé. C'est à cet endroit que vous pouvez spécifier le nombre de billets à afficher, il suffit de remplacer 5 par votre nombre.
• La liste des billets va être présentée sous forme de liste, il faut dans un premier temps formater la date pour obtenir un adresse correcte et il suffit ensuite d'appeler les bonnes colonnes du tableau renvoyé par la requête à la base de donnée.

Voila pour les bases, vous pouvez maintenant modifier l'affichage à votre convenance en donnant une id à <ul> ou une class aux <li>. Si vous êtes sages la prochaine étape consistera à effectuer une petite jointure pour récupérer la catégorie associée à chaque billet :-).

[HS] : je dois avouer que c'est très déroutant de se replonger dans du PHP après avoir fait du Python, ne serait-ce que pour l'oubli des « ; » , mais aussi par la nécessité de passer par des variables intermédiaires... par exemple pour la date j'avais commencé par faire : str_replace('-','/',explode(' ',$row['post_dt'])[0]); qui a superbement planté :D.

[ edit du 3 mai ] : finalement rajouter les catégories c'est pas très compliqué et ça ne mérite pas un nouveau billet :-)

Associer le nom des catégories aux derniers billets

Il y a deux lignes à changer, la première concerne la requête qui doit effectuer une jointure entre la table post et la table catégorie :

$query =
' SELECT post_id,post_titre,post_titre_url,post_dt
  FROM '.DB_PREFIX.'post
  ORDER BY post_id DESC LIMIT 5';

devient donc :

$query =
  ' SELECT post.post_id,post.post_titre,post.post_titre_url,post.post_dt,cat.cat_libelle
  FROM '.DB_PREFIX.'post AS post, '.DB_PREFIX.'categorie AS cat
  WHERE post.cat_id = cat.cat_id
  ORDER BY post.post_id DESC LIMIT 5';

Vous pouvez remarquer la création d'alias (AS) permettant de générer une requête plus lisible, ici on fait une jointure entre le cat_id de la table post et celui de la table catégorie.

Ensuite, il ne reste plus qu'à afficher le libellé de la catégorie du billet de la façon suivante :

echo '<li><a href="http://www.biologeek.com/journal/index.php/'.$date_slash.'/'
  .$row['post_id'].'-'.$row['post_titre_url'].'" title="'
  .$row['post_titre'].'">['.$row['cat_libelle'].'] '.$row['post_titre'].'</a></li>';

Et voila, le résultat est toujours consultable en page d'accueil du site.