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

  • 2
    Laëtitia

    Bonjour,

    je découvre le plugin, il est top merci.

    le choix s’est porté sur robothumb et j’aimerai utiliser une autre image temporaire « miniature en génération » dois-je voir cela avec robothumb ou bien l’image se trouve dans le plugin et je ne l’ai pas vue ?
    Laëtitia

    • Alors non le plugin ne fait rien quand la miniature est en génération : c’est le service qui renvoie une image par défaut. Et donc je ne pense pas que tu puisses la modifier.

    • Laëtitia

      Merci pour ta réponse rapide.

      Alors ils demandent a mettre un lien vers leur site (ça c’est normal) et en plus on doit afficher leur vignette pas très jolie :/

    Répondre à ce message

  • Robert Zöchling

    Bonjour à tous !

    Lorsque le service Apercite à changé le propriétaire et L’URL, j’ai adapté le fichier « apercite.php » dans le répertoire « serveurs » en remplaçant

    return "http://www.apercite.fr/api/apercite/${taille}/oui/oui/${url_site}";

    par

    return "https://aprc.it/api/${taille}/${url_site}";

    Malheureusement ça n’affiche rien (même pas de balise « img » est generée) sur mes pages.

    Quelqu’un/une une idee ?

    Merci d’avance !

    Répondre à ce message

  • 1

    Bonjour,

    Sur des sites, qui viennent de passer en https, les requètes vers les API des services comme apercite, sont en http ceci provoque une alerte de sécurité dans le navigateur.

    Je me suis permis de mettre a jour les services qui sont encore disponible car deux d’entre eux on arrêté le service.

    Reste donc apercite et robothumb.

    • Apercite ne propose pas d’accès https a leur API pour le moment (le site à l’air un peut en vrac d’ailleurs) : donc les sites https utilisant en partie publique ce service auront une alerte de sécurité
    • Robothumb est accessible en https , il semble que c’est le service a privilégier
    • Bonjour

      Merci pour le suivi et la correction. Je viens de t’ajouter auteur sur la page, cela te permet donc de mettre à jour la documentation :)

      Merci encore

    Répondre à ce message

  • 2

    Hello,
    J’ai essayé d’afficher le images résultant du code <site1|thumbshot> et <auteur1|thumbshot> sans résultat. Je précise que site1 et auteur1 existent sur le site...
    Essai sur un site réservé aux tests : http://ww2.internet22.catholique.fr/Tests-des-codes-Thumbsites
    Question : pourquoi cela ne marche pas ?
    Merci de ta réponse.

    • Bonjour

      Pour que cela fonctionne avec un auteur il faut que son profil soit à jour avec un site associé.
      Pour le site je ne sais vu que sur le page le cas site1 fonctionne et un des 2 cas avec url non.

    • C’est exact, c’est pour montrer que cela ne marche réellement pas.

    Répondre à ce message

  • 3

    Bonjour,
    Il y a un truc que je n’arrive pas à résoudre avec Thumsites (en SPIP 3.0.10)
    -  quand il y un logo du site, il est justifié à droite
    -  quand c’est la vignette générée, elle n’est pas justifiée à droite alors que c’est demandé dans le code (je mets sjuste le bout de code nécessaire à la compréhension) :

     <li class="site">
    <a href="[(#ID_SYNDIC|generer_url_entite{site,'','',#CONNECT})]">
        <b>#NOM_SITE</b>
    </a>
    <a href="#URL_SITE">[(#LOGO_SITE|right|image_reduire{70,60})]</a>

    Je joins une image pour illustrer.
    Merci d’avance,
    Philippe G.

    • Je précise : naturellement je voudrais que la vignette soit justifiée à droite comme le logo... (Le code est celui du fichier rubrique.htm).

    • Bonjour

      C’est semble t il le comportement classique de SPIP. Normalement il y a un spip_documents_(left|right) qui doit être appliqué sur l’une ou l’autre des balises.

      Le plus simple est de controler à l’aider d’un debogueur html (dragonfly, firebug, ...)

      Je mettrais de plus le filtre right apres traitement des images.

    • Merci pour ta réponse.

    Répondre à ce message

  • 1

    Bonjour,

    Au passage à SPIP 3.0.7 le plugin me fait une erreur 500 dans le back-office.
    Si je désactive le plugin l’erreur 500 disparait.

    Est-ce que cela arrive à quelqu’un d’autre ?

    Merci,
    Abel

    • Pierre

      Bonjour,

      J’ai eu le même problème : mon site était même invisible !

      J’ai résolu le problème :

      -  en enlevant le plugin thumbsite et en le réinstallant. Bien entendu, il faut veiller à installer la version compatible avec la version installée de Spip sur votre site !

      -  en indiquant apercite.fr comme générateur de vignette (en enlevant thumbshot puisqu’il n’est plus d’actualité).

      Bonne chance.

      Pierre

    Répondre à ce message

  • Bonjour, à première vue, si on place dans un article un appel de l’icône de plusieurs sites grâce au plugin thumbsite sous Spip 3.0 en mettant , les images des sites correspondants sont décalées.

    Alors qu’avec la version Spip 2.x, ce n’était pas le cas. Avec Spip 2.x, les images étaient l’une en dessous ; avec Spip 3.0, les images se décalent à droite. Cela fait un mauvais effet visuel.

    Quelqu’un a une idée pour enlever ce désagrément ?

    Répondre à ce message

  • Bonjour,

    Ce plugin est vraiment très pratique, il y a t il une version pour Spip 3.0 en cours de travail ?

    ou dois-je partir sur d’autres solutions ?

    Merci de votre attention et de tout ce boulot.

    Répondre à ce message

  • 1

    Bonjour,

    Il semblerait que seul #LOGO_SITE soit pris en compte, et pas #LOGO_SITE_NORMAL

    Je pourrais toujours m’en sortir avec un
    #LOGO_SITE_NORMAL|sinon{#THUMBSHOT}
    mais ce serait plus logique que ça marche sans ça.

    Répondre à ce message

  • 2

    Bonjour,
    girafa ferme ses services à partir du 1er septembre 2011... il faudra retirer ce choix du plugin ?

    • Bonjour

      Ce choix a été désactivé : http://zone.spip.org/trac/spip-zone/changeset/49739/_plugins_/thumbsites mais il n’est pas remonté du fait de l’oubli de mise à jour du numéro de version.

    • pierre

      Bonjour,

      Quand on installe le plugin thumbsite à partir de l’espace privé (et en ayant créé le répertoire plugins/auto), le plugin s’installe dans le répertoire lib à la place du répertoire plugins/auto !!!

      Cela peut empêcher qu’il soit réellement activé et reconnu...

      Est-ce qu’il y a moyen de corriger cette petite erreur ?

      Avec le plugin couteau suisse, la mise à jour se fait également dans le répertoire lib !

      J’ignore si le problème est lié à spip ou à thumbsites ou ?

      Bonne journée.

      Pierre

    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