Carnet Wiki

Complément de documentation Adapter un formulaire à Bigup

Version 2 — Juin 2020 tcharlss

Intégrer ces notes à la documentation une fois qu’elles seront validées : https://git.spip.net/spip/bigup

Adapter un formulaire à Bigup

Un début de documentation existe mais il n’est pas complet : https://git.spip.net/spip/bigup#user-content-cr%C3%A9ation-d-un-formulaire-pour-uploader-les-fichiers

Voici quelques notes pour compléter.

HTML

Ajouter la classe bigup sur l’input file :

<input type="file" id="#GET{name}" name="#GET{name}" class="file bigup" />

Nb : il peut s’agir de n’importe quelle classe mais c’est plus simple ainsi.

PHP

Dans le charger du formulaire, ajouter une clé _bigup_rechercher_fichiers :

$valeurs['_bigup_rechercher_fichiers'] = true;

Enfin, ajouter une fonction inc_bigup_medias_formulaire_xxx_dist.
Celle-ci est nécessaire pour ajouter un token unique sur l’input du formulaire.
Exemple pour un #FORMULAIRE_PATATES :

/**
 * @param array $args
 * @param \Spip\Bigup\Formulaire $formulaire
 * @return \Spip\Bigup\Formulaire
 */
function inc_bigup_medias_formulaire_patates_dist($args, $formulaire) {
	$formulaire->preparer_input_class(
		'bigup', // 'file' pour rendre automatique.
		['previsualiser' => true]
	);
	return $formulaire;
}

jout