Extension Blogroll Page - Page de liens

Par saymonz, . Lien permanent

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 !

Téléchargement

Le téléchargement se fait sur la page DotAddict de l'extension ou via l'installateur DotAddict.

Documentation

Avertissement

Veuillez noter 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

L'installation de Blogroll Page ne présente aucune difficulté particulière, vous pouvez donc suivre sans crainte les instructions de la documentation de Dotclear.

Activation

Une fois l'extension installée et activée, il faut encore activer la page de liens pour chaque blog où vous désirez l'utiliser. Pour cela, rendez vous sur la page Paramètres du blog et descendez jusqu'à trouver la section Page de liens. Cochez ensuite la case Activer la page de liens, et éventuellement Ouvrir les liens dans une nouvelle fenêtre selon vos préférences.

Widget

Une fois votre page de liens activée, celle-ci sera accessible à l'adresse 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.

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

Journal des modifications

  • Version 2
    • Prise en compte des nouveaux templates (+ joli)
    • Prise en compte des nouvelles conventions pour les widgets (+joli aussi)
  • Version 1.1.2
    • Nouvelles options pour le widget
    • Changements cosmétiques pour Dotclear 2.5
  • Version 1.1.1
    • Meilleur support de l'extension Breadcrumb (page de liens d'une catégorie seule)
  • Version 1.1
  • Version 1.0.6
    • Optimisation/nettoyage du code
  • 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 blog pour ouvrir les liens dans une nouvelle fenêtre/un nouvel onglet
    • 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 sur l'écran Paramètres du blog).
    • Réorganisation du code
  • Version 1.0
    • Compatible Dotclear 2.2
  • Version 1.0rc2-dsls
    • Compatibilité Dotclear 2.2, merci à Dsls
  • 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

License

L'extension Blogroll Page et l'intégralité de son code source sont mis à disposition sous les termes de la Do What The Fuck You Want To Public License ou son équivalent français, la License Publique Rien À Branler.

Support

Le support se fait sur le forum de Dotclear ou bien dans les commentaires de cette page.

Soutien

Si vous appréciez mon travail, n'hésitez pas à faire un don pour soutenir le développement !

Ajouter un commentaire

Le code HTML est affiché comme du texte et les adresses web sont automatiquement transformées.

Haut de page