Thumbsites - documentation utilisateur

Proposer des captures d’écran de site à la volée via des balises, des filtres ou des modèles

Objectif

Dans SPIP, si vous activez les statistiques et consultez la page « Liens entrants », vous pouvez obtenir des aperçus des différents sites à l’origine de vos visiteurs.

Ce plugin a pour but de généraliser cette fonction à l’ensemble de votre site en étendant la balise #LOGO_SITE et en fournissant aussi une balise, un filtre et des modèles pour afficher ces vignettes.

Attention, depuis la version d’origine, le nom du filtre et des modèles ont été modifiés.

Installation

Comme tout plugin, il suffit de suivre les procédures manuelles ou automatiques standard. Il s’agit de mettre le contenu du zip dans votre répertoire plugins/.
Pour plus d’information veuillez consulter la documentation de chaque version de SPIP de la 1.9 à la 3.0.

Pré-requis

Pour la branche 0 compatible SPIP 1.9 et SPIP 2, il faut impérativement activer le plugin CFG pour être en mesure d’utiliser Thumbsites. Pour la nouvelle branche 1 compatible SPIP 3, CFG n’est plus nécessaire.

Configuration

Dès que le plugin est activé, les fonctions d’aperçu sont disponibles et la balise #LOGO_SITE est étendue.

L’interface de configuration permet donc essentiellement de choisir le serveur de vignettes et ses éventuels paramètres d’utilisation. Pour le moment, il est possible d’utiliser les services de :

  • apercite.fr (service par défaut)
  • robothumb

Si aucune configuration est enregistrée, Thumbsites utilise par défaut le serveur apercite.fr.

-  Apercite.fr

Ce serveur ne nécessite pas d’enregistrement pour obtenir les vignettes.

-  Robothumb

Ce serveur ne nécessite pas d’enregistrement mais vous devez inclure un lien vers le site Robothumb quelque part sur votre site. La présence de ce lien est vérifié périodiquement par leur soin.

Utilisation par un webmaster

Le plugin propose plusieurs méthodes pour insérer une vignette dans le code d’un squelette SPIP :

  1. la balise étendue #LOGO_SITE
  2. la balise #THUMBSHOT
  3. le filtre thumbshot
  4. et les modèles site_thumbshot et auteur_thumbshot que nous décrirons dans la section suivante dédiée au rédacteur.

-  La balise #LOGO_SITE

C’est la méthode privilégiée pour utiliser le plugin Thumbsites dans le code des squelettes. Thumbsites étend la balise #LOGO_SITE de SPIP - à l’instar du plugin Gravatar pour la balise #LOGO_AUTEUR - de telle façon qu’elle retourne le logo si il existe ou la vignette sinon.

Exemple d’utilisation, une partie du modèle site_thumbshot :

