SPIP Code

Documentation du code de SPIP et de ses plugins

Big Upload

Documentation

Table of Contents

Packages

Application
SPIP

Namespaces

Spip

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_SAISIE_FICHIER_dist()  : Champ
Compile la balise `#SAISIE_FICHIER` qui retourne le code HTML de la saisie de formulaire indiquée.
bigup_upgrade()  : mixed
Fonction d'installation et de mise à jour du plugin Big Upload.
bigup_vider_tables()  : mixed
Fonction de désinstallation du plugin Big Upload.
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_charger_dist()  : mixed
L'objectif de ce formulaire de test est de vérifier la simplicité d'usage de l'envoi de fichier, même des gros.
formulaires_tester_bigup_verifier_dist()  : mixed
formulaires_tester_bigup_traiter_dist()  : mixed
formulaires_tester_bigup_extended_charger_dist()  : mixed
L'objectif de ce formulaire de test est de vérifier le fonctionnement de la drop-zone-extended de bgup
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_SAISIE_FICHIER_dist()

Compile la balise `#SAISIE_FICHIER` qui retourne le code HTML de la saisie de formulaire indiquée.

balise_SAISIE_FICHIER_dist(Champ $p) : Champ

Identique à peu de choses près à la balise #SAISIE

  • ajoute form = #ENV{form}
  • ajoute formulaire_args = #ENV{formulaire_args}
  • ajoute fichiers = #ENV{_bigup_fichiers}

Ces 2 premières infos sont utiles à la balise #BIGUP_TOKEN La liste des fichiers, elle, permet… à la saisie de lister les fichiers déjà présents.

Parameters
$p : Champ
Tags
syntaxe

#SAISIE_FICHIER{type,nom[,option=xx,...]}

Return values
Champ

bigup_upgrade()

Fonction d'installation et de mise à jour du plugin Big Upload.

bigup_upgrade(string $nom_meta_base_version, string $version_cible) : mixed
Parameters
$nom_meta_base_version : string

Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP

$version_cible : string

Version du schéma de données dans ce plugin (déclaré dans paquet.xml)

bigup_vider_tables()

Fonction de désinstallation du plugin Big Upload.

bigup_vider_tables(string $nom_meta_base_version) : mixed
Parameters
$nom_meta_base_version : string

Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP

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_charger_dist()

L'objectif de ce formulaire de test est de vérifier la simplicité d'usage de l'envoi de fichier, même des gros.

formulaires_tester_bigup_charger_dist([mixed $id = 0 ]) : mixed

Il y a beaucoup de contraintes à gérer :

  • la gestion d'un ou plusieurs champs de type fichier
  • la gestion de gros fichiers (envois par morceaux (chunk))
  • la gestion d'une zone de glisser déposer
  • le stockage des fichiers envoyés avant le traitement du formulaire
  • leur nettoyage si l'utilisateur finalement ne soumet pas le formulaire
  • la sécurité : ne pas pouvoir exécuter/télécharger les fichiers envoyés directement
  • la gestion de plusieurs formulaires sur la même page (avec des appels différents) : ils ne doivent pas se mélanger les pinceaux.
Parameters
$id : mixed = 0

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_charger_dist()

L'objectif de ce formulaire de test est de vérifier le fonctionnement de la drop-zone-extended de bgup

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

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 = ''

Search results