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

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

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 :

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.