SPIP Code

Documentation du code de SPIP et de ses plugins

Big Upload

Application

Table of Contents

Classes

Bigup
Gère la validité des requêtes et appelle Flow
Cache
Gère le cache des fichiers dans tmp/bigupload
CacheFichiers
Gère le cache des fichiers dans tmp/bigupload
NettoyerRepertoireUploadTask
Tâche de nettoyage des fichiers temporaires du plugin Big Upload.
BigupFactory
Flow
Réceptionne des morceaux de fichiers envoyés par flow.js
FlowResponse
Retours de la classe Flow Indique le code de réponse http, et d’éventuelles données.
Formulaire
Gère les modifications du html d'un formulaire existant
GestionRepertoires
Gère la création ou le nettoyages de répertoires
Identifier
Gère l'identification du formulaire
PreparerInputOptionsEvent
AssetsListener
ConfigurationListener
FormulaireListener
Repondre
Gère la réception d'actions ajax

Functions

action_bigup_dist()  : never
Assez tôt on vérifie si on demande à tester la présence d'un morceau de fichier uploadé ou si on demande à envoyer un morceau de fichier.
balise_BIGUP_TOKEN()  : Champ
Compile la balise `#BIGUP_TOKEN` qui calcule un token autorisant l'envoi de fichiers par morceaux
calculer_balise_BIGUP_TOKEN()  : string|false
Calcule un token en fonction de l'utilisateur, du champ, du formulaire…
bigup_lister_fichiers()  : array<string|int, mixed>
Retrouve les fichiers correspondant à un name d'input donné, s'il y en a.
bigup_nom2name()  : mixed
Passer un nom en une valeur compatible avec un `name` de formulaire
bigup_nom2classe()  : mixed
Passer un nom en une valeur compatible avec une classe css
bigup_name2nom()  : string
Passer un `name` en un format de nom compris de saisies
bigup_get_accept_logos()  : string
Retourne la liste des mimes types acceptés pour des logos / illustrations, tels qu’attendus par le champ accept.
bigup_get_mime_type_extension()  : string
Transforme une extension en mime-type (de façon simpliste)
formulaires_tester_bigup_verifier_dist()  : mixed
formulaires_tester_bigup_traiter_dist()  : mixed
formulaires_tester_bigup_extended_verifier_dist()  : mixed
formulaires_tester_bigup_extended_traiter_dist()  : mixed

Functions

action_bigup_dist()

Assez tôt on vérifie si on demande à tester la présence d'un morceau de fichier uploadé ou si on demande à envoyer un morceau de fichier.

action_bigup_dist() : never

Flow vérifie évidement que l'accès est accrédité !

Return values
never

balise_BIGUP_TOKEN()

Compile la balise `#BIGUP_TOKEN` qui calcule un token autorisant l'envoi de fichiers par morceaux

balise_BIGUP_TOKEN(Champ $p) : Champ

À 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}
Parameters
$p : Champ

Pile au niveau de la balise

Tags
syntaxe

#BIGUP_TOKEN{name, multiple, form, formulaire_args}

example
  • #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, ... })]
see

saisies/bigup.html Pour un usage dans une saisie.

see
balise_SAISIE_FICHIER_dist()
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
uses
calculer_balise_BIGUP_TOKEN()
Return values
Champ —

Pile complétée par le code à générer

calculer_balise_BIGUP_TOKEN()

Calcule un token en fonction de l'utilisateur, du champ, du formulaire…

calculer_balise_BIGUP_TOKEN(string $champ, string|bool $multiple, string $form, string $form_args) : string|false

Retourne un token de la forme champ:time:clé

Parameters
$champ : string

Nom du champ input du formulaire

$multiple : string|bool

Indique si le champ est multiple

$form : string

Nom du formulaire

$form_args : string

Hash du contexte ajax du formulaire

Tags
uses
calculer_action_auteur()
see
Flow::verifier_token()
used-by
balise_BIGUP_TOKEN()
Return values
string|false —

String : Le token false : Erreur : un des arguments est vide.

bigup_lister_fichiers()

Retrouve les fichiers correspondant à un name d'input donné, s'il y en a.

bigup_lister_fichiers(array<string|int, mixed> $fichiers, string $nom, string $multiple) : array<string|int, mixed>
Parameters
$fichiers : array<string|int, mixed>
$nom : string

Name utilisé, tel que 'oiseaux/bleus' ou 'oiseaux[bleus]'

$multiple : string

Si contenu, le champ est considéré multiple

Return values
array<string|int, mixed>

bigup_nom2name()

Passer un nom en une valeur compatible avec un `name` de formulaire

bigup_nom2name(string $nom) : mixed
  • toto => toto,
  • toto/truc => toto[truc],
  • toto[truc] => toto[truc]
Parameters
$nom : string

return string

bigup_nom2classe()

Passer un nom en une valeur compatible avec une classe css

bigup_nom2classe(string $nom) : mixed
  • toto => toto,
  • toto/truc => toto_truc,
  • toto[truc] => toto_truc
Parameters
$nom : string

return string

bigup_name2nom()

Passer un `name` en un format de nom compris de saisies

bigup_name2nom(string $name) : string
  • toto => toto,
  • toto[truc] => toto/truc,
  • toto[truc][] => toto/truc/
  • toto/truc => toto/truc
Parameters
$name : string
Tags
see
saisie_nom2name()

pour l'inverse.

Return values
string

bigup_get_accept_logos()

Retourne la liste des mimes types acceptés pour des logos / illustrations, tels qu’attendus par le champ accept.

bigup_get_accept_logos([array{objet: string, id_objet: int} $args = [] ]) : string
Parameters
$args : array{objet: string, id_objet: int} = []
Return values
string

bigup_get_mime_type_extension()

Transforme une extension en mime-type (de façon simpliste)

bigup_get_mime_type_extension(string $extension) : string
Parameters
$extension : string
Return values
string —

mime type

formulaires_tester_bigup_verifier_dist()

formulaires_tester_bigup_verifier_dist([mixed $id = 0 ]) : mixed
Parameters
$id : mixed = 0

formulaires_tester_bigup_traiter_dist()

formulaires_tester_bigup_traiter_dist([mixed $id = 0 ]) : mixed
Parameters
$id : mixed = 0

formulaires_tester_bigup_extended_verifier_dist()

formulaires_tester_bigup_extended_verifier_dist([mixed $id = 0 ][, mixed $target = '' ][, mixed $bloc = '' ]) : mixed
Parameters
$id : mixed = 0
$target : mixed = ''
$bloc : mixed = ''

formulaires_tester_bigup_extended_traiter_dist()

formulaires_tester_bigup_extended_traiter_dist([mixed $id = 0 ][, mixed $target = '' ][, mixed $bloc = '' ]) : mixed
Parameters
$id : mixed = 0
$target : mixed = ''
$bloc : mixed = '' 

        

        
    




    

    

                                

                

                            
    

        On this page

        
    


                

                            

            

    

        

            
Search results