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 !

Blogroll Page est une extension pour Dotclear2 uniquement. Il est totalement incompatible avec Dotclear1.

Changelog

  • Version 1.0rc2-dsls
    • Compatibilité Dotclear 2.2
    • Merci à Dsls pour ce patch
    • À télécharger ici, je suis actuellement dans l'impossibilité de mettre à jour l'archive hébergée sur ce site.
  • Version 1.0rc2
    • Choix de la catégorie des liens aléatoires par liste déroulante.
    • Code globalement plus propre.
    • Affichage de la blogroll pour une catégorie donnée (ajoutez /Nom de la catégorie à l'URL de votre page de liens).

  • Compatible uniquement avec les SVN/nightly datant d'après le 29/09/2008 (r2329).
  • Version release candidate. Merci de reporter tous les problèmes que vous pourriez rencontrer.

  • Version 1.0rc
    • Ajout de fonctions template.

  • Si vous avez copié blogroll.html dans votre thème pour personnalisation, la balise {{tpl:BlogrollPage:LinkDescription}} est devenue {{tpl:BlogrollPage:LinkDesc}}.
  • Version release candidate. Merci de reporter tous les problèmes que vous pourriez rencontrer.

  • 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
      • Et le meilleur dans tout ça : possibilité de ne pas afficher de liens aléatoires et de retrouver le bon vieux lien seul menant à la Blogroll Page :P
    • Pas encore de page d'admin pour cette version (mais y'en aura peut être pas au final donc bon…)
    • Effacez obligatoirement votre ancien fichier blogroll.html du dossier de votre thème si vous mettez à jour d'une version antérieure à la 1.0b1
    • Plus de prévisualisation Websnapr des liens (viendra dans une extension à part si mon idée là dessus vient à terme)
    • Version beta, use at your own risks (mais devrait marcher quand même plutôt foutrement bien)
  • Version 1.0b1
    • Réécriture from scratch
    • Template bien plus modulable (on pourrait même dire modulable tout court)
    • Pas encore de page d'admin pour cette version
    • Pas encore de widget pour cette version
    • Effacez obligatoirement votre ancien fichier blogroll.html du dossier de votre thème si vous mettez à jour
    • Plus de prévisualisation Websnapr des liens (viendra dans une extension à part si mon idée là dessus vient à terme)
    • Version beta, use at your own risks (mais devrait marcher quand même)

Documentation

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 la documentation officielle.

Installation

Vous trouverez l'URL de l'archive ZIP au bas de cette page. Pour le reste, suivez 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 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:BlogrollPage:IfCategoryTitle></tpl:BlogrollPage:IfCategoryTitle> : 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:BlogrollPage:CategoryTitle}} : Affiche le titre de la catégorie traitée.
    • <tpl:BlogrollPage:Links></tpl:BlogrollPage:Links> : 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:BlogrollPage:Link}} : Affiche le lien formaté en HTML avec tous ses détails (titre, description, langue et informations XFN).
      • <tpl:BlogrollPage:IfLinkXXX></tpl:BlogrollPage:IfLinkXXX> : 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:BlogrollPage:LinkXXX}} : Affiche le détail XXX du lien. Les différentes informations disponibles sont les mêmes que pour <tpl:BlogrollPage:IfLinkXXX>, avec en plus :
        • Title : Le titre entré pour ce lien.
        • Href : L'URL du lien.

Désinstalltion

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

Compatibilité

  • Version compatible Dotclear 2.2 ici.
  • Dernière version (1.0rc2) compatible Dotclear nightly/SVN datant d'après le 29/09/2008 (r2329).
  • Version 1.0rc compatible Dotclear 2.0.2

Téléchargement

Support

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.

 
accueil.txt · Last modified: 2010/07/17 14:19 by simon
 
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki