Fichier plugins-dist/bigup/bigup_fonctions.php
Fonctions utiles au plugin Big Upload
Plugin
-
Big Upload
Copyright
-
2015
Licence
-
GNU/GPL
Source
Liste des fonctions
À utiliser à l'intérieur d'un formulaire CVT ou dans un fichier de saisies.
Dans une utilisation dans 'saisies/', il faut transmettre form
et formulaire_args
du formulaire pour le calcul.
Le token généré se base sur la valeur de l'attribut name
de l'input que l'on peut recevoir soit :
- en écriture html :
fichiers[images]
- en écriture comprise par Saisies :
fichiers/images
Si l'input est voué à recevoir plusieurs fichiers
(attribut multiple
et name avec []
tel que fichiers[images][]
il faut aussi l'indiquer, soit:
- en écriture html :
fichiers[images][]
- en écriture Saisies :
fichiers/images/
Par habitude d'usage avec le plugin Saisies, on accepte aussi
une forme plus habituelle en transmettant un paramètre multiple
(en 2è paramètre de la balise, valant par défaut #ENV{multiple}
)
indiquant que le token concerne un input recevant plusieurs fichiers.
On l'écrit :
- en écriture html :
fichiers[images]
- en écriture Saisies :
fichiers/images
La balise accepte 4 paramètres, tous automatiquement récupérés dans l'environnement s'ils ne sont pas renseignés :
- nom : la valeur de l'attribut name. Défaut
#ENV{nom}
- form : le nom du formulaire. Défaut
#ENV{form}
- formulaire_args : hash des arguments du formulaire. Défaut
#ENV{formulaire_args}
- multiple : indication d'un champ multiple, si valeur 'oui' ou 'multiple'. Défaut
#ENV{multiple}
Paramètres
-
\Champ $p
Pile au niveau de la balise
Retour
-
\Champ
Pile complétée par le code à générer
Exemples
-
-
#BIGUP_TOKEN
utilisera#ENV{nom}
en nom de champ par défaut -
#BIGUP_TOKEN{#ENV{nom}, #ENV{multiple}, #ENV{form}, #ENV{formulaire_args}}
: valeurs par défaut. -
#BIGUP_TOKEN{file}
: champ unique -
#BIGUP_TOKEN{file\[\]}
: champ multiple -
#BIGUP_TOKEN{file/}
: champ multiple -
#BIGUP_TOKEN{file, multiple}
: champ multiple -
Le token sera calculé dans la saisie bigup :[(#SAISIE{bigup, file, form, formulaire_args, label=Fichier, ... })]
-
Le token est calculé dans l'appel :[(#SAISIE{bigup, file, token=#BIGUP_TOKEN{file}, label=Fichier, ... })]
-
Voir également
- saisies/bigup.html : Pour un usage dans une saisie.
Utilise
Syntaxe
-
#BIGUP_TOKEN{name, multiple, form, formulaire_args}
Note
-
La signature complète est
#BIGUP_TOKEN{champ, multiple, form, formulaire_args}
La balise nécessite de connaître le nom du formulaire (par défaut `#ENV{form}` ainsi que le hash de ses arguments (par défaut `#ENV{formulaire_args}`. Si cette balise est utilisée dans une inclusion (tel que `#INCLURE` ou `#SAISIE`), il faut penser à transmettre à l'inclure `form` et `formulaire_args`. La balise `#SAISIE_FICHIER` s'en occupe.
Balise
-
BIGUP_TOKEN
Source
Retour
-
string
Source
Paramètres
-
string $extension
Retour
-
string
mime type
Source
Paramètres
-
array $fichiers
-
string $nom
Name utilisé, tel que 'oiseaux/bleus' ou 'oiseaux[bleus]'
-
string $multiple
Si contenu, le champ est considéré multiple
Retour
-
array
Source
- toto => toto,
- toto[truc] => toto/truc,
- toto[truc][] => toto/truc/
- toto/truc => toto/truc
Paramètres
-
string $name
Retour
-
string
Voir également
- saisie_nom2name() : pour l'inverse.
Source
- toto => toto,
- toto/truc => toto_truc,
- toto[truc] => toto_truc
Paramètres
-
string $nom
return string
Source
- toto => toto,
- toto/truc => toto[truc],
- toto[truc] => toto[truc]
Paramètres
-
string $nom
return string
Source
Retourne un token de la forme champ:time:clé
Paramètres
-
string $champ
Nom du champ input du formulaire
-
string | boolean $multiple
Indique si le champ est multiple
-
string $form
Nom du formulaire
-
string $form_args
Hash du contexte ajax du formulaire
Retour
-
string | false
String : Le token false : Erreur : un des arguments est vide.
Voir également
- \Spip\Bigup\Flow::verifier_token()
Utilise
Utilisé par
Source
Liste des erreurs
Gravité | Ligne | Description |
---|---|---|
Notice | 86 |
|
Notice | 129 |
|
Notice | 230 |
|