bigform/README.md
2020-05-19 23:33:25 +02:00

53 lines
1.7 KiB
Markdown

# Plugin bigform
> plugin proposant un formulaire CVT pour le plugin bigup
## Usage 1 : en formulaire autonome (comme html5_upload)
> ATTENTION : il n'y a pas de vérification sur le type des fichiers envoyés en PHP.
> Ne pas hésiter à surcharger la fonction de vérification : formulaires_bigform_verifier()
> en fonction des besoins !
```html
#FORMULAIRE_BIGFORM{objet, id_objet, mode}
```
## Usage 2 : en inclure dans un formulaire
> Ajoute dynamiquement un champ **titre** pour chaque image
1. dans le formulaire html:
```html
<INCLURE{fond=inclure/bigform,env}>
```
cet inclure peut accepter 3 arguments facultatifs :
* `accept=#LISTE{image/*, application/pdf}` ou `accept="image/*"` par défaut tous les fichiers
* `previsualiser=non` (par défaut = oui)
* `multiple=non` (par défaut = oui)
2. dans le formulaire php
```php
// dans le charger :
$valeurs['_bigup_rechercher_fichiers'] = true;
// dans le verifier
// Pour les options :
// https://contrib.spip.net/References-des-verifications#verification_fichiers
// https://git.spip.net/plugin/verifier/src/branch/master/verifier/fichiers.php
$bigform = charger_fonction('bigform_verifier','inc');
$options = ['mime' => 'image_web'];
$bigform($options,$erreurs);
/*
* traiter
* @param int $id_objet
* @param string $objet
* @param string $mode (facultatif) defaut: auto
* @param bool $secu (true => deplace les fichiers dans IMG/PROTECTED/); defaut : false
*/
$bigform = charger_fonction('bigform_traiter','inc');
$bigform($id_objet, $objet);
// Ou pour proteger les documents
$bigform = charger_fonction('bigform_traiter','inc');
$bigform($id_objet, $objet, $mode, true);
```
> **ATTENTION**
> Il faut ajouter les vérifications pour les différents types de fichiers