SPIP

#FORMULAIRE_SIGNATURE

David Sánchez Crespillo — 2009-07-17T15:30:38Z

- #FORMULAIRE_SIGNATURE construye y muestra el formulario que permite firmar la petición asociada a este artículo.

#ID_ARTICLE

David Sánchez Crespillo — 2009-07-17T15:30:27Z

- #ID_ARTICLE muestra el identificador único del artículo. Útil para fabricar enlaces de hipertexto no previstos (por ejemplo, hacia una página “Mostrar en formato para impresión”).

#SQUELETTE

David Sánchez Crespillo — 2009-07-17T15:30:02Z

Introducido en SPIP 1.9.1, #SQUELETTE devuelve la ruta del esqueleto que se está utilizando actualmente.

#PARAMETRES_FORUM

David Sánchez Crespillo — 2009-07-17T15:29:41Z

- #PARAMETRES_FORUM construye y muestra la lista de las variables explotadas por el formulario que permiten responder a este artículo. Por ejemplo:

Desde SPIP 1.8.2, se le puede pasar un parámetro que especifique la dirección de retorno después de haber enviado el mensaje. Por ejemplo: Responder a este artículo reenviará al visitante a la página actual una vez que el mensaje haya sido validado.

Histórico: En las versiones anteriores a SPIP 1.9 habría sido necesario escribir forum.php3? y no spip.php?page=forum

#URL_ARTICLE

David Sánchez Crespillo — 2009-07-17T15:19:40Z

- #URL_ARTICLE muestra la URL de la página del artículo.

{tout}

David Sánchez Crespillo — 2009-07-17T15:18:52Z

- {tout}: los artículos son seleccionados en la totalidad del sitio (en todas las secciones). Útil especialmente para mostrar los artículos más recientes (de todo el sitio) en la página de inicio. [En realidad, el criterio «tout» no se trata informáticamente: es un recordatorio para el webmaster; se obtiene el mismo resultado si no se indica ninguno de los criterios siguientes.]

Las autorreferencias multilingües de la documentación

David Sánchez Crespillo — 2009-07-14T09:03:20Z

Ya que la versión SPIP 2.0 ha introducido la posibilidad de sobrecargar el tratamiento de hreflang de los atajos tipográficos, el presente sitio dedicado a la documentación multilingüe de SPIP ofrece actualmente un método sencillo para referenciar sus propios artículos.

Anteriormente, cuando un artículo A referenciaba un artículo B de la documentación, quienes lo traducían se encontraban ante una situación insatisfactoria y propicia al olvido. Se traducía primero A y se obtenía otro artículo, llamémosle C, dentro del cual se dejaba la referencia a B, sin tener todavía la URL de la traducción de B, ya que aún no existía. Durante el tiempo que esta traducción, llamémosle D, era realizada y publicada, era muy fácil olvidar que C contenía una referencia a B que había que reemplazar por D.

En este momento, los redactores de la documentación tienen que utilizar obligatoriamente la notación [{}->artN] para referenciar el artículo N de la documentación, y quienes lo traduzcan pueden copiar este atajo sin necesidad de modificarlo en el futuro. En efecto, si el artículo N no existe en la lengua del texto que utiliza este atajo, éste presentará la URL del artículo N (aquel que sea mejor). En cambio, si existe una traducción, se presentará automáticamente la URL de esa traducción. Más exactamente, este comportamiento se observará estrictamente cuando haya una referencia en el espacio privado, mientras que en el espacio público se añadirá la condición suplementaria de que la traducción esté publicada, para presentar una URL disponible en el acto.

¿Cómo es esto posible? De hecho, hacía ya mucho tiempo que los atajos de SPIP autorizaban la utilización de llaves para especificar el valor del atributo hreflang. No obstante, SPIP 2.0 interpreta además un par de llaves vacías como un hreflang igual al idioma del texto donde figura el atajo. La sobrecarga introducida por este sitio consiste simplemente en buscar si el artículo designado por el atajo existe en el idioma indicado por el hreflang. Si es este el caso, el atajo ->artN se reemplaza por ->artP, donde P es la traducción de N.

Structure HTML des formulaires de SPIP 2

ARNO*, cerdic, Matthieu Marcillaud, romy.tetue.net — 2009-06-27T10:48:14Z

Document de références précisant comment les formulaires dans SPIP doivent être structurés

Structure HTML

Un formulaire de base est ainsi structuré :

Le div englobant porte la classe générique formulaire_spip. Les formulaires d'édition de l'espace privé portent de plus la classe formulaire_editer indiquant qu'on a affaire à un formulaire d'édition de données d'une base.

Le premier fieldset étant optionnel, on peut aussi écrire, sans le fieldset et sans les paragraphes optionnels :

Les classes spéciales

« explication » : pour indiquer un message d'explication (qui porte soit pour l'ensemble des champs, soit sur une étape). Exemple :
.
« attention » : pour afficher un message concernant un champ d'édition critique. Exemple : <:texte_login_precaution:>.
« obligatoire » : pour signaler un champ obligatoire, à appliquer à l'élément de liste parent. Exemple :
.
« erreur » : pour signaler une étape en erreur, à appliquer à l'élément de liste parent. Exemple :
. chaque erreur bénéficie d'un message explicatif, portant la class « erreur_message » : .

Cadre englobant

Ce formulaire peut optionnelement être inclu dans un cadre-formulaire-editer, et peut alors contenir un entete-formulaire :

Gestion des messages réussite/erreur

Messages globaux

Un formulaire comporte obligatoirement deux paragraphes permettant d'afficher les réussites et erreurs globales qui ont pu apparaître à la soumission. Les variables d'environnements message_ok et message_erreur sont des retours envoyés par SPIP (formulaires CVT).

Messages spécifiques

Chaque champ de formulaire, encapsulé dans un li peut recevoir un message d'erreur spécifique. Celui-ci est contenu dans la le tableau d'environnement 'erreurs' et peut être obtenu de la sorte :

On peut attribuer la classe 'erreur' au li et afficher une erreur spécifique si elle existe de la sorte :

Particularités pour les styles css

Champs input

Chaque différent de hidden doit posséder une classe identique à son type (afin de palier à un déficience du navigateur Internet Explorer) :

Boutons de soumission

Les boutons de soumissions sont inclus dans une boîte .boutons (qui peut recevoir plusieurs boutons) :

radio/checkbox

Dans le cas de bouton radio ou checkbox, on peut ne pas reprendre tout a fait la même structure, par exemple pour avoir le bouton avant le label, ou pour avoir la liste radio en horizonal

Chaque entrée (radio + label) peut alors être encadrée par un bloc .choix

Par défaut, la liste est verticale. Pour rendre la liste horizontale, il suffit de spécifier que .champ en question est de type inline :

.formulaire_editer .editer_syndication .choix {display:inline;}

Principes généraux de ces formulaires pour avoir les labels alignés à gauche

On se retrouve dans un cas où l'on a :

1) on applique un padding gauche au LI supérieur à la taille du label (ex:120px)

2) on demande au label d'être flottant et décalé sur la gauche (via un margin négatif)

3) lorsqu'un fieldset suit un li, on le décale aussi vers la gauche (seul IE n'en tient pas compte) pour que le fieldset prenne toute la largeur aussi

#VAL

maieul — 2009-06-18T09:15:46Z

La Balise #VAL prend un paramètre qui est retourné tel quel.

Elle permet par exemple d'appliquer des filtres sur des constantes.

Par exemple [(#VAL{<:chaine_de_langue:>}|image_typo)]

#ARRAY

BoOz, denisb — 2009-06-16T06:52:27Z

La balise #ARRAY définit un tableau au sens php c'est à dire un ensemble de paires clef/valeur. Un #ARRAY permet ainsi le stockage de valeurs indexées et peut être utilisé, entre autre, associé à l'opérateur IN d'une boucle.

- Déclarer un tableau :

#SET{mon_tableau, #ARRAY{clef1,valeur1,clef2,valeur2...}}

- Récupérer la valeur associée à une clef en utilisant le filtre |table_valeur :

[(#GET{mon_tableau}|table_valeur{clef})]

- Remplir un tableau dynamiquement en utilisant le filtre |push :

#SET{mots_choisis, #ARRAY{}}
 
 [(#SET{mots_choisis, #GET{mots_choisis}|push{#ID_MOT}})]

ou encore en forçant la valeur des clefs avec la fonction php utilisée comme filtre |array_merge :

#SET{mots_choisis, #ARRAY{}}
 
 [(#SET{mots_choisis,
 [(#GET{mots_choisis}|array_merge{#ARRAY{
 #COMPTEUR_BOUCLE, #ID_MOT
 }})]
 })]

Attention 1 : le filtre |array_merge ne tient pas compte de la clef à forcer (#COMPTEUR_BOUCLE dans l'exemple ci-dessus) si cette clef est de type numérique. Auquel cas deux solutions :

soit préfixer cette clef avec une valeur alphabétique :#ARRAY{k#COMPTEUR_BOUCLE, #ID_MOT} ;
soit inverser clef et valeur (à condition que valeur ne soit pas elle aussi numérique) puis appliquer la fonction php comme filtre |array_flip sur le tableau final :[(#SET{mots_choisis, #GET{mots_choisis}|array_flip)]

Attention 2 : il faut déclarer le tableau avant son remplissage dans la boucle.

Note 1 : l'ordre de remplissage du tableau est déterminé par l'ordre d'apparition des données dans la boucle, donc est dépendant du ou des critères de tri qui sont appliqués à celle-ci.
Note 2 :[(#GET{mon_tableau}|table_valeur{6})] affichera la valeur associée à la clef numéro 6 du tableau ; c'est-à-dire la 7ème valeur : la numérotation des clefs débutant à zéro.

- Utiliser le tableau dans une boucle avec l'opérateur IN :

...

- Affichage conditionnel en fonction des valeurs d'un tableau :

[(#ENV{page}|in_array{#ARRAY{0,article,1,rubrique,2,site}}|oui)
 Affichage conditionnel ]

autre exemple avec une variable 'lolo' passée dans l'url :
http://le_site/-ma-rubrique-?lolo=6

[ Ceci s'affichera si la valeur de la variable 'lolo' passée dans l'url est présente dans un tableau 'les_mots' déclaré et rempli précédemment
 (#ENV{lolo}|in_array{#GET{les_mots}}|oui)
 celà s'affichera aussi ]

Pour ne pas risquer de générer une erreur « Warning : in_array() [function.in-array] : Wrong datatype for second argument. » dans le cas où la variable passée ne serait pas de type array on pourra utiliser le filtre |in_any qui rattrape l'erreur sans afficher l'alerte, et permet d'afficher une valeur alternative.

[(#VAL{abc}|in_any{#GET{tablo}, truc à faire si GET_tablo n'est pas un array}|oui|?{truc à faire si abc est une valeur de GET_tablo, truc à faire si abc n'est pas une valeur de GET_tablo})]