Spip2Spip

Version Plugin

21 février 2008 – par erational, RealET – 175 commentaires

1
2
3
4
5
33 votes
Spip2spip permet de synchroniser le contenu de plusieurs sites SPIP entre eux en étendant le principe de la syndication thématique. Les articles d’un SPIP sont recopiés d’un site à l’autre en conservant leur formatage original.

Sommaire

Fonctionnalités

Spip2spip permet à des sites Spip qui ont des thématiques en commun de s’échanger directement les articles au format Spip.

À la différence d’une simple syndication, l’article va être importé en tant qu’article dans la rubrique du site destination. Cet article importé sera donc éditable et conservera ses raccourcis et le maximum d’informations (auteurs, pièces jointes, mots-clés ....)

Téléchargement et installation

  1. Téléchargez le plugin
  1. Activez le plugin dans le menu habituel.
    L’activation du plugin crée automatiquement le groupe de mots-clés -spip2spip- qu’il faudra compléter pour tagguer les thématiques à échanger.
  1. Renseignez les sites avec lesquels vous voulez importer des informations, en les ajoutant dans le menu édition > spip2spip

Paramétrage du plugin

Avec CFG, vous pouvez définir vos options d’import :

  • Quel est le statut des articles à importer : proposé ou publié ?
  • Faut-il citer l’adresse d’où provient l’article ?
  • Faut-il alerter un admin par email à chaque syndication ?
  • Faut-il importer / exporter les mots-clés des articles et de ses événements ?
  • Faut-il créer les mots-clés dans un groupé donné ou ré-créer les groupes de mots-clés du site d’origine ?

Via config/mes_options.php il est possible de :

  • Bloquer la récupération du contenu (si la seule information qui nous intéresse, c’est le titre et l’origine du contenu)
  • Bloquer la récupération des documents joints
define('_SPIP2SPIP_RECUPERER_CONTENU', false);
define('_SPIP2SPIP_RECUPERER_DOC', false);

Principe général

spip2spip est une syndication qui est basée sur un groupe de mots-clés commun appelé - spip2spip -

Chaque mot-clé de ce groupe sert à désigner une thématique donnée :

  • créer un mot clé dans ce groupe permet de créer un canal thématique
  • attribuer ce mot-clé à vos articles permet de les diffuser aux autres sites
  • attribuer ce mot-clé à une rubrique permet d’y importer les articles des autres sites

Les sites recopient les articles entre eux grâce au cron :

  • le formatage des articles spip des articles est conservé (raccourcis typographiques, saut à la ligne, insertion des images et documents ....)
  • citation automatique de la source (url de l’article d’origine)
  • reprise de la licence (voir contribution licence)
  • création de l’auteur si celui n’est pas présent le site SPIP cible.
  • les images et documents sont convertis en documents distants
  • les événements liés à l’article si vous utilisez le plugin Agenda 2.0 et ultérieur
  • logo de l’article version 2.3
  • langues, liens de traduction et balises <multi> version 2.3
  • mots-clés de l’article et de ses événements version 2.3

Diffuser de l’information

  1. Allez dans le groupe de mots-clés -spip2spip-
  2. Dans ce groupe, créez un mot-clé par chaîne thématique que vous voulez diffuser : sport, informatique, œnologie, ...
  3. Attribuez ces mots-clés aux articles concernés.

Cela permet à votre site de proposer ses articles à la syndication spip2spip via l’adresse réservée :
Flux simple http://monsite.org/spip.php?page=backend-spip2spip
Flux complet avec les événements http://monsite.org/spip.php?page=backend-spip2spip-agenda
Flux de tous les articles d’un auteur http://monsite.org/spip.php?page=backend-spip2spip-auteur&id_auteur=XX

S’abonner à une chaîne d’information

Je vais maintenant m’abonner à des sites amis pour recopier automatiquement les articles qu’ils proposent.

étape 1 : inscrire les sites amis
Je vais inscrire le flux spip2spip d’un site ami :

Exemple : Je m’abonne au flux spip2spip de
@-brest

étape 2 : s’abonner à un canal thématique
Je me suis abonné à un site, il faut maintenant choisir quel canal thématique m’intéresse.

J’observe donc le flux du site ami :

Exemple : Ce flux XML propose plusieurs « chaînes thématiques » :

  • a-brest-B pour les articles @-brest concernant la bretagne
  • a-brest-F pour les articles @-brest concernant la technologie
  • ...

Je décide de m’abonner à la « chaîne thématique »a-brest-B.

  1. Je crée dans la mot-clé a-brest-B dans le groupe de mots-clés -spip2spip-
  2. J’attribue ce mot-clé à la rubrique dans lequel je veux que les articles distants soient recopiés.

