====== Extension Blogroll Page ======
Votre liste de liens défonce votre sidebar ? La longueur de votre page est triplée parce que vous vous sentez obligé de faire un lien vers tous vos potes geeks ? Vous n'osez pas rajouter le site de votre chienne Noisette à la liste de peur qu'elle explose pour de bon (la liste hein, pas la chienne) ? Ne paniquez plus et faites vous une belle page de liens avec //Blogroll Page// !

<note attention>//Blogroll Page// ne remplace pas la liste de liens par défaut de Dotclear (extention //blogroll//), cette dernière doit donc être présente sur votre installation pour que //Blogroll Page// fonctionne correctement.</note>

===== Changelog =====
  * Verson 1.0.5
    * Ajout de la possibilité de ne pas afficher le lien vers la page de liens dans le widget
    * Ajout de la possibilité de lier directement vers une catégorie donnée dans le widget
  * Version 1.0.4
    * Ajout d'une option dans Paramètres du blogpour ouvrir les liens dans une nouvelle fenêtre/un nouvel onglet (sans target="_blank" bien entendu)
    * Ajoute d'un option sur le widet pour ouvrir les liens dans une nouvelle fenêtre/un nouvel onglet (l'option du widget est indépendante de celle concernant la page elle même)
    * Réorganisation du code
  * Version 1.0.3
    * Ajout d'une option pour activer la page de liens par blog (option présente sous l'écran Paramètres du blog). N'oubliez pas de l'activer sur les blog où vous souhaitez utiliser l'extension !
    * Réorganisation du code
  * Version 1.0
    * Compatible Dotclear 2.2
  * Version 1.0rc2-dsls
    * Compatibilité Dotclear 2.2, merci à [[http://www.morefnu.org/|Dsls]] pour ce patch
    * À télécharger [[http://forum.dotclear.net/viewtopic.php?id=42825&p=1|ici]]
  * Version 1.0rc2
    * Choix de la catégorie des liens aléatoires par liste déroulante.
    * Nettoyage du code
    * Affichage de la blogroll pour une catégorie donnée (ajoutez ''/Nom de la catégorie'' à l'URL de votre page de liens).
  * Version 1.0rc
    * Ajout de fonctions template.
  * Version 1.0b2
    * Retour du widget :
      * Possibilité d'afficher un des liens sélectionnés aléatoirement dans la sidebar et un lien "Plus de liens..." menant à la Blogroll Page.
      * Possibilité de restreindre le nombre de liens aléatoires
      * Possibilité de restreindre l'aléatoire à une catégorie donnée
  * Version 1.0b1
    * Réécriture //from scratch//
    * Template modulable

===== Documentation =====
<note attention>Veuillez prendre note que l'extension //Blogroll Page// ne prend en charge que l'affichage des liens sur une page dédiée. La gestion des liens passe toujours par l'extension //Blogroll// fournie par défaut avec //Dotclear2//. Pour plus d'informations sur la gestion de votre liste de liens, consultez [[http://doc.dotclear.net/2.0/usage/blogroll|la documentation officielle]].</note>

==== Installation ====
Vous trouverez l'URL de l'archive ZIP au bas de cette page. Pour le reste, suivez [[http://doc.dotclear.net/2.0/admin/plugins#installer-une-extension|les instructions de la documentation officielle]].
==== Utilisation ====
=== Widget ===
L'une des premières choses à faire une fois l'extension //Blogroll Page// installée est de la rendre accessible. Son adresse sera de la forme %%http://domaine.tld/blog/index.php?blogroll%% en mode //QUERY_STRING// ou %%http://domaine.tld/blog/index.php/blogroll%% en mode //PATH_INFO//. S'il est possible de créer un lien à la main dans un widget //Texte//, un billet ou directement dans votre thème, un widget //Page de liens// est à votre disposition pour vous faciliter la tâche.

Pour installer ce widget, référez-vous à la [[http://doc.dotclear.net/2.0/usage/widgets#ajoutersupprimer-un-widget|documentation officielle]]. Une fois le widget inséré dans le bandeau de votre choix, vous pouvez modifier ses paramètres. Les voici en détail :
  * **Titre** : Titre affiché dans le widget. Il sera également le texte du lien menant à votre page de liens si vous choisissez de ne pas afficher de liens aléatoires dans le widget.
  * **Afficher quelques liens aléatoires ?** : Si activé, le widget contiendra quelques liens sélectionnés aléatoirement parmi ceux de votre liste, suivis d'un lien "Plus de liens..." menant à votre page de liens.
  * **Catégorie** : Permet de restreindre le choix aléatoire de liens à une catégorie donnée. Sélectionnez la catégorie voulue dans la liste déroulante.
  * **Nombre** : Permet de restreindre le nombre de liens aléatoires affichés. Si la case est vide, que le nombre entré est zéro ou que vous entrez autre chose qu'un nombre, le widget affichera l'intégralité de votre liste de liens dans un ordre aléatoire (ce qui n'est généralement pas l'effet voulu).
  * **Page d'accueil uniquement** : Si activé, le widget ne s'affichera que sur la page d'accueil de votre blog.

=== Template ===
L'extension //Blogroll Page// utilise par défaut le template %%blogroll.html%% situé dans le dossier %%/plugins/blogrollpage/default-templates%% de votre installation (ou éventuellement un dossier différent si vous avez personnalisé l'emplacement de votre dossier %%plugins%%). Si vous souhaitez personnaliser l'affichage de votre page de liens, il est recommandé de copier ce fichier dans le dossier %%/tpl%% de votre thème avant de le modifier.

Voici une liste des balises %%tpl%% disponible dans //Blogroll Page// :
  * **<tpl:BlogrollPage>//...//</tpl:BlogrollPage>** : C'est dans ce bloc que tout se passe. Celui-ci se charge d'initialiser la liste de lien et de mettre différentes variables à disposition des autres balises. Son contenu est traité pour chaque catégorie de votre liste de liens. Il est impératif que toutes les autres balises concernant //Blogroll Page// soient situées à l'intérieur de ce bloc.
    * **<tpl:BlogrollPageIfCategoryTitle>//...//</tpl:BlogrollPageIfCategoryTitle>** : Le contenu de ce bloc ne sera traité que s'il y a un titre de catégorie à afficher. Il sert principalement à éviter les balises <hx>//...//</hx> vides si vous avez des liens non catégorisés au début de votre liste de liens.
      * **%%{{tpl:BlogrollPageCategoryTitle}}%%** : Affiche le titre de la catégorie traitée.
    * **<tpl:BlogrollPageLinks>//...//</tpl:BlogrollPageLinks>** : Boucle de traitement des liens individuels, son contenu est traité pour chacun d'eux. Toutes les balises affichant le détail d'un lien doivent impérativement se trouver dans ce bloc.
      * **%%{{tpl:BlogrollPageLink}}%%** : Affiche le lien formaté en HTML avec tous ses détails (titre, description, langue et informations XFN).
      * **<tpl:BlogrollPageIfLink//XXX//>//...//</tpl:BlogrollPageIfLink//XXX//>** : Ce bloc teste la présence du détail //XXX// pour le lien en cours de traitement et affiche son contenu si ce détail est présent. Les différentes informations disponibles sont :
        * **Desc** : La description entrée pour ce lien.
        * **Lang** : La langue indiquée pour ce lien.
        * **XFN** : Les informations XFN fournies pour ce lien.
      * **%%{{tpl:BlogrollPageLink%%//XXX//%%}}%%** : Affiche le détail //XXX// du lien. Les différentes informations disponibles sont les mêmes que pour <tpl:BlogrollPageIfLink//XXX//>, avec en plus :
        * **Title** : Le titre entré pour ce lien.
        * **Href** : L'URL du lien.

=== Divers ===
Vous pouvez accéder à une page listant uniquement les liens d'une catégorie donnée en accédant à l'adresse %%http://domaine.tld/blog/index.php?blogroll/Catégorie%% en mode //QUERY_STRING// ou %%http://domaine.tld/blog/index.php/blogroll/Catégorie%% en mode //PATH_INFO//. Le nom de la catégorie doit etre indiqué exactement tel qu'il a été entré dans l'interface d'administration.
==== Désinstalltion ====
Pour désinstaller l'extension //Blogroll Page//, reportez vous aux [[http://doc.dotclear.net/2.0/admin/plugins#suppression-d-une-extension|instructions de la documentation officielle]].
===== Compatibilité =====
  * Version 1.0rc2-dsls et supérieures compatibles Dotclear 2.2
  * Version 1.0rc2 compatible Dotclear nightly/SVN datant d'après le 29/09/2008 ([[http://dev.dotclear.net/2.0/changeset/2329|r2329]])
  * Version 1.0rc compatible Dotclear 2.0.2

===== Téléchargement =====
  * **Version 1.0 et supérieures** : {{http://plugins.dotaddict.org/dc2/details/blogrollpage|Page de téléchargement sur DotAddict}}
  * <del>**Version 1.0rc2-dsls** : {{http://forum.dotclear.net/viewtopic.php?id=42825&p=1|Téléchargement sur le forum Dotclear}} (merci à Dsls)</del>
  * <del>**Version 1.0rc2** : {{blogrollpage1.0rc2.zip|Archive}}</del>
  * <del>**Version 1.0rc** : {{blogrollpage1.0rc.zip|Archive}}</del>
  * <del>**Version 1.0b2** : {{blogrollpage.1.0b2.zip|Archive}}</del>
  * <del>**Version 1.0b1** : {{blogrollpage.1.0b1.zip|Archive}}</del>
===== Support =====
Le support se fait exclusivement dans [[http://forum.dotclear.net/viewtopic.php?id=21765|le sujet dédié]] sur le forum Dotclear. Aucun support par mail ou par commentaire sur mon blog personnel ne sera traitée.