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.
- <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.
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
- Support de l'extension Breadcrumb
- 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
- Retour du widget :
- 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 !
1 De Kompozitor
-
Bonjour j'utilise votre plugin depuis trèslongtemps avec beaucoup d'intérêt. Depuis la nouvelle version, le widget me provoque cette erreur : Fatal error: Call to undefined method dcUrlHandlers::getURLFor() in /homez.150/kompozit/www/dotclear/plugins/blogrollpage/inc/lib.brp.widget.php on line 34
Vous pouvez voir en live sur http://kompozitor.fr
Ai-je oublié de faire quelque chose (le plugin est activé dans les paramètres du blog)
2 De saymonz
-
Quelle version de Dotclear ? Il faut au moins la version 2.4.1.2 du 24/12/2011 pour pouvoir utiliser Blogroll Page >= 1.0.6.
3 De Kompozitor
-
effectivement, ca marche !
merci !
4 De saymonz
-
Content que ça roule
!
5 De brol
-
Afin d'avoir le même type de présentation que les plugins tags et autres mettant à disposition un lien pour en voir plus, ne serait-il pas mieux de remplacer le <h3></h3> en ligne 72 de _widget.php par <p><strong></strong></p> ?
Parce que là, l'affichage, ben il est pas beau du tout.
6 De brol
-
Salut, est-il prévu une mise à jour du plugin pour dc2.7 et les jeux de templates ? Si oui, quand (à peu près) ?
Merci
7 De saymonz
-
Je ne maintiens plus mes plugins Dotclear depuis longtemps déjà. Mais c'est libre (WTFPL powered), libre à qui veut de prendre le relai (et même de se l'approprier sur DotAddict si ceux qui gèrent le dépôt n'y voient pas d'inconvénient).
8 De Tomek
-
Hello,
Merci pour la mise à jour version 2. Je ne peux pas contre pas l'installer via le gestionnaire de plugins qui me dit en substance que "Le fichier zip ne semble pas être un fichier de module Dotclear valide." Penses-tu pouvoir regarder ce qu'il en est ? Merci !
9 De Gérard Barré
-
Bonjour,
Avec Dotclear 2.15.1, je fais le même constat que Tomek. Même message d'erreur : "Le fichier zip ne semble pas être un fichier de module Dotclear valide."
Merci de ton éclairage, cordialement
10 De saymonz
-
Désolé pour le silence de mort, mais j'arrive en tout cas à l'installer depuis DotAddict sans problème à l'heure actuelle, sur la dernière version de Dotclear.
J'ai ressuscité, dites moi si ça merdoie toujours, je devrais être potentiellement plus réactif.
11 De Tomek
-
Hello Simon,
Ces problèmes de téléchargements sont un peu bizarres et aléatoires… Bref.
Je te contacte pour savoir si tu penses mettre à jour le plugin pour la nouvelle version de DC qui arrive et qui change pas mal de choses : Franck a fait une série de billets là-dessus : https://open-time.net/serie/Adapter...
Merci !
12 De saymonz
-
Salut !
J'ai suivi le dossier de loin, je vais voir ce que je peux faire, ces changements semblant assez simple à implémenter.
Ça fait plaisir que tant d'années après ce truc soit assez utile à quelqu'un pour qu'on vienne me réclamer une mise à niveau haha.
Au plaisir !
13 De Tomek
-
Bah oui je m'en sers sur pas mal de sites encore, héhé !
Merci à toi en tout cas d'assurer le suivi. Tiens-moi au courant quand tu auras une version à tester.
14 De Tomek
-
Hello, je reviens aux nouvelles, tu as pu regarder ? Merci !
si besoin je peux essayer de modifier des choses dans les fichiers et voir si ça fonctionne, mais je ne suis pas sûr d'être en capacité dès que ça dépasse le copier/coller.
15 De saymonz
-
Coucou !
Alors, a priori, la version actuelle tourne encore sur Dotclear 2.24, j'ai néanmins appliqué les transitions requises, le paquet mis à jour est dispo ici : https://dotclear-devlog.saymonz.net...
J'ai honnêtement fait ça à la zob, mais ça cause pas d'erreur chez moi... N'hésite pas à me dire si tu tombe sur un os.
Si y a rien, je le mettrais sur DotAddict prochainement.
16 De Tomek
-
Hello Simon,
Merci ! Je vais tester tout ça et je te tiens au jus.
17 De saymonz
-
A priori, je me suis emballé : le widget semble avoir foutu le camp. Je regarde de quoi il en retourne dans les prochains jours.