Aller au contenu | Aller au menu | Aller à la recherche

lundi 31 août 2009

Greffon pour DotClear2 : billet aléatoire V0.8

Par ȷulmud le lundi 31 août 2009, 18:52 - Free the code!

À la demande d'un utilisateur, j'ai ajouté une nouvelle fonctionnalité dans mon greffon randomPost et en ai profité pour le rendre compatible avec les versions récentes de PHP.

Trois nouveautés sont au programme :

  • possibilité de laisser passer quelques tags HTML lors de l'affichage d'un extrait du billet ;
  • possibilité d'inclure le widget dans un thème de blog via la balise <tpl:widget> ;
  • compatibilité avec PHP 5.3.[1]

Notes

[1] Au moment de l'écriture de ces lignes, Dotclear2 n'est pas encore compatible avec PHP 5.3.

À koi k'ça sert ?

Ce greffon vous offre la possibilité de créer un lien qui redirige le visiteur vers un billet tiré au hasard parmi tous les billets publics[1] de votre blog.

Koi k'y a de neuf dans cette version?

  • Possibilité de laisser passer quelques tags HTML lors de l'affichage d'un extrait du billet.
  • Possibilité d'inclure le widget dans un thème de blog via la balise <tpl:widget>.
  • Compatibilité avec PHP 5.3.

Utilisation

