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 !

• 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 à Dsls pour ce patch
  • À télécharger 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

Vous trouverez l'URL de l'archive ZIP au bas de cette page. Pour le reste, suivez les instructions de la documentation officielle.

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 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.

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:BlogrollPageIfLinkXXX>…</tpl:BlogrollPageIfLinkXXX> : 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:BlogrollPageLinkXXX}} : Affiche le détail XXX du lien. Les différentes informations disponibles sont les mêmes que pour <tpl:BlogrollPageIfLinkXXX>, avec en plus :
      • Title : Le titre entré pour ce lien.
      • Href : L'URL du lien.

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.

Pour désinstaller l'extension Blogroll Page, reportez vous aux instructions de la documentation officielle.

• 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 (r2329)
• Version 1.0rc compatible Dotclear 2.0.2

• Version 1.0 et supérieures : Page de téléchargement sur DotAddict
• Version 1.0rc2-dsls : Téléchargement sur le forum Dotclear (merci à Dsls)
• Version 1.0rc2 : Archive
• Version 1.0rc : Archive
• Version 1.0b2 : Archive
• Version 1.0b1 : Archive

Le support se fait exclusivement dans le sujet dédié sur le forum Dotclear. Aucun support par mail ou par commentaire sur mon blog personnel ne sera traitée.