Plugin Table des matières 0.5

Par Franck, samedi 15 janvier 2005. Lien permanent Dotclear › Plugins

toc Nouvelle version du plugin qui ajoute une nouvelle option qui éclaircit un peu la table lorsque le blog est multilangue :

Insertion du tag hreflang dans les liens des billets

Installation :

Tous vos commentaires, toutes vos suggestions et vos idées sont bien sûr les bienvenus ici ou sur le forum DotClear.

PS: Je mets en pause le développement de ce plugin en attendant de voir si des demandes spécifiques se manifestent.

Vous pouvez, si vous le désirez, modifier le comportement de la fonction dcToc::DisplayToc() en indiquant les paramètres suivants (ils sont alors utilisés à la place de la configuration générale) dans l'ordre :

Affichage de la date des billet (1 ou 0)
Nom de catégorie cliquable (1 ou 0)
Affichage du nombre de billets par catégorie (1 ou 0)
Nombre maximum de billets par catégorie (0 pour tous)
Affichage du nombre total de billets (1 ou 0)
Affichage du nombre de catégories (1 ou 0)
Affichage du titre en début de page (1 ou 0)
Identificateur du div encapsulant la table des matières
Identificateur numérique de la catégorie a exclure (0 si aucune)
Format de la date (1 = court, 0 = config)
Affichage de l'auteur des billets (1 ou 0)
Affichage du total avant la liste des billets (1 ou 0)
Insertion du tag hreflang dans le lien des billets (1 ou 0)

ToDo list :

V 0.x :

Limite sur l'ancienneté relative des billets (ex: le dernier mois, la dernière année) ?
~~Limite sur l'ancienneté absolue des billets (ex: 2004). Est-ce utile ?~~ Non, je laisse de côté pour l'instant
Liste par auteur ?
Liste triée par mois et/ou par année plutôt que par catégorie (ajouté le 18/01/2005)
Liste non groupée par catégorie (ajouté le 26/01/2005)
Nombre de commentaires et de trackbacks (ajouté le 27/01/2005)

14 réactions

1 De BG - 17/01/2005, 11:05

Ne connaissant pas PHP (mais je sais programmer quand même dans d'autres langages ;-)), je ne suis pas sur de comprendre les indications d'installation sous DotClear... En attendant que je me mette à PHP, pourrais tu m'expliquer :

<?php elseif ($mode == 'tocHome') : ?> <- OK : C'est à placer où ? <?php dcToc::DisplayToc(); ?>

Juste après : <- Cela signifie quoi ? Quelques lignes après ce qui précède ?

<div class="error"><strong>Erreur : </strong> <?php echo $err_msg; ?></div>

Et pour insérer un lien vers la table des matières :<-- Même question ....

<div id="toclink"><h2><a href="<?php dcToc::HomeURL(); ?>">Table des matières</a></h2></div>

J'ai placé ce code (sans les commentaires) dans Template.php de mon thème (à la fin ou presque....) juste avant le code réservé à l'insertion d'images éventuelles et je me fais jetter....

Merci d'avance pour un Newbie en PHP comme moi....

et désolé d'être casse-pied....
2 De Franck - 17/01/2005, 11:46
Il y a deux choses à faire dans le Template.php :

1°) Insérer le traitement de l'affichage de la table des matières demandée, et

2°) Insérer un lien quelque part pour pouvoir demander cette table des matières.

Pour le n°1 :

Il faut chercher dans ce fichier les lignes suivantes :
```
<div class="error"><strong>Erreur : </strong>
<?php echo $err_msg; ?></div>
```
Juste derrière celles-ci tu rajoutes celà :
```
<?php elseif ($mode == 'tocHome') : ?>
<?php dcToc::DisplayToc(); ?>
```
c'est tout pour le n°1.

Ensuite pour insérer le lien qui va permettre d'afficher la table des matières, toujours dans le même fichier template.php il faut insérer quelque part le code suivant :
```
<div id="toclink">
<h2><a href="<?php dcToc::HomeURL(); ?>">
Table des matières</a></h2>
</div>
```
Pour ma part, je l'ai mis juste après les archives. Les archives dans mon thème correspond à ce code dans le fichier template.php :
```
<div id="archives">
<h2>Archives</h2>
<?php dcMonthsList(); ?>
</div>
```
Est-ce clair ? Sinon, donnes-moi une copie de ton fichier template.php et je te fais les modifications.
3 De BG - 17/01/2005, 13:03

Géant ! J'ai suivi tes indications à la lettre et cela marche très bien... Il ne me reste plus qu'à trouver comment changer proprement la couleur du libellé "Table des matières" pour le valoriser... Je te remercie de ton aide et de ta gentilesse pour aider un "débutant PHP" aussi laborieux que moi...

Regarde le résultat de ton travail : http://www.tnis.fr/dotclear/index.php/toc/home

C'est impressionnant....
4 De Franck - 17/01/2005, 13:13

La couleur c'est une histoire de style, donc il faut aller voir dans le fichier style.css et rajouter ce que tu souhaites. Sinon, content que celà fonctionne bien.
5 De Weborg - 17/01/2005, 16:09

Salut, merci pour ce plug-in qui marche bien !
6 De Daniel - 18/01/2005, 00:22

C'est un excellent travail. Peut-être serait-il judicieux d'avoir la possibilité d'avoir deux "vues" : l'une triée par catégories, comme c'est le cas, l'autre par mois et/ou années ?
7 De Franck - 18/01/2005, 00:31

Oui pourquoi pas, triée par mois et/ou années. Je mets çà dans la ToDo list.
8 De julien - 19/01/2005, 20:22

bonjour, merci pour ce petit plug-in qui a très bien trouvé sa place dans mon prélude. Insatllation et réglages sans souci grace à l'aide intégrée.
9 De w!ll - 26/01/2005, 14:05

Bonjour,

merci pour ce plug-in. Si on pouvait activer/désactiver l'affichage des catégories (pour avoir seulement les titres des billets).
10 De Franck - 26/01/2005, 14:11

w!ll> Bonjour, effectivement c'est possible d'avoir cette option. D'ailleurs celà rentre dans une fonction un peu plus générale concernant le choix et le niveau de regroupement (catégorie, auteur, mois). Il faut que je reprenne le code en profondeur pour pouvoir gérer tout celà proprement. A suivre...
11 De Gilles - 26/01/2005, 15:04

Géant, merci pour ce travail...
12 De cerelog - 26/01/2005, 21:49

bon plug in

peux tu ajouter le total commentaires et des trackbacks

merci
13 De Franck - 27/01/2005, 00:29

C'était pas prévu, mais puisque c'est demandé, je vais le rajouter à la liste, on verra bien ...
14 De Franck - 28/01/2005, 11:47

Il y a une nouvelle version disponible qui intègre toutes vos demandes et un peu plus !!! C'est par ici.