Facile : éditez le template de votre blog, et ajoutez-y un lien avec comme destination (l'attribut href) la fonction de template {{tpl:RandomRedirURL}} et c'est tout. Ou alors, utilisez le joli petit widget de présentation pour ajouter le lien dans vos bandeaux de navigation...

L'option (disponible uniquement sur le widget) permettant de laisser passer des tags HTML dans l'extrait permet de spécifier plusieurs tags en les mettant simplement à la suite les un des autres. Par exemple : <img><a> autorisera les tags image et lien dans l'extrait affiché du billet. Attention, le texte complet du tag fait partie de la longueur de l'extrait. Il y a donc un risque que la coupure de l'extrait intervienne au milieu d'un tag et que cela cause des problèmes d'affichage sur votre page. À utiliser donc uniquement si vous êtes sûr de ce que vous faites !

Pour savoir quelles sont les paramètres à utiliser pour styler le lien dans votre bandeau de navigation, regardez la page du plugin, tout y est détaillé. Vous y trouverez également les descriptions de toutes les options du widget, ainsi que toutes les fonctions de template qui sont à votre disposition.

Bogues connues

Aucune pour le moment...
Une remarque toutefois : si vous utilisez l'affichage du titre et de l'extrait sur toutes les pages de votre blog, cela risque de ralentir votre site. En effet, en faisant cela vous allez ajouter deux requêtes SQL par page vue... cela n'est pas négligeable ! L'utilisation de la redirection ne possède par contre pas cet effet de bord.

Je veux voir !

Allez sur mon photoblog, cliquez sur le lien « Photo au hasard » et voilà ! Vous avez été redirigé vers une photo tirée au hasard.

À venir

Rien... je suis à court d'idées d'amélioration et il faudrait quand même que je passe mon temps à autre chose.

Téléchargement

Hop, jetez un œil dans les fichiers joints à ce billet...

Remarques, commentaires, rapports de bogues, ...

... sont toujours les bienvenus dans les commentaires de ce billet.

Notes

  • La version 0.7 n'a jamais été publique.

Notes

[1] Il s'agit donc des billets publiés et non protégés par un mot de passe.

6 commentaires

Mise à jour du widget vie de merde, version 0.4.1

Par ȷulmud le lundi 31 août 2009, 18:42 - Free the code!

Mise à jour du widget VieDeMerde pour Dotclear2. Il y a quelques temps déjà, le site viedemerde.fr lançait sa version anglophone : fmylife.com. Depuis est également née la version italophone : vitadimerda.it. Ils ont eu la bonne idée de rendre ces trois sites accessibles via une seule API, ce qui me permet d'offrir maintenant ce widget en trois langues.

Les nouveautés au programme :

  • possibilité de choisir la langue des VDM affichées (français, italien ou anglais) ;
  • compatibilité avec PHP 5.3.[1]

Notes

[1] Au moment de l'écriture de ces lignes, Dotclear2 n'est pas encore compatible avec PHP 5.3.

A koi k'ça sert ?

Le site viedemerde.fr est un recueil de petites anecdotes de la vie de tous les jours et qui pourraient arriver à tout le monde. Ce widget permet de récupérer une citation aléatoirement sur le site et dans l'afficher sur votre blog.

Paramétrisation du bouzin

Ce widget étant très simple, il n'y a que peu (voire pas du tout) de paramétrisation possible. La seule chose vraiment notable est la présence d'une liste vous permettant de choisir la langue que vous souhaitez utiliser pour l'affichage des VDM (français, anglais ou italien).

Le rendu sur votre blogue peut être personnalisé via les classes CSS suivantes :

  • vieDeMerde : le div entourant tout le widget de citation ;
  • vdmCite : le paragraphe contenant les infos auteur et date de la citation ;
  • vdmAuthor : un span autour du nom de l'auteur ;
  • vdmDate : un span autour de la date de la citation ;
  • vdmLink : un span autour du lien en retour vers la citation sur le site VDM.fr (ou .it, ou .com).

Le fichier zip de ce widget est disponible comme fichier joint à ce billet.

Note : La version 0.4.0 du greffon n'a jamais été publique.

Greffon pour Dotclear2 : shortURL v0.3.1

Par ȷulmud le lundi 31 août 2009, 18:25 - Free the code!

Une simple petite version mineure de maintenance pour mon greffon shortURL.

La seule nouveauté au programme :

  • compatibilité avec PHP 5.3.[1]

Notes

[1] Au moment de l'écriture de ces lignes, Dotclear2 n'est pas encore compatible avec PHP 5.3.

À koi k'ça sert ?

Ce greffon permet d'utiliser une URL raccourcie pour accéder aux billets de votre blogue. Cela vous permettra de publier l'URL de billets lorsque vous êtes limités sur le nombre de caractères dans votre message (par exemple avec Twitter).

Utilisation

Après installation de ce greffon, allez dans les paramètres de votre blogue et activez le système des URLs raccourcies. Dès lors, une nouvelle entrée fait son apparition dans le menu à droite lors de l'édition de billets ou de pages. Cette entrée nommée Short URL affiche votre URL raccourcie pour accéder au billet. Note : cette entrée n'apparaît que lorsque le billet a été enregistré !

Entrée de menu shortURL dans l'interface d'administration

Si vous le souhaitez, vous pouvez également publier cette URL dans votre blogue. Pour cela, il suffit de modifier votre thème et d'utiliser la méthode de template {{tpl:EntryShortURL}}. Évidemment, cela ne fonctionne que dans le cadre d'une boucle de billets.

L'équivalent est également disponible dans l'affichage des commentaires et peut être affiché sur le blog via la méthode {{tpl:CommentShortURL}}.

Entrée de menu shortURL dans l'interface d'administration des commentaires

Je veux voir !

L'URL raccourcie de ce billet : http://mudry.org/blog/shurl/Tg
L'URL raccourcie de la page À propos de mon photoblogue : http://mudry.org/photoblog/shurl/2503
L'URL raccourcie d'une galerie de mon voyage au Japon : http://mudry.org/galerie/shurl/1978
Le commentaire de theClimber demandant quelques évolutions : http://mudry.org/blog/shurlc/1Kk

Koi k'ya de neuf ?

Cette version est simplement une version de maintenance prévoyant la compatibilité avec PHP 5.3. Bien entendu, cette version est également compatible avec PHP 5.2.

Remarques

  • Dans les préférences liées à ce greffon, il vous faut choisir deux préfixes d'URL (un pour pointer vers les billets, l'autre pour pointer vers les commentaires). Ces deux préfixes doivent être différents, mais aucune vérification n'est effectuée lors de la sauvegarde des paramètres. Si vous constatez un comportement bizarre (particulièrement des erreurs de pages non trouvées lorsque vous utilisez une URL raccourcie), commencez par vérifier que ces deux paramètres sont bien différents.
  • Je ne conseille pas vraiment l'utilisation de la version ultra-courte des URLs. Le gain est généralement faible (chez moi deux ou trois caractères) et cela apporte de potentiels problèmes de lecture et de compréhension de l'URL (risque de confusion entre 'I', 'l' et '1' par exemple).
  • Étant donné que tout le processus d'identification des billets se base sur l'ID du billet (ou du commentaire), les URLs raccourcies ont de fortes chances de ne plus être identiques si vous réimportez votre blogue. Par conséquent, je vous conseille de ne surtout pas les utiliser pour faire des liens internes à votre blogue (pas comme je le fais ci-dessus, en fait ;-) ).
  • Que vous activiez ou non le support des URLs encore plus courtes, les deux systèmes fonctionnent de toute façon en parallèle. Le paramètre n'influence en fait que sur l'affichage (que ce soit dans l'interface d'administration du blogue ou via les méthodes de template idoines).

Téléchargement

Hop, jetez un œil dans les annexes à ce billet...

Remarques, commentaires, rapports de bogues, ...

... sont toujours les bienvenus dans les commentaires de ce billet.

Crédits

Sur une idée que theClimber avait proposé sur le forum Dotclear. Une partie du code est fortement inspirée du greffon gallery de Dsls.

un commentaire