L’ajout de champs à la table spip_auteurs
Une des principales fonctionnalités d’inscription3 est l’ajout de champs dans la base donnée sur la table spip_auteurs
et leur mise à disposition dans les formulaires d’inscription, de création de compte et de modification de profil.
Dans sa configuration, le plugin Inscription3 permet d’ajouter des champs dans cette table et permet de les différencier dans les formulaires.
En plus de simplement les créer et de les mettre à disposition, il permet de les configurer plus finement en :
- permettant de choisir de les afficher dans le formulaire d’inscription (
#FORMULAIRE_INSCRIPTION
) ; - permettant de choisir de les afficher dans le formulaire de modification de profil (
#FORMULAIRE_EDITER_AUTEUR
) ; - permettant de les rendre obligatoires ;
- permettant de choisir de les afficher comme information dans le tableau des utilisateurs dans l’espace privé ;
La recherche dans les champs ajoutés
Inscription3 ajoute automatiquement les champs que l’on a configuré comme étant visibles dans les champs de recherche pour les auteurs. [1]
Ainsi si on ajoute la ville dans les champs de la fiche, une recherche d’une ville dans le formulaire de recherche de SPIP permettra de tomber sur un auteur.
Il est bien entendu nécessaire d’ajouter de quoi rechercher sur les auteurs dans le squelette de recherche.
Les options spécifiques non stockées en base
Case à cocher assurant le fait de valider un règlement. Cette option peut être reliée à un article (original) spécifique dont le lien sera affiché dans le formulaire. Ce champ dans le formulaire d’inscription est de fait obligatoire, sinon il n’a pas lieu d’être.
Si le site est multilingue et que l’article considéré comme règlement dispose de traductions, on affichera le lien existant pour la langue en cours sinon l’article original.
Si le plugin Mediabox est installé, le lien vers le règlement sera :
- normal pour les personnes ne disposant pas de javascript ;
- en popin pour les autres ;
Si on dispose du plugin "Pages uniques", il est possible de créer une page spécifique avec le champ page "reglement". Cet article sera automatiquement pris en compte et remplacera automatiquement celui de la configuration du plugin (voir cet exemple d’utilisation dans MediaSPIP).
Voir le squelette formulaires/inscription3_reglement.html
pour toute surcharge éventuelle.
Les pipelines du plugin
Le plugin inscription3 définit plusieurs pipelines propres afin que d’autres plugins (ou méta plugins reliant inscription3 à d’autres) puissent s’insérer dans ses fonctionnalités.
Mise en forme des formulaires
Traitement des formulaires
- i3_charger_formulaire : intervient au moment du chargement des champs des formulaires dans lesquels inscription3 s’insère ;
- i3_verifier_formulaire : intervient au moment de la vérification des champs des formulaires dans lesquels inscription3 s’insère ;
- i3_traiter_formulaire : intervient au moment du traitement des champs des formulaires dans lesquels inscription3 s’insère ;
Gestion des champs dans la base et dans les formulaires
- i3_exceptions_des_champs_auteurs_elargis : Sélectionne les champs qui ne doivent pas être créés dans la tables spip_auteurs. Notamment l’ensemble de la table spip_auteurs d’origine (par défaut), mais aussi certains autres qui ne doivent pas être des champs dans la base, mais juste rester dans les métas ;
- i3_exceptions_chargement_champs_auteurs_elargis : Sélectionne les champs qui ne doivent pas être chargés dans le formulaire. Garde les champs de spip_auteurs et ne prends pas en compte les autres ;
Les plugins et librairies nécessaires
Pour son fonctionnement, inscription3 nécessite plusieurs autres plugins :
- Champs extras : contrairement à ses versions précédentes (inscription2), le plugin ne crée plus de table
spip_auteurs_elargis
. Chaque champ est ajouté directement dans la tablespip_auteurs
d’origine via l’API de champs extras 2 ; - L’API de vérification : pour vérifier certains champs spécifiques ;
- Saisies : qui devient également nécessaire à beaucoup de choses ;
Il nécessite également l’installation d’une librairie javascript :
- jquery-validate : permet de vérifier en javascript les données saisies lors de la modification d’informations personnelles via les crayons ;
Les plugins compatibles et utilisés si présents
Les plugins ci-dessous ne sont pas nécessaires au bon fonctionnement d’Inscription3 mais permettent d’y ajouter certaines fonctionnalités :
- Crayons
Le plugin crayons est bien entendu compatible avec inscription3. Il permet de modifier les champs des auteurs. - Open ID
Le plugin Open ID est également directement compatible. Il est utilisé lors de l’inscription et de l’authentification des utilisateurs. - Menus
Le plugin inscription3 fournit un nouvel élément de menu "inscription" permettant d’ajouter facilement un lien vers une page de création de compte du typespip.php?page=inscription
(Cette page est disponible dans le plugin sous la forme d’un squelette pour Zpip). - Le squelette Zpip (et dérivés)
Le plugin fournit une page d’inscription toute faite (cf la partie sur le plugin Menus) permettant à tout individus de se créer un compte sur le site. Cette page suit les conventions de Zpip et est donc directement intégrable dans vos squelettes personnalisés se basant dessus. - Pages uniques
Permet de créer une page spécifique pour le règlement et sa prise en compte automatique dans le formulaire si présent.
cf : la partie sur le règlement - Mediabox (Fourni par défaut avec SPIP >= 3.0.0)
Permet d’ouvrir le règlement du site dans une popin (fenêtre javascript) au lieu de quitter la page du formulaire.
cf : la partie sur le règlement - Notifications
- Facteur