bigform/README.md

2 KiB

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 !

#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:
<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)
  1. dans le formulaire 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);

// Pour proteger les documents
$bigform = charger_fonction('bigform_traiter','inc');
$bigform($id_objet, $objet, $mode, true);

// Pour obfusquer les noms des documents
$bigform = charger_fonction('bigform_traiter','inc');
$bigform($id_objet, $objet, $mode, false, true);

// ou definir la constante  pour l'avoir dans tous les formulaires:
define('_BIGFORM_OBFUSQUER', true);

ATTENTION Il faut ajouter les vérifications pour les différents types de fichiers

ATTENTION pour les documents protégés Il faut activer les urls propres : URLs Propres+.html