You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Matthieu Marcillaud e85407a0df Version 1.0.7 : des corrections autour des zones étendues. 20 hours ago
action Gros refactoring encore pour y voir plus clair. 3 years ago
balise Comme 'saisies' n’est plus nécéssité, indiquer une erreur sur la balise SAISIE_FICHIER pour mieux comprendre ! 7 months ago
css Présenter un retour visuel lorsqu’on clique le bouton 'Annuler' (RealET) 9 months ago
formulaires Des attributs_html manquant sur les formulaires. 1 day ago
genie On va déplacer toutes les fonctions de suppressions ou créations de répertoires 3 years ago
inc Des inclusions pour la fonction lire_config() qui pouvait manquer dans certains contextes (ladnet). 4 months ago
javascript Quelque fois on arrive à droper sur un champ bigup autre que celui qui a la zone étendue activée au même moment (si on se dépèche d’aller dessus)... dans ce cas, bien refermer la zone de drag extended qui s’était ouverte... 22 hours ago
lang Comme 'saisies' n’est plus nécéssité, indiquer une erreur sur la balise SAISIE_FICHIER pour mieux comprendre ! 7 months ago
lib/flow Mise à jour de flow.js en version 2.14.1 1 day ago
prive Quelques styles pour les dropzone extended adaptés ; on permet aussi d’étendre sur un id de formulaire (on le décore) 20 hours ago
saisies Permettre d’écrire une saisie 'bigup' déclarée en PHP (avec l’option 'env') et avoir tout de même la liste 1 day ago
README.md Correction des liens vers le wiki suite au déplacement du plugin sur github. 10 months ago
bigup_administrations.php On permet la transmission de données du PHP qui répupère les morceaux de fichiers 2 years ago
bigup_fonctions.php Suite de cef506c : plutôt que de déclarer un maxFiles (toujours possible), on permet de passer directement l’option "multiple". 10 months ago
bigup_pipelines.php Des inclusions pour la fonction lire_config() qui pouvait manquer dans certains contextes (ladnet). 4 months ago
paquet.xml Version 1.0.7 : des corrections autour des zones étendues. 20 hours ago

README.md

Big up (big upload)

Plugin SPIP permettant de téléverser de gros fichiers dans SPIP dans des formulaires CVT. Fournit une API

Fonctionnement général

Un formulaire va pouvoir stoker les fichiers envoyés par un champ input de type file, le temps de la rédaction de ce formulaire, jusqu’au traitement de celui-ci. Ainsi, si des erreurs de saisie sont présentes, les fichiers n’ont pas à être de nouveau envoyés.

Il est possible, dans le code html du formulaire de lister les fichiers déjà envoyés, pour chaque champ de type file concerné (et de pouvoir demander leur suppression).

Amélioration javascript

Par dessus cela s’ajoute une couche javascript qui permet de téléverser des fichiers de manière asynchrone d’une part, et volumineux d’autre part.

Dès qu’un fichier est déposé sur la zone prévue, le téléversement commence, si le fichier cependant correspond au type attendu par l’input (attribut html5 accept)

Le fichier est envoyé par morceaux (chunk), jusqu'à ce que le dernier morceau soit envoyé. Si une interruption arrive (on quitte la page, puis on revient dessus par exemple), et que l’utilisateur remet le même fichier à téléverser, les morceaux déjà reçus ne seront pas réenvoyés, ce qui économise un peu de temps et de bande passante.

Fonctionnement technique

Le fonctionnement général s’appuie sur les formulaires CVT de SPIP et sur un token généré par la balise #BIGUP_TOKEN

Pour les détails, lire : le fonctionnement technique

Résumé

Au chargement d’un formulaire CVT, si la clé _bigup_rechercher_fichiers est présente, le plugin Bigup se chargera de retrouver les fichiers déjà chargés pour ce formulaire et d’ajouter leur liste, pour chaque champ concerné du formulaire, dans l’environnement.

Ces fichiers sont stokés sur le serveur dans _DIR_TMP/bigupload. Lire plus d’informations sur ce stokage dans le wiki

La saisie bigup dans le formulaire peut ensuite gérer l’ajout de nouveaux fichiers et présenter la liste des fichiers déjà présents.

Le javascript Bigup qui utilise la librairie Flow.js ajoute une gestion en ajax du téléversement des fichiers, même très volumineux, dès qu’ils sont ajoutés. Le token de l’input, qui est envoyé à PHP sert d’autorisation pour recevoir ces fichiers.

La saisie

La balise #SAISIE_FICHIER est une extension à la balise #SAISIE qui ajoute automatiquement les valeurs form et formulaire_args nécessaires au calcul de la balise #BIGUP_TOKEN, ainsi que la liste des fichiers présents.

Le plugin dispose d’une saisie bigup à laquelle on peut passer un certain nombre d’options, notamment accept et multiple

Pour les détails lire : la balise #SAISIE_FICHIER ou la saisie bigup.

Exemple :

[(#SAISIE_FICHIER{bigup, images, 
    label=Des images (par mime type),
    accept=image/*,
    multiple=oui})]

[(#SAISIE_FICHIER{bigup, cv, 
    label=Un fichier pdf (par extension),
    accept=.pdf})]

Les nettoyages

Un cron nettoie tous les jours les fichiers partiels ou complets qui n’ont pas été utilisés, c’est à dire âgés de plus de 24h.

Ce même nettoyage est aussi réalisé dès qu’un fichier complet est reconstitué, c’est à dire après la réception de son dernier morceau.

Enfin après le traitement du formulaire, tous les fichiers complets non utilisés de celui-ci sont enlevés.

Création d’un formulaire pour uploader les fichiers

Pour qu’il soit compatible à la fois avec et sans javascript, il faut prendre en compte, côté PHP et HTML, un certain nombre d'éléments.

Côté HTML

Le formulaire (la balise <form>) doit être posté et autoriser les fichiers (multipart/form-data) ce qui revient à écrire la plupart du temps :

<form method="post" action="#ENV{action}" enctype="multipart/form-data">

Les input qui autorisent plusieurs fichiers doivent l’indiquer :

  • avec un nom de variable tableau, tel que name='fichiers[]'
  • avec la propriété multiple

La saisie bigup s’occupe de cela dès lors que l’option multiple est activée.

Côté PHP

Pour recréer le tableu $_FILES tel que le crée habituellement PHP, il faut connaître la valeur de l’attribut name de la balise input.

Cette valeur est transmise avec le token calculé, et est inscrite dans le chemin de cache des fichiers reçu. Cela permet, à partir d’un fichier cache donné, de recréer le $_FILES qui lui correspondait.

Voir les notes sur $_FILES dans le wiki

Todo

JS

  • Compatibilité plugin roles_documents
  • Compatibilité plugin roles_logos
  • Méthode pour simplifier l’auto-submit des formulaires simples ?

PHP

  • Pouvoir restreindre par mime type
  • Pouvoir restreindre par extension

Autre

  • Yaml des saisies
  • Traitement pour formidable pour gérer ces champs (si réalisable ?)
  • Pouvoir intégrer une saisie de documents sur champs extras. Cela questionne :
    • qu’est-ce qu’on enregistre et où ?
    • Crée t’on un champ dans la table (c’est la logique de champs extras)
    • ou ajoute t’on des liens sur l’objet sur spip_documents_liens…
    • affiche-t-on des documents par défaut lorsqu’on édite le champ…