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.