Partageur

Permet de recopier facilement des articles d’un site SPIP partageur à l’autre.

Présentation

Ce plugin est né d’un besoin de partager des articles entre sites SPIP.

Contrairement aux plugins SPIP2SPIP, Flux RSS en articles le principe d’import n’est pas basé sur la syndication automatique mais sur une sélection manuelle. Une fois installé, le plugin permet de “piocher” dans les articles des bases documentaires que l’on a préalablement inscrites.

Installation

Télécharger et installer comme un plugin habituel
Ce plugin nécessite l’utilisation du plugin Config (CFG)

Une fois activé, le site devient partageur.
Tous les sites qui utilisent «partageur» peuvent recopier vos articles publiés.

Techniquement, l’installation du plugin provoque:

  • La création d’une table spip_partageurs stockant les sites partageurs
  • L’ajout de deux champs supplémentaires sur la table spip_articles qui peuvent être exploités éventuellement dans un squelette, dans une boucle ARTICLES (ces champs sont communs avec le plugin Spip2Spip)
    • #S2S_URL l’adresse de l’article d’origine
    • #S2S_URL_TRAD l’adresse de la traduction de l’article d’origine
  • L’activation d’un flux au format Spip2Spip sur tous les articles publiés. L’adresse de ce flux est http://tld.org/spip.php?page=backend-partageur&id_article=XXX

Configuration

Dans le panneau de configuration vous pouvez définir les options d’export / import

  • Clé d’authentification (voir détails au chapitre suivant)
  • Faut il exporter les mots-clés de votre article ? si oui de quels groupes ?
  • Statut des articles importés: «Proposé» ou «Publié»
  • Mots-clés:
    • Faut-il importer les mots-clés d’articles ?
    • Faut-il importer les mots-clés d’événements ?
    • Si oui, où et comment faut-il importer ces mot-clés ?

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('_PARTAGEUR_RECUPERER_CONTENU', false);
define('_PARTAGEUR_RECUPERER_DOC', false);

Clé d’authentification

Par défaut, une fois que vous activez le plugin partageur, tous les sites peuvent potentiellement récuperer tous vos articles publiés.

Ceci peut s’avérer génant et un peu intrusif. C’est pourquoi nous avons introduit un système de clé d’authentification, par exemple si vous ne souhaitez diffuser vos articles à un groupe restreint de sites d’amis.

Dans ce cas, il faut définir dans le panneau de configuration une clé (au choix). Ensuite il suffit de donner cette clé aux sites qui veulent récupérer vos articles.

Exemple d’utilisation

Ce plugin n’est accessible qu’aux administrateur du site

Étape 1: Inscrire vos sites partageurs
Dans le menu édition de votre site, aller sur le “Partageur”

Dans cette section, vous pouvez ajouter et supprimer les sites partageurs

La clé d’authenfication n’est nécessaire que sur les sites sur lesquels une clé est activée.

Attention: Pour inscrire un site partageur, il faut que ce site ait aussi installé le plugin partageur. C’est à dire que son flux partageur http://tld.org/spip.php?page=backend-partageur&id_article=XXX soit accessible.

Étape 2: Aller sur la rubrique dans laquelle vous voulez ajouter des articles
En bas à droite de votre rubrique se trouve le bouton d’import

Étape 3: Choisir l’article du site distant que vous voulez importer
Il est possible de sélectionner l’article en naviguant dans l’arborescence du site ou alors en utilisant le moteur de recherche

Étape 4: Importer votre article

  • Par défaut, votre article importé a le statut “Proposé à la publication”
  • Le plugin recopie le texte (au format SPIP), les auteurs, les documents, logos et événements (si vous avez le plugin agenda), les liens de traductions.
  • Si l’article est déjà présent sur votre site, le plugin n’importe pas l’article et vous prévient.

Avertissement

