SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

286 Plugins, 197 contribs sur SPIP-Zone, 263 visiteurs en ce moment

Accueil > Administration et BDD > Forms & Tables > DocumentationFormsTables

DocumentationFormsTables

9 décembre 2006 – commentaires

2 votes

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

Article publié : ces notes et d’autres sont désormais publiées sur SPIP-Contrib ici Forms & tables - carnet de notes, donc il faut mieux y aller pour tout complément


Différence entre un formulaire et une table

-  un formulaire est dédié a la saisie de données dans l’espace public (collecte d’informations) ; les réponses sont stockées pour pouvoir les suivre/gérer/traiter, comme des forums... Ce qui est central ici c’est la collecte d’informations dans l’espace public, et le stockage est seulement destiné à du post-traitement

-  une table est une structure de données destinées à être utilisées dans les squelettes. Ce qui est central ici, c’est les données et leur manipulation pour les afficher dans les pages de l’espace public. La
saisie est juste un moyen de créer/modifier des données, mais pas unique (l’import/export csv en est un autre)

Le socle commun permet de disposer du formulaire de saisie associé, utilisable aussi bien dans l’espace privé que dans l’espace public si besoin. La définition de la structure de la table se fait par la définition de son masque de saisie, c’est-à-dire son formulaire de saisie.

(extrait d’un mail de Cedric sur spip-zone le 07/12/2006)

Pour définir une table, on définit ses champs à travers le
formulaire de saisie.
Chaque champ peut être :
-  spécifiant : il sera considéré comme pertinent pour
trier/filtrer/rechercher les données dans la table
-  public : les données de ce champ sont affichées dans les modeles ,
dans le cas contraire elle ne sont visibles que dans l’espace privé
-  obligatoire : le champ doit être rempli lors de la saisie

Par ailleurs, une aide contextuelle peut être définie pour chaque champ.
Le wrapping html permet de définir des encapsulations des champs dans la
vue donnée (typiquement pour faire du microformat), sur le format :
-  implicite : la donnée est inserée au milieu de l’encapsulation qui
peut comporter plusieurs tags

-  explicite : la donnée est inserée a la place du $1

Le plugin contient un exemple de structure hCard
(snippets/forms/hCard.xml) qui utilise ce format.
Mais la fonctionnalité encore incomplète, il manque la possibilité de
gérer une hiérarchie de div englobants. (Les fieldsets sont utilisés
pour gérer un premier niveau de groupe, mais il est nécessaire de
pouvoir faire des sous groupes, j’y refléchis).

Le hCard.xml contenu dans le plugin est importable à l’aide du plugin
snippets (1.9.2 uniquement) qui permet de gerer des imports/exports des
structure des tables&formulaires en xml. Un formulaire peut etre exporté
et réimporté dans un formulaire existant, auquel cas les champs y seront
ajoutés.

Les types de champ sont personnalisables, il y a un exemple dans
etc/forms_types_champs.xml. Cela permet de définir des formats qui n’ont pas de vocation a être en dur car ne correspondent pas a un besoin général. Pour le moment la vérification de format est limitée a un
preg_match sur une regexp, mais je pense a mettre un pipeline pour
permettre de créer des types de champs plus complexes.

Le plugin csv_import fonctionne avec les tables de forms&tables, et il
permet de faire de l’import/export csv des données (en ajout et mise a
jour si l’id_donnee est fourni).

Les tables définies dans forms&tables sont en fait toutes stockées dans
les mêmes tables physiques. Dans les squelettes, on utilise les boucles
FORMS_DONNEES et FORMS_CHAMPS sur le mode :

la balise #LESVALEURS permet d’éviter une boucle supplémentaire sur
FORMS_DONNEES_CHAMPS. Dans cette dernière boucle, #VALEUR retourne non
le champ sql brut mais la valeur en clair dans le cas ou il s’agit d’un
champ mot clé, select ou multiple. #VALEUR* retourne elle le champ sql brut.

sur la boucle FORMS_DONNEES,
-  le critère tout permet de récupérer les données non validées
-  le critère statut=.. de récupérer les données non publiées (par
défaut seules les données avec le statut publie sont retournées par la
boucle)
-  le critère id_mot=.. de récupérer toutes les données associées à un
mot clé. Cela suppose que la table comporte au moins un champ de type
mot clé

sur la boucle FORMS_CHAMPS
-  par défaut seuls sont retournés les champs public
-  le critère tout permet de récupérer tous les champs

Voila un petit aperçu des fonctionnalités, cela mériterait évidemment
une grosse doc que je n’ai pas du tout le temps de faire en ce moment.
(notamment sur l’utilisation avancée du plugin comme support pour
d’autres plugins : créations de tables sur structure xml, création d’un
type de table supplémentaire pour gérer des tables qui ne soient pas
mélangées avec celles du module tables par défaut, utilisation de l’API
d’interface liste/édition/modification ... des tables ....)

Cedric

Utilisation :

Insertion d’un formulaire dans une article :
Le formulaire créé s’insère dans un champ texte d’article ou de rubrique avec un modèle <formxx>
Voir spip contrib

Insertion des données de table dans un article
Un modèle simple <tablexx> permet d’afficher les données d’un table dans un article.


Premier article de présentation générale initié sur Spip-contrib
puisqu’il faut bien commencer par quelque chose .. c’est la http://www.spip-contrib.net/ecrire/...

vous ètes convié à y participer, soit via le forum de rédac, soit en vous proposant comme (co)rédacteur

Dernière modification de cette page le 3 août 2009

Retour en haut de la page

Vos commentaires

  • Le 26 janvier 2012 à 09:11, par tarentaise En réponse à : DocumentationFormsTables

    Bonjour,

    j’ai créé plusieurs tables qui utilise toutes des champs mots clés. Je cherche à récupérer dans une boucle le numéro du mot clé associé à une réponse pour le passer dans un lien. J’arrive à afficher la valeur ou le titre du mot clé sélectionné mais pas son numéro
    D’avance merci

    Répondre à ce message

  • Le 31 mars 2011 à 14:44, par yasean En réponse à : DocumentationFormsTables

    J’ai crée une table dans spip je voudrais savoir comment on fait pour récupérer les données entrées dans le formulaire par une boucle pour l’afficher dans un article.

    les champs sont :

    nom
    adresse
    tel

    Merci

    Répondre à ce message

  • Le 27 février 2008 à 15:27, par nezy En réponse à : DocumentationFormsTables

    J’ai crée une table dans spip je voudrais savoir comment on fait pour récupérer les données entrées dans le formulaire par une boucle pour l’afficher dans un article.

    les champs sont :

    nom
    prenom
    Email

    Merci

    Répondre à ce message

  • Le 7 janvier 2008 à 15:52, par Nicolas En réponse à : DocumentationFormsTables

    bonjour,

    j’ai créé un formulaire avec des champs téléchargement de fichier, mais je ne retrouve pas mes fichiers téléchargés.
    Comment puis-je faire ?

    merci d’avance

    Répondre à ce message

Répondre à cet article

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 Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Metas +

    3 décembre – 10 commentaires

    Améliorez l’indexation de vos articles dans les moteurs et leur affichage sur les réseaux sociaux grâce aux métadonnées Dublin Core, Open Graph et Twitter Card. Installation Activer le plugin dans le menu dédié. Dans le panel de configuration, (...)

  • Newsletters

    16 janvier 2013 – 378 commentaires

    Ce plugin permet de composer des Info-lettres. Par info-lettre, on désigne ici le contenu éditorial qui va être composé et envoyé par courriel à une liste d’inscrits. Le plugin permet de composer une info-lettre à partir d’un modèle pré-composé, (...)

  • Mode portail Communiquant pour SoyezCréateurs

    29 septembre 2010 – 20 commentaires

    5e mode d’affichage de la page d’accueil, ce mode se distingue des autres par une animation proposant un fondu/enchaîné des logos des articles à la une. Zonage Configuration Zone d’entête Nom du site Slogan si plugin bandeau présent (...)

  • Configurer Sparkpost

    25 avril – 14 commentaires

    N’hésitez pas à relire le préambule de cette rubrique avant de créer un compte sur une plateforme tierce . Présentation Sparkpost est une société d’envoi de mailing https://www.sparkpost.com/ Sur les petits volumes ( <100.000 emails / mois), (...)

  • Plugin Logo SVG : pouvoir utiliser des logos SVG

    17 octobre – commentaires

    Le SVG est un format vectoriel donc très léger et redimensionnable sans pertes, mais SPIP ne l’acceptait pas sur les logos. Ce plugin comble ce manque. Comment ça fonctionne ? Vous installez ce plugin, vous l’activez, et c’est tout. Crédits Une (...)

Ça spipe par là