Plugin csv2auteurs: gestion des auteurs à partir de fichiers CSV (version de csv2spip pour SPIP 3)

Ce plugin permet la gestion des utilisateurs de SPIP en masse à partir de fichiers csv.
Nouveautés de cette version:

  • la possibilité d’exporter la base spip_auteurs
  • la gestion de tous les champs de la base spip_auteurs y compris les champs extras
  • la possibilité d’importer plusieurs rubriques pour un même administrateur
  • la gestion des zones d’accès restreint des utilisateurs

Installation

Ce plugin s’installe comme tous les plugins de SPIP, il ajoute un lien “csv2auteurs” dans l’onglet Maintenance.

Format des fichiers CSV

Pour ce plugin, par défaut, le séparateur de champs pour l’exportation ou l’importation est “§”. L’interface d’importation vous permet de choisir un autre caractère.
Fichier modèle pour l’importation: Fichier CSV type pour importation avec mots de passe, rubriques administrées et zones d’accès
Plus de détails sur le format de fichier CSV: voir http://fr.wikipedia.org/wiki/Comma-....

Exportation

Sélectionnez les champs que vous voulez exporter:
Par defaut, 4 champs sont obligatoires :

  • nom
  • email
  • login
  • statut

3 champs ne sont pas exportables.

  • pass
  • alea_actuel
  • alea_futur
Détail des options de configuration pour l'exportation
Détail des options de configuration pour l’exportation

Cliquez sur Lancer la moulinette: vous obtiendrez un fichier CSV qui comprend 2 colonnes en plus de celles sélectionnées:

  • une colonne ss_groupe correspondant aux sous-rubriques administrées pour les auteurs administrateurs de rubriques
  • une colonne zone (si le plugin Accès Restreint est activé) avec le nom des zones auxquelles appartient l’auteur.

Importation

Avertissement !
L’importation réalise la modification d’un grand nombre d’éléments de votre SPIP simultanément: en cas d’erreur vous ne pourrez PAS revenir en arrière sinon par restauration d’une sauvegarde ANTÉRIEURE:
avant toute importation, vous DEVEZ faire une sauvegarde de votre base de données!

Note: par sécurité il n’est pas possible d’importer ou de modifier des administrateurs complets.

I. Caractéristiques du fichier à importer

  • Fichier au format: csv
  • Séparateur de champ : au choix (§ par défaut)
  • Encodage : UTF-8
  • Ordre des colonnes : libre
  • Le fichier doit avoir une colonne d’en-tête avec le nom des champs.
  • Champs obligatoires :
    • nom
    • login
    • statut:
      • administrateurs: administrateur
      • auteurs: redacteur
      • visiteurs: visiteur
    • email
  • Champs optionnels :
    • pass: le mot de passe de l’utilisateur
    • ss_groupe pour les rubriques des auteurs administrateurs de rubriques: en cas de plusieurs rubriques il faut les séparer par un “|”
    • zone pour le nom des zones (plugin Accès Restreint): en cas de plusieurs zones pour un utilisateur, il faut les séparer par un “|”
      _Attention, les zones doivent déja exister: il est donc nécessaire de les créer avant de faire l’importation.
    • tous les champs supplémentaires de la table spip_auteurs créées par des plugins ou par le plugin Champs extras

Exemple:

nomemailloginstatutss_groupezonepass
Aurelia Sept parent07.aurelia@laposte.net PARENT07 visiteur parent07
Anne Cinq parent05.anne@laposte.net PARENT05 visiteur parent05
Nadia Un eleve01.nadia@laposte.net ELEVE01 redacteur Intranet lycée Truc eleve01
Guillaume Deux eleve02.guillaume@laposte.net ELEVE02 redacteur Intranet lycée Truc eleve02
Janique Trois eleve03.janique@laposte.net ELEVE03 redacteur Intranet lycée Truc eleve03
Isabelle Neuf PROF09 administrateur Histoire|Géographie|Salle des profs Intranet lycée Truc|Reserve profs prof09
Laurence Dix prof10.laurence@laposte.net PROF10 administrateur Italien|Salle des profs Intranet lycée Truc|Reserve profs prof10

II. Organisation de l’interface

Cadre 1
Formulaire de sélection du fichier csv

Cadre 2 - Mise à jour des utilisateurs existant dans SPIP
1. Mettre à jour les utilisateurs :

  • Si “Non” csv2auteurs prendra en compte seulement les nouveaux auteurs.
  • Si “Oui” csv2auteurs ajoutera les nouveaux auteurs et mettra à jour les existants.

2. Gestion des rubriques administrées et des zones d’accès des utilisateurs existants :

  • Si “Remplacer” : Toutes les rubriques administrés ou les zones restreintes d’un auteur en bdd à mettre à jour seront remplacées par celles présentes dans le fichier csv
  • Si “Ajouter” : Toutes les rubriques administrés ou les zones restreintes d’un auteur en bdd à mettre à jour seront ajoutées à celles présentes dans le fichier csv.

Cadre 3 - Suppression des absents
1. Traitement des auteurs absents sans articles :

  • suppression complète : suppression de la bdd.
  • passer à la poubelle : change le statut d’un auteur en 5poubelle

2. Administrateur / Rédacteur / Visitieur : on peut choisir pour chaque statut un traitement différent.
Traitement des articles des auteurs effacés :

  • Ne rien faire : les articles garderont (si existant) les autres auteurs, ou ????
  • Supprimer les articles des auteurs effacés : Attention les articles seront supprimés de la bdd
  • Transférer les articles dans une rubrique d’archives : On peut donner le nom de la rubrique qui sera créée ainsi que le nom de sa rubrique parente

Cadre 4 - Création de rubriques pour les sous-groupes administrateurs
Lorsqu’on insère des auteurs avec le statut administrateur, on peut choisir dans quelle rubrique parente seront créées les rubriques administrées.

Astuces

1. On veut supprimer tous les auteurs de la bdd sauf les administrateurs complets : il suffit d’importer un fichier avec seulement la ligne d’entete et selectionner :

  • mise à jour des utilisateurs
  • suppression des auteurs absents (visiteurs, redacteurs, administrateurs)

2. On veut simplement ajouter des NOUVEAUX auteurs : un selectionne un fichier csv et on valide le formulaire en laissant les options par défauts.

updated on 6 April 2020

Discussion

12 discussions

  • 1

    Bonjour,

    est-il possible en IMPORTATION, d’intégrer une colonne avec 1 article (via l’id_article) créé par l’auteur ?

    merci pour l’info/aide

    Seb

    • cela est possible si cet id_article appartient à la table spip_auteurs. Cela implique donc que tu ait au préalable ajouté ce champ id_article dans la table spip_auteurs (avec le plugin champs_extra par exemple).
      Si le champ id_article à importer ne fait pas partie de la table spip_auteurs alors il va falloir que tu surcharge la fonction d’importation du plugin csv2auteurs:
      - dans le fichier .../squelettes/mes_fonctions.php copie de la fonction formulaires_csv2auteurs_importation_traiter_dist() du fichier formulaires/csv2auteurs_importation.php que tu renomme en formulaires_csv2auteurs_importation_traiter()
      - adaptation du php de cette fonction pour gérer l’intégration en base de ton champs id_article selon tes contraintes

    Reply to this message

  • 2

    Salut les amis,
    ne faudrait-il pas profiter de ce passage en SPIP 3 pour changer le nom (et le préfixe) du plugin, par exemple en : “csv2auteurs” ?

    Parce que là on a l’impression que c’est un outil générique pour “gérer du CSV dans SPIP”, alors que ce n’est “que” autour de la gestion d’auteurs.

    Désolé de ne poser cette question que maintenant, mais je n’arrive pas toujours à tout suivre à 100%. :)
    (Bien que j’ai déjà fait cette remarque sur IRC il y a environ un an, un truc comme ça.)

    Reply to this message

Ajouter un commentaire

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