Attention de ne pas abuser de la recopie d’articles sous peine de se voir bannir des moteurs de recherche pour Duplicate content.

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 :
    1. <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 :
    1. [(#VAL{#S2S_URL_SITE_DISTANT?page=inc_pour_inclusion_distante&id_article=#S2S_ID_ARTICLE_DISTANT}|recuperer_url_cache|table_valeur{page})]

Footnotes

[1Notez 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

updated on 2 October 2019

Discussion

31 discussions

  • Spidermian

    Bonjour,

    Lorsque je veux afficher un sites partagé
    J’ai cette erreur dans Spip

    Erreur SQL 1054
    Unknown column ’partageurs.date’ in ’where clause’
    SELECT id_partageur FROM spip_partageurs AS `partageurs` WHERE (partageurs.statut = ’publie’) AND partageurs.date<’2019-11-08 00:00:00’ AND partageurs.id_partageur=1

    et

    Erreur SQL 1054
    Unknown column ’partageurs.date’ in ’where clause’
    SELECT id_partageur FROM spip_partageurs AS `partageurs` WHERE (partageurs.statut = ’publie’) AND partageurs.date<’2019-11-08 00:00:00’ AND partageurs.id_partageur=1

    L’erreur viendrait de la ligne 1005 du fichier public/composer.php
    dans la boucle calculer_select() sql_select();

    En vérifiant la base de données il n’y a effectivement pas de colonne date
    mais par contre une colonne maj

    Merci de m’éclairer...

    Reply to this message

  • Bonjour,

    Comment importer les événements ?

    Le plugin recopie le texte (au format SPIP), les auteurs, les documents, logos et événements (si vous avez le plugin agenda), les liens de traductions.

    Les événements ni les documents sont importés, seulement l’article ?

    Reply to this message

  • Partageur est facile d’emploi....mais si les textes sont bien transférés, ce n’est pas le cas des documents (images illustrant les textes) qui n’apparaissent pas après le transfert. Qui peut me donner une piste de dépannage ?

    Reply to this message

  • 1

    Bonjour,
    J’ai deux sites hébergés sur les pages perso free.
    Je voulais récupérer des articles d’un site sur l’autre avec le plugin partageur installé sur les deux sites:
    Chargement du plugin: ok
    paramétrage: ok ’sauf erreur de ma part

    j’ai bien validé dans configuration/contenu du site “sites partageurs”
    J’ai le message suivant dans l’ajout d’un site partageur
    voir pièce jointe.

    Si quelqu’un à la réponse à mon problème, je suis preneur
    Merci d’avance,
    André

    • Free bloque la possibilité d’interroger un site web distant.
      Ce qui prive SPIP de :

      • installation et mise à jour des plugins
      • aide en ligne
      • documents distant
      • oEmbed
      • partageur
      • linkcheck
      • ...

      C’est gratuit, mais c’est limité…

    Reply to this message

  • 3
    Benji

    Bonjour,
    Question de débutant : j’ai besoin de récupérer une partie des articles d’un ancien site pour les réinjecter dans une nouvelle version du même site. Est-ce que je peux utiliser partageur, sachant qu’une fois l’importation effectuée, je désactiverai le plugin et supprimerai le site “source”.
    Est-ce que mes articles importés seront toujours là ?
    Je vous remercie des réponses que vous pourrez m’apporter.

    • Bonjour,

      Oui, partageur fait une copie complète dans le site de destination.
      L’ancien site peut donc disparaître.

    • Benji

      Génial ! Merci beaucoup de votre réponse hyper rapide !

    • J’ai le meme objectif de copier un ancien site puis le supprimer, Mais dans mes tests en local je remarque que le fichier pdf attache de l’article est importe en tant que ’fichier distant’ et je dois cliquer sur modifier puis copier dans le site pour l’avoir dans mon dossier IMG. Est-ce normal ?

    Reply to this message

  • 3

    merci pour le plugin messieurs, celui ci va me faire gagner pas mal de temps en mutu pour dispatcher rmes publications :-)

    En revanche il y a un glitch : dès qu’on sélectionne une clée d’authentification vraiment efficace (comprendre par là, avec tout ce qui fait une clée efficace: MAJ min symboles à coucher dehors, etc ...) le plugin choucroute et ne permet pas de retrouver dans le privé les flux des sites partageurs

    Pour info j’ai généré ma clée avec ça (la config est contractuelle - cf captures)

    Reply to this message

  • Bonjour,

    Sur un de mes sites, les pages /ecrire/?exec=partageur&id_partageur=XXX ont ce message d’erreur :


    -  message Erreur SQL HY000 / 1 no such column: partageurs.date
    -  squelette SELECT id_partageur FROM spip_partageurs AS ’partageurs’ WHERE (partageurs.statut = ’publie’) AND partageurs.date<’2018-07-19 11:31:00’ AND partageurs.id_partageur=3
    -  boucle /var/www/htdocs/monnomdomaine/public/ecrire/public/composer.php calculer_select() sql_select();
    -  Ligne 1005

    Et quand je veux apporter un article d’un site partagé, sur une rubrique comme : ecrire/?exec=partageur_add&id_rubrique=3 , j’ai “Aucun site partageur disponible”, alors que j’ai bien déclaré le partage des deux côtés.

    j’ai spip 2.0 et partageur 1.1.1
    Sur l’autre site (même spip et même plugin), ici le site source, je n’ai pas ce message d’erreur, mais quand je clique sur un site partagé, ça m’envoie sur le site au lieu d’avoir la liste des articles.

    J’ai désactivé/résinstallé Partageur des deux côtés, mais ça n’a rien changé.
    Peut-être faut-il tenter désinstaller/réinstaller ?

    merci pour les pistes éventuelles

    Reply to this message

  • 2

    Bonjour, et merci pour ce super plugin. Quand le plugin sera-t-il portable pour la version 3.2 de SPIP ?

    • Le plugin est peut être déjà compatible... Il faudrait tester en modifiant manuellement ses bornes à SPIP 3.2 et en vérifiant s’il fonctionne ou non.
      Merci de vos retours

    • Je viens de passer le plugin à SPIP 3.2.
      Le zip devrait être disponible d’ici quelques heures.

    Reply to this message

  • Bonjour,
    Pourrait-on préciser sur cet article l’adresse de flux utilisée pour obtenir la liste d’articles disponibles ?
    Pas celle d’un article particulier http://tld.org/spip.php?page=backend-partageur&id_article=XXX, mais l’arbo (?) de tous les articles.
    Merci

    Reply to this message

  • Stéphane Santon

    Bonjour,
    Extra ce plugin ! Bravo !

    Un petit bug :
    Dans un article j’ai [<emb20>->doc20] ,
    sur l’import ça devient [->doc20]

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom