BigUp
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 35e3a2060a Le formulaire de logo peut retourner `false` (pour ne pas s’afficher) dans certaines situations (notamment si l’autorisation iconifier retourne false). 1 week ago
action Gros refactoring encore pour y voir plus clair. 2 years ago
balise Comme indiqué dans le commit précédent, on transmet la liste des fichiers à la saisie bigup en les mettant dans la clé d’environnement ‘_bigup_fichiers’, plutôt que (finalement), dans l’environnement du champ directement, qui parfois était utilisé pour transmettre par exemple le nom du fichier (comme dans le formulaire d’édition de logo actuellement). Ie: on n’utilise plus `#ENV{nom_du_champ}` pour mettre la liste des fichiers, mais `#ENV{_bigup_fichiers/nom_du_champ}` 2 years ago
css En colonne, s’il y a une prévisu, on cache le nom du fichier. Ça prend moins de place. 2 years ago
formulaires On permet la transmission de données du PHP qui répupère les morceaux de fichiers vers le javascript qui analyse le retour. 1 year ago
genie On va déplacer toutes les fonctions de suppressions ou créations de répertoires 2 years ago
inc Corrections de PHPDoc 1 week ago
javascript Le saviez-tu ? l’attribut data-xxx est passé en minuscule par le navigateur. Corrige partiellement le fait que "maxFiles" était innopérant. 9 months ago
lang Traduction anglaise, meilleure description (@cerdic) 5 months ago
lib/flow Mise à jour de flow.js en version 1.13.1 1 week ago
prive La page de test affiche le 2è formulaire en colonne. C’est plus pratique pour tester les CSS. 2 years ago
saisies Comme indiqué dans le commit précédent, on transmet la liste des fichiers à la saisie bigup en les mettant dans la clé d’environnement ‘_bigup_fichiers’, plutôt que (finalement), dans l’environnement du champ directement, qui parfois était utilisé pour transmettre par exemple le nom du fichier (comme dans le formulaire d’édition de logo actuellement). Ie: on n’utilise plus `#ENV{nom_du_champ}` pour mettre la liste des fichiers, mais `#ENV{_bigup_fichiers/nom_du_champ}` 2 years ago
README.md Maj d’une todo. 10 months ago
bigup_administrations.php On permet la transmission de données du PHP qui répupère les morceaux de fichiers vers le javascript qui analyse le retour. 1 year ago
bigup_fonctions.php Comme indiqué dans le commit précédent, on transmet la liste des fichiers à la saisie bigup en les mettant dans la clé d’environnement ‘_bigup_fichiers’, plutôt que (finalement), dans l’environnement du champ directement, qui parfois était utilisé pour transmettre par exemple le nom du fichier (comme dans le formulaire d’édition de logo actuellement). Ie: on n’utilise plus `#ENV{nom_du_champ}` pour mettre la liste des fichiers, mais `#ENV{_bigup_fichiers/nom_du_champ}` 2 years ago
bigup_pipelines.php Le formulaire de logo peut retourner `false` (pour ne pas s’afficher) dans certaines situations (notamment si l’autorisation iconifier retourne false). Il faut en tenir compte pour ne pas que bigup modifie `$flux['data']` en tableau. (nicod, tcharles) 1 week ago
paquet.xml Ticket #12: Éviter un recalcul si on modifie le formulaire de configuration de Bigup. 1 year 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

  • Miniature des petites images au chargement
  • 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…