Page de documentation des Saisies

Depuis la version 2.18.21 du plugin Saisies, il est possible de consulter depuis l’espace privé une page listant toutes les saisies disponibles pour le générateur de formulaires.

Préambule

Cette page de documentation est générée grâce aux fichiers “YAML” associés à chaque champ disponible. C’est donc l’équivalent de ce que vous retrouverez depuis votre générateur de formulaires tel que le plugin Formidable, les onglets en moins.
A partir de SPIP 3.1, cette page est accessible depuis le menu “Développement” à activer dans nos préférences de l’espace privé.

Nécessite

Pour la page /ecrire/?exec=saisies_doc et la lecture des fichiers YAML, le plugin idoine (YAML) doit être actif. Sans cela, aucune information ne sera visible sur la page.
Ce plugin s’installe comme tous les plugins par l’intermédiaire du gestionnaire de plugins de SPIP. Merci de vous référer à la page dédiée.

Liste des saisies affichées

Le plugin Saisies offre quelques champs que l’on peut utiliser dans un générateur de formulaires. Voici la liste des saisies documentées sur la page /ecrire/?exec=saisies_doc

  • Auteurs (auteurs)
  • Case unique (case)
  • Cases à cocher (checkbox)
  • Date (date)
  • Destinataires (destinataires)
  • Adresse email (email)
  • Explication (explication)
  • Groupe de champs (fieldset)
  • Champ caché (hidden)
  • Ligne de texte (input)
  • Mot-clé (mot)
  • Oui ou non (oui_non)
  • Boutons radios (radio)
  • Sélecteur d’article (selecteur_article)
  • Sélecteur de document (selecteur_document)
  • Sélecteur de rubrique (selecteur_rubrique)
  • Sélecteur d’article ou rubrique (selecteur_rubrique_article)
  • Liste déroulante (selection)
  • Sélection multiple (selection_multiple)
  • Bloc de texte (textarea)

Champs supplémentaires

Si un nouveau plugin offre de nouvelles saisies, la documentation s’étoffera elle aussi de ses nouveaux champs sans aucune autre action de votre part que l’activation dudit plugin. Tout cela est possible grâce au couple html/yaml propre au fonctionnement du plugin Saisies :

  • nom_champ.html
  • nom_champ.yaml

Si un champ n’est pas disponible dans la documentation depuis l’espace privé, il y a de grandes chances que le fichier yaml soit inexistant.

Discussion

One discussion

  • 5

    bonjour,
    j’utilise la saisie choisir_objets. Je peux bien exclure un objet mais je ne trouve pas la syntaxe pour exclure plusieurs. pourriez me l’indiquer merci.

    [(#SAISIE{choisir_objets, exemple,
                    label=<:parametrage_pages:cfg_exemple:/>,
                    explication=<:parametrage_pages:cfg_exemple_explication:/>,
                    exclus=spip_pages
                   
                    })]
    • merci pour cette réponse rapide
      cela fonctionne bien avec

      [(#SAISIE{choisir_objets, exemple,
                                      label=<:parametrage_pages:cfg_exemple:/>,
                                      explication=<:parametrage_pages:cfg_exemple_explication:/>,
                                      exclus=#LISTE{spip_pages,spip,spip_pages_parametres}
                                      
                                      })]
                                      
    • merci pour cette réponse rapide
      exclus fonctionne bien pour exclure les objets de mon plugin avec

      [(#SAISIE{choisir_objets, exemple,
                                      label=<:parametrage_pages:cfg_exemple:/>,
                                      explication=<:parametrage_pages:cfg_exemple_explication:/>,
                                      exclus=#LISTE{spip_pages,spip,spip_pages_parametres}
                                      
                                      })]
                                      

      mais si on veut que les objets de spip standard .... il faut-il exclure tous ceux des plugins activés ou il y a t-il une saisie spécifique ?

    • a ma connaissance il n’existe pas de liste standard, d’autant que les objets standards de spip sont dispatcghés en plein de plugins dist

    • après je pense qu’il y aurait moyen d’obtenir automatiquement la liste des l’ensemble des objets, puis avec le filtre php array_diff, obtenir une liste des objets à “pas de base” à exclure.
      mais pas trop le temps de fouiller. je t’invite à regarder du cote de code.spip.org qui permet de chercher les fonctions (et donc potentiels filtres) interne à spip

    Reply to this message

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

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