La synchronisation

La syndication se fait automatiquement grâce au cron.
Vous pouvez aussi forcer la syndication manuellement depuis
l’interface privée.

Le plugin examine alors tous les articles proposés et leur chaîne thématique. Si un article correspond à une chaine auquel vous vous êtes abonné, il importe l’article dans la rubrique sur lequel vous avez placé le mot-clé de cette chaîne thématique.

Origine de l’importation stockée par le plugin

2 champs supplémentaires dans la tables spip_articles permettent d’avoir accès à la source distante d’origine de l’article importé [1].

Sont donc stockés :

  • #S2S_URL_SITE_DISTANT : l’URL du site distant (en principe sans / final)
  • #S2S_ID_ARTICLE_DISTANT : l’identifiant de l’article sur le site distant

Vous pouvez par exemple :

  • Faire un lien sur l’article d’origine : 
    <a href="#S2S_URL_SITE_DISTANT/?article#S2S_ID_ARTICLE_DISTANT">#TITRE</a>
  • Appeler un squelette sur le site d’origine pour incorporer son résultat à votre page : 
    [(#VAL{#S2S_URL_SITE_DISTANT?page=inc_pour_inclusion_distante&id_article=#S2S_ID_ARTICLE_DISTANT}|recuperer_url_cache|table_valeur{page})]

Astuces

Si vous voulez masquer l’affichage du groupe de mots-clés -spip2spip-, vous pouvez utiliser la boucle

<BOUCLE_listemot(MOTS){id_article}{type!==^[-]}>....</BOUCLE_listemot>

Alternative pour masquer le groupe -spip2spip : utiliser le critère doublons

<BOUCLE_mot_cache(MOTS){type=- spip2spip -}{doublons spip2spip}> </BOUCLE_mot_cache>
<BOUCLE_listemot(MOTS){id_article}{doublons spip2spip}>....</BOUCLE_listemot>

Astuces (bis)

Spip2spip version 2.3 ajoute 2 champs supplémentaires à la table spip_articles qui peuvent être exploités éventuellement dans un squelette dans une boucle ARTICLES

  • #S2S_URL l’adresse de l’article d’origine
  • #S2S_URL_TRAD l’adresse de la traduction de l’article d’origine

Astuces (ter)

À l’import, Spip2spip adopte le comportement par défaut de SPIP lors de l’import de données externes : le filtre textebrut s’applique sur tous les champs pour empêcher les injections de HTML, Javascript, XSS ....
Si vous désirez quand même (à vos risques et périls), importer du HTML brut, ajouter dans votre fichier config/mes_options.php

define('_SPIP2SPIP_IMPORT_HTML', true);

Évolutions

version 3.4 Mars 2018 Ajout d’un flux pour exporter tous les articles d’un auteur
version 3.3 Mai 2017 Ajout des champs pour stocker l’origine et de la possibilité de bloquer la récupération du contenu et des documents
version 3.2 Juin 2016 Version SPIP 3.1
Correction de bugs sur l’import de documents et logos
Flux version 1.9 permettant l’import d’auteurs avec le nom comporte une virgule comme SMITH, Robert
version 3 Février 2013 Version SPIP 3
version 2.3 Juillet 2010 Gestion des liens de traduction
Ajout des champs s2s_url, s2s_url_trad à la table spip_articles
support des balises <multi>
version 2.2 Juillet 2010 Import/export des mots-clés des articles et événements
flux version 1.8
version 2.1 Mai 2009 Meilleure gestion des retours à la ligne (flux version 1.7)
version 2.0 Janvier 2009 Sortie de la version compatible SPIP 2
Abandon du mode synchronisation
version 1.7 Mai 2008 Intégration de cfg
version 1.6 Mai 2008 Intégration des objets événements (plugin agenda)
version 1.5 Février 2008 Sortie la version plugin

Alternative

Notes

[1] Notez bien que cette source est conservée même à travers des importations en cascade ; par exemple un site A qui importe depuis B qui lui-même importe depuis C : le site A a bien l’information que tel article vient du site C. Cas d’usage : centraliser des articles d’une galaxie de sites pour qu’ensuite des membres de cette galaxie récupèrent certains des articles sélectionnés

Discussion

5 ans 1 an 3 mois Sans limite
Par date
Filtrer

69 discussions

  • 4
    Spidermian

    Ayant mis un motcle spip2spip sur un article de mon site je ne vois pourtant rien apparaitre dans le flux xml de spip2spip. j’ai oublié quelque chose ou bien ?

    • Spidermian

      heu... y a quelqu’un ?

    • erational

      oui il y a des gens .... et tu as une URL que l’on puisse t’aider ?

    • Spidermian

      Voici ce qu’affiche la page /spip.php ?page=backend-spip2spip

      <!-- backend utilisant SPIP2SPIP   -->
<spip2spip version="1.9">
<title>Archives 2000-2018</title>
<link>http://archives.monsite.com/</link>
<!-- thématiques proposées -->
<thema>072018</thema>
<thema>062018</thema>
<!-- derniers articles à synchroniser -->
</spip2spip>

      j’ai environ 1000 articles par mot clé la ca n’en affiche aucun.
      je suis sur SPIP 3.2.1 SVN [24090]

    • Spidermian

      Ok...
      Je viens de virer le age<7 de la boucle
      et maintenant ca fonctionne...

      merci pour votre aide ;)

    Répondre à ce message

  • 3

    Bonjour,

    Ma config : importation d’articles d’un site Spip 1.9.2 vers un site Spip 2.
    Dans cette configuration, l’importation d’un tableau |xxx|xxx| etc. ne conserve pas totalement la mise en page d’origine.

    Je me suis aperçu que le tableau est importé normalement comme une chaine de caractère mais qu’un espace est ajouté après le dernier “pipe” d’une ligne. Cela a pour effet de ne pas revenir à la ligne et le tableau n’est pas interprété correctement. Ainsi, vous récupérez votre tableau à l’identique de celui-ci :

    |ligne 1 avec un espace après le dernier pipe|xxx| |ligne 2 avec un espace après le dernier pipe|xxx| |ligne 3 avec un espace après le dernier pipe|xxx|

    Vous pouvez faire un copier - coller des lignes ci-dessus dans un article pour voir de quoi je parle.

    Il vous suffit d’éliminer ces espaces en trop pour retrouver votre tableau sous sa forme originale.

    Je ne dis pas que le problème vienne du plugin, c’est juste un constat.

    Philippe G.

    • erational

      pour les tableaux, il s’agissait d’un bug sur les déclarations de fin de ligne. (\n au lieu de \n\n)
      cela a été corrigé dans la version 2.1 de SPIP2SPIP (mai 2009) (uniquement pour des syndications de SPIP2 à SPIP2 avec cette version)

      cordialement

    • laëtitia

      Bonjour,
      j’ai le même problème avec Spip2Spip 2.4.5 en émetteur et Spip2Spip 3.2.3 en récepteur, un satané espace se faufile à la fin de la ligne, derrière le pipe.

    • Yohooo

      Le problème existe toujours pour Spip 3.2

    Répondre à ce message

  • 1
    julien

    Bonjour,

    Est-il possible que l’article importé se mette à jour automatiquement quand l’article de base est mis à jour ?

    Merci.

    Répondre à ce message

  • 2
    chris

    Bonjour

    Mes articles sont bien envoyés du site A vers le site B avec les logos d’articles mais pas les images de contenus. Dans mon article A j’écris

    <doc10>

    celui-ci disparait du même article poussé sur le site B. Je n’ai que du texte, si j’ajoute des balises html, elles disparaissent aussi, c’est normal ?

    L’url de mon flux :
    http://dev16.chris.mezcalito.net/spip.php?page=backend-spip2spip

    Merci de votre aide.

    • chris

      meme avec

      define(’_SPIP2SPIP_IMPORT_HTML’, true) ;
      define(’_SPIP2SPIP_RECUPERER_DOC’, true) ;

    • chris

      Pour le html j’ai réglé avec ça
      define(’_SPIP2SPIP_IMPORT_HTML’, true) ;

      mais pour les images, même si je met ça
      define(’_SPIP2SPIP_RECUPERER_DOC’, true) ;
      ça ne fait rien.

    Répondre à ce message

  • Stéphane Santon

    Bonjour,

    Un petit bug il me semble :
    Dans le site cible, je crée une rubrique sans aucun article.
    J’y importe quelques articles du site source qui sont publiés automatiquement.
    Eh bien la rubrique n’a pas été publiée bien qu’elle a reçu des articles publiés.
    En dépubliant/republiant un article importé, la rubrique apparaît alors publiée.

    Répondre à ce message

  • 2
    Teenoo

    Bonjour,

    j’essaie de faire fonctionner le plugin sur un intranet/extranet (faire une petite passerelle) :) même en étant connectée la page backend-spip2spip n’affiche pas les articles dont j’ai attribué un mot-clé. Comment cela se fait-il ?

    Outre cette page à ouvrir à « tous », il y a t’il un autre élément à ouvrir via pipeline pour la récupération ?

    Merci :)

    • Teenoo

      Bon j’ai corrigé mon erreur ça marche presque bien ! J’ai juste un soucis d’import des documents, l’URL est bien dans le fichier backend mais rien n’atterrit dans l’article importé... J’ai forcé dans les options avec un true.

      Comment ça se fait ?

    • Teenoo

      Je me demande s’il n’y a pas un bug lors de la récupération, j’ai aussi le soucis avec les événements qui ne sont pas incorporés alors qu’ils sont bien dans le fichier XML... Comment corriger cela ?

    Répondre à ce message

  • Jean-Benoît RICHARD

    Bonjour !

    Je crois avoir repéré un petit bug.

    Lors de l’échange de données entre deux sites, je constate que les champs #DESCRIPTIF et #ADRESSE d’un événement associé à un article sont mal filtrés : les balises ne sont pas supprimées, en dépit du filtre |texte_backend présent dans le squelette générateur du fichier .xml.

    La seule raison qui peut expliquer cela c’est que dans un traitement en amont les caractères < et /> sont traduits en & l t ; p & g t ; et & l t ; / p & g t ; et que donc, ils échappent au filtre.

    Effet de bord, le filtre |spip2spip_respecte_ln n’a aucun effet sur ces champs.

    Conséquence, le contenu de ces champs nécessite une correction manuelle avant d’être publiables.

    C’est grave, docteur ?

    NB : propositioin d’amélioration : il me semblerait judicieux d’ajouter la suite de filtres liens_absolus|spip2spip_respecte_ln|spip2spip_respecte_img|texte_backend sur le champ #DESCRIPTIF car ce champ est conçu pour recevoir du texte avec des raccourcis SPIP.

    Je le ferais volontiers moi-même, malheureusement ces correctifs sortent beaucoup du champ de mes compétences.

    Répondre à ce message

  • jeanmarie

    Salut,

    je rencontre un problème en PHP 7.0.15 : les articles sont bien importés mais pas les documents, ni les évènements, ni les mots clefs.
    Sans rien changer à la config SPIP2SPIP du site cible, si je passe l’hébergement en PHP 5.6.30, tout se passe bien.
    J’ai commencé à regarder dans les logs, mais je n’y comprends pas grand chose...

    Ma config : SPIP 3.1.4 + tous les plugins à jour.

    Une idée d’où ça peut venir ?

    Merci

    Répondre à ce message

  • RealET

    Bonjour,

    Je rencontre un problème avec ce plugin et les vidéos insérées par le plugin Vidéos.

    En effet, ce plugin a un fonctionnement non standard pour les documents et remplis les champs de spip_documents avec par exemple :

    • extension : dist_youtu
    • media : video
    • fichier : oavMtUWDBTM alors que l’on a saisi : https://www.youtube.com/watch?v=oavMtUWDBTM
    • et il associe une vignette automatiquement qui elle est bien dans distant/jpg/hqdefaultjpg54b4.jpg

    Bref, dans le cas de ce plugin Vidéos, il faudrait changer le flux RSS de SPIP2SPIP et en tenir compte dans inc/spip2spip.php vers les lignes 125 et suivantes.

    Qu’en penses-tu ?

    Répondre à ce message

  • 2
    jeanmarie

    Salut erational,

    (je crée un nouveau sujet pour plus de lisibilité mais c’est en lien avec nos échanges de juin)

    Lorsque l’on importe les articles avec un statut proposé par défaut, les documents sont bien attachés à l’article importé mais les fichiers correspondants ne sont pas rapatriés en local (dans IMG/distant) automatiquement, c’est à la publication de l’article qu’ils le sont.

    Par contre, même s’ils sont bien présents dans IMG/distant (après publication de l’article donc), l’adresse des fichiers reste l’adresse sur le site d’origine dans la base.
    C’est le comportement normal ?

    Le problème, c’est que si il y a des modifs sur le site d’origine (suppression du doc...) on le perd également dans l’article importé.

    Merci,

    jean marie

    • jeanmarie

      je corrige mon message : les fichiers sont bien rapatriés dans IMG/distant même si les articles importés sont en statut proposé par défaut. Il y a dû avoir une merdouille dans mes tests.

      Par contre, c’est bien l’url du site d’origine qui est indiqué dans la base.

    • jeanmarie

      Hello,
      les fêtes n’étant sans doute pas le moment le plus propice, je retente un petit up maintenant que c’est plus calme...
      merci

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

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

Dernière modification de cette page le 29 septembre 2018