<BOUCLE_site_thumbshot(SITES){id_syndic}>
[<div>
	<a href="(#URL_SITE)" class="spip_out">[(#LOGO_SITE)]</a>
	<p>
		<strong class="#EDIT{nom_site}">#NOM_SITE</strong>
		[ &mdash; <span class="#EDIT{descriptif}">(#DESCRIPTIF|PtoBR|couper{110})</span>]
	</p>
</div>]
</BOUCLE_site_thumbshot>

-  La balise #THUMBSHOT

Cette balise renvoie uniquement la vignette du site. Elle permet donc de pallier à l’existence d’un logo et de toujours forcer la vignette au détriment du logo du site. Cette balise possède trois arguments :

  • l’url du site
  • la taille de l’image à afficher (facultatif)
  • l’image par défaut si aucune vignette n’est récupérée (facultatif)

Exemple d’utilisation, la liste des vignettes de tous les sites :

<BOUCLE_site_thumbshot(SITES)>
     [<a href="(#URL_SITE)" class="spip_out">[(#THUMBSHOT{#URL_SITE, 32})]</a>]
</BOUCLE_site_thumbshot>

-  Le filtre thumbshot

Ce filtre retourne le chemin complet de la vignette en cache correspondant à l’url du site passée en argument.

Exemple d’utilisation, l’url peut être issue d’une boucle ou pas :

<BOUCLE_site_thumbshot(SITES)>
    <img src="[(#URL_SITE|thumbshot)]" alt="[(#NOM_SITE|attribut_html)]"[ title="(#NOM_SITE|attribut_html)"] />
</BOUCLE_site_thumbshot>

ou

<img src="[(#VAL{http://www.lequipe.fr}|thumbshot)]" alt="Lequipe.fr" title="Lequipe.fr" />

Utilisation par un rédacteur

Le plugin propose 2 modèles utilisables dans un article ou une rubrique, par exemple :

  • site_thumbshot.html, qui affiche la vignette du site désigné par un id ou par une url
  • auteur_thumbshot.html, qui affiche la vignette du site de l’auteur si il existe

Le rédacteur peut donc saisir dans son texte :

  • <site20|thumbshot> pour afficher la vignette du site d’id 20, ou bien
  • <site|thumbshot|url=http://www.lequipe.fr|titre=Lequipe|descriptif=tout le sport> pour afficher la vignette du site Lequipe.fr avec son titre et son descriptif, ou bien
  • <auteur1|thumbshot> pour afficher la vignette du site de l’auteur d’id 1

Affichage dans l’espace privé

Dès que le plugin est activé, il modifie l’affichage de la colonne gauche de la page d’édition d’un site en rajoutant un bloc avec la vignette du site sous le bloc du logo du site comme l’illustre l’image ci-dessous.

La vignette du site dans sa page d’édition

Evolutions

  • 04/01/2018 : suppression des services websnapr et miwim
    compatibilité https. Apercite semble inaccessible en https malgré ce qui est indiqué sur leur site, Robothumbs à l’air fonctionnel en https
  • 16/03/2013 : suppression des services thumbshots.com et thumbshots.de. Apercite.fr devient le service par défaut.

Discussion

26 discussions

  • 3

    Une adaptation pour SPIP2 ?

    • Bonjour

      Avez vous testé ? Le plugin est sensé être compatible SPIP2.
      Si tel n’est pas le cas , où est ce que ça coince ?

    • Effectivement le fonctionnement est correct avec spip2 pour ce que j’ai eu à faire.

      Il serait correct d’indiquer SPIP2 dans les tags du plugin

    Répondre à ce message

  • Bonjour

    2 nouveaux serveurs ont été ajouté au plugin.

    • thumbshots.de
    • websnapr.com

    Si vous connaissez d’autres sites/services n’hesitez pas à les signaler.

    Répondre à ce message

  • 3
    lupitek

    Je voudrais n’afficher un Thumbsite que si #URL_SITE est bien renseigné. J’utilise le code ci dessous mais visiblement ca ne fonctionne pas.
    Quelqu’un a une idée ?

    [<a href="#URL_SITE" target="_blank"><img align='right' vspace='10' hspace='10' class='thumb' src='(#URL_SITE|thumbsite)' border='0'></a>]
    • Bonjour

      Et ainsi ?

      [<a href="(#URL_SITE)" target="_blank"><img align='right' vspace='10' hspace='10' class='thumb' src='[(#URL_SITE|thumbsite)]' border='0'></a>]

      Mais il est vrai que si l’url donné est vide il faudrai que thumbisite retourne vide aussi, je vérifie

    • lupitek

      C’est bon ça fonctionne. Merci.

    • Bonjour

      ça devrait mieux se passer maintenant, le script a été mis à jour

    Répondre à ce message

  • 1
    lupitek

    Bonjour,

    Lorsque j’installe ce plugin sur une 1.9.2d et que je choisi comme serveur Thumbshots, j’ai l’erreur suivante :
    Call to undefined function : thumbsite_serveur()
    En regardant dans le plugin, dans serveur, il y a bien girafa.php et snapshot.php mais pas de Thumbshots.php ??
    Est-ce normal ??

    • Bonjour

      En effet un bel oubli ^^

      Cela est corrigé, dans le prochain zip (généré toutes les heures) le fichier sera présent.

      Merci

    Répondre à ce message

  • 2

    Bonsoir,

    C’est encore moi. Hier j’ai installé le plugin et tout allait bien et aujourd’hui plus de capture ! il semblerait que Snapshot attende un nom d’utilisateur .??!!..

    dd

    • Bonjour

      En effet snapshot semble avoir sécurisé leur serveur de miniature.

      Du coup faudrait s’identifier, ce qui oblige une modification du script.
      Prochainement :)

    • Bonjour

      Je viens de regarder leur script, il est trop fouilli pour pouvoir s’en sortir. Comme snap shot ne fournit pas d’information sur le comment du pourquoi, il m’est impossible en l’état de réactiver cette fonctionnalité.

      Par conséquent snap shot n’est plus supporté par thumbsites :(

    Répondre à ce message

  • 1

    Je viens de tester (super facile merci) l’intégration dans un site en 1.9.2 et ça marche nickel.

    Donc la mention de description du plugin « uniquement à partir de SPIP 1.93 » a peut être son importance mais moi je ne vois pas la différence.
    dd

    • Bonjour (ou bonsoir)

      En effet je peux corriger :) Le developpement a été fait avec Spip SVN, du coup je ne pouvais garantir pour les versions précédentes.

      Ayant d’autres retours positif, je valide pour la 1.9.2

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom