Plugin Veni Vidi Vici

Par Franck, . Lien permanent Dotclear › Plugins

PluginDernière version : v0.5.3 du 2 octobre 2006

Un plugin qui s’inspire et remplace le plugin Lecturique (créé par Tigroux et Hervé Mangeol). Le principe est le même avec un peu plus de souplesse pour la gestion des médias. Ce plugin permet d’afficher une sélection aléatoire d’un ou de plusieurs types de média. Il peut par exemple être utilisé pour afficher vos lectures du moment ou les films ou CD que vous avez aimés.

Attention : ce plugin fonctionne avec les versions 1.2 et suivantes de DotClear !

Installation

Utilisation

Une fois installé, la partie administration du plugin permet de créer, de modifier et de supprimer un ou plusieurs média. Chaque média possède un titre, éventuellement une image, une URL, un statut et est affecté à un type de média.

A la première installation, trois types de média sont automatiquement créés : Film, Livre et CD. Vous pouvez en créer d’autres, en supprimer (s’ils ne contiennent pas de médias) et en changer l’ordre d’affichage. Vous devrez également préciser le nombre de médias affichés pour chaque type.

Le statut des médias est représenté à l’aide de ces trois icônes sur lesquelles vous pouvez cliquer pour modifier le statut actuel :

  • Nouveau :
  • En cours :
  • Ancien :

Chaque média peut être noté (de 1 à 5) et on peut favoriser un affichage plus fréquent des médias les mieux notés.

Usage de la fonction pour l’affichage

Pour afficher une sélection aléatoire, insérez le code suivant dans votre fichier template :

<?php dcVvv::showSelection(); ?>

La forme complète de la fonction est la suivante :

function showSelection(
	[arry_type = null],
	[arry_filter = null],
	[max_width = null],
	[block = "<div class=\"vvv\">%s</div>"],
	[type = "<h2>%s</h2>"],
	[item = "<p>%s</p>"],
	[part = "%1\$s<br />%2\$s%3\$s"],
	[note = " (%s/5)"]
	)

avec :

  • arry_type : liste des identificateurs de types a afficher (null = tous). Les identificateurs sont affichés entre crochets après le titre de chaque type sur la page d’administration.
  • arry_filter : filtre des statuts d’item a afficher (null = tous). Le tableau doit comporter 3 entrées correspondant respectivement aux statut Nouveau, En cours et Ancien. Mettre 1 pour autoriser le statut, 0 sinon.
  • max_width : largeur maximum des images (null = native)
  • block : chaine de formattage de l’ensemble de la sélection
  • type : chaine de formattage du titre du type de média
  • item : chaine de formattage d’un média complet
  • part : chaine de formattage des éléments d’un média (image et titre). %1 est remplace par l’image, %2 par le titre et %3 par la note
  • note : chaine(s) de formattage de la note d’un média. Si une seule chaine de formattage est fournie, elle sera utilisée pour toutes les notes de 1 à 5. Si plusieurs chaines sont fournies, la chaine correspondant à la note sera utilisée. Si pour une note donnée, la chaine n’est pas indiquée, la dernière chaine fournie sera utilisée (on peut par exemple se limiter à donner 2 chaines, une pour les notes nulles et une pour les autres notes).

Exemple :

Si on veut uniquement une sélection parmi les médias en cours ou à venir, il suffit d’insérer cette ligne :

<?php dcVvv::showSelection(null, array(1, 1, 0)); ?>

Codes sources

Evolutions probables ou possibles

v0.6 et suivantes

  • Sélection d’une image interne à la manière de l’insertion dans les billets via un bouton (je n’ai pas encore trouvé de moyen simple pour utiliser les fonctions déjà existantes pour l’écriture des billets)
  • Vos suggestions …

Changements

v0.5.3 (2 octobre 2006 - voir l’annonce)

  • Suppression des balises HTML et/ou PHP du contenu de la balise alt=”…” des vignettes.

v0.5.2 (24 juin 2005)

  • Ajout en interne de la classe de traitement des fichiers de configuration.

v0.5.1 (23 juin 2005)

  • Correction de la position d’un traitement sur les tables avant même qu’elles soient créées lors d’une première utilisation (bug identifié par Oni).

v0.5 (21 juin 2005 - voir l’annonce)

  • Ajout de boutons d’ouverture et/ou de fermeture des listes des éléments pour chaque type de média.
  • Mise en place de l’aide en anglais

v0.4 (16 juin 2005 - voir l’annonce)

  • Implémentation du drag’n drop pour ordonner les types de média. Le code est désactivé par le positionnement d’une constante ($drag_and_drop dans le fichier index.php) en attendant de trouver une solution plus élégante pour le styleUne petite marge négative en plus et hop c’est fonctionnel et joli !

v0.3 (14 juin 2005 - voir l’annonce)

  • Page de configuration des éléments pouvant être fourni via la fonction d’affichage (largeur maximum des images, affichage de la note, …)
  • Pondération de l’affichage des éléments en fonction de leur note (suggestion de boblenain sur le forum)

v0.2 (13 juin 2005 - voir l’annonce)

  • Importation des informations du plugin Lecturique
  • Mise en place d’un système de notation (0 = pas encore de note, 1 = nul, …, 5 = excellent) pour chaque média. (suggestion de Quetzal via les commentaires et d’Arnaud Joubay via mail).
  • Ajout de la possibilité de spécifier une URL pour l’image. (suggestion de boblenain sur le forum)

v0.1 (11 juin 2005)

  • Version initiale.

Haut de page