Le labo

Bidouilles et prises de notes en vrac

Accueil > Docs > Les formulaires dynamiques dans SPIP 2

Les formulaires dynamiques dans SPIP 2

lundi 2 juin 2008, par b_b

Présentation des nouvelles balises de formulaires disponibles dans SPIP 2.

Bla bla et caractéristiques des nouvelles balises...

  • formulaires dispos dans le public et le privé
  • formulaires pouvant servir à modifier ou à créer un élément

Ces formulaires sont construits à partir des fichier disponibles dans le répertoire dist/formulaires. Pour chaque formulaire on dispose d’un couple de fichier du type : editer_article.html / editer_article.php .

Pour plus d’informations sur le fonctionnement de ces balises lisez l’article AJAX à tous les étages sur spip.net.

#FORMULAIRE_EDITER_ARTICLE

#FORMULAIRE_EDITER_ARTICLE{id_article, id_rubrique, lier_trad, retour}

Paramètres de la balise :

 id_article détermine l’identifient de l’article à modifier. Si celui-ci vaut "oui" le formulaire va créer un nouvel article.
 id_rubrique détermine l’identifient de la rubrique contenant l’article à éditer.
 lier_trad permet d’indiquer que l’article créé est une traduction de celui passé dans le contexte.
 retour permet de définir l’url vers laquelle l’utilisateur sera redirigé une fois le formulaire validé.

#FORMULAIRE_EDITER_BREVE

#FORMULAIRE_EDITER_BREVE{id_breve, id_rubrique, lier_trad, retour}

Paramètres de la balise :

 id_breve détermine l’identifient de la brève à modifier. Si celui-ci vaut "oui" le formulaire va créer une nouvelle brève.
 id_rubrique détermine l’identifient de la rubrique contenant la brève à éditer.
 lier_trad permet d’indiquer que la brève crée est une traduction de celle passée dans le contexte.
 retour permet de définir l’url vers laquelle l’utilisateur sera redirigé une fois le formulaire validé.

#FORMULAIRE_EDITER_RUBRIQUE

#FORMULAIRE_EDITER_RUBRIQUE{id_rubrique, id_parent, lier_trad, retour}

Paramètres de la balise :

 id_rubrique détermine l’identifient de la rubrique à modifier. Si celui-ci vaut "oui" le formulaire va créer une nouvelle rubrique.
 id_parent détermine l’identifient de la rubrique contenant la rubrique à éditer.
 lier_trad permet d’indiquer que l’article crée est une traduction de celui passé dans le contexte.
 retour permet de définir l’url vers laquelle l’utilisateur sera redirigé une fois le formulaire validé.

Exemple d’utilisation pour modifier la rubrique en cours :

[(#FORMULAIRE_EDITER_RUBRIQUE{#ID_RUBRIQUE,#ID_RUBRIQUE,0,[(#SELF)]})]

Et pour créer une rubrique :

[(#FORMULAIRE_EDITER_RUBRIQUE{nouveau,#ID_RUBRIQUE,0,[(#SELF|parametre_url{id_rubrique, #ID_RUBRIQUE})]})]

#FORMULAIRE_EDITER_MOT

#FORMULAIRE_EDITER_MOT{id_mot, id_groupe, ajouter_id_article, table, table_id, retour}

Paramètres de la balise :

 id_mot détermine l’identifient du mot à modifier. Si celui-ci vaut "oui" le formulaire va créer un nouveau mot.
 id_groupe détermine l’identifient du groupe contenant le mot à éditer.
 ajouter_id_article permet d’indiquer ...
 table permet d’indiquer ...
 table_id permet d’indiquer ...
 retour permet de définir l’url vers laquelle l’utilisateur sera redirigé une fois le formulaire validé.

#FORMULAIRE_EDITER_SITE

#FORMULAIRE_EDITER_SITE{id_syndic, id_rubrique, lier_trad, retour}

Paramètres de la balise :

 id_syndic détermine l’identifient du site à modifier. Si celui-ci vaut "oui" le formulaire va créer un nouveau site.
 id_rubrique détermine l’identifient de la rubrique contenant le site à éditer.
 lier_trad permet d’indiquer que le site crée est une traduction de celui passé dans le contexte.
 retour permet de définir l’url vers laquelle l’utilisateur sera redirigé une fois le formulaire validé.

Côté technique

Le code de chaque formulaire est contenu par une balise [(#ENV{editable})]. Ainsi lorsque cette variable retourne false le formulaire n’est pas affiché. Cela permet d’y restreindre l’accès en définissant la variable à false suivant le statut de la personne qui consulte la page par exemple.