====== Pxxo_Widgets_Form_Download ======

Ce Widget permet le téléchargement d'un fichier tout en collectant des informations sur l'internaute intéressé par ce fichier. La liste des informations collectées est paramétrable, et une fois récupéré ces informations sont enregistrées un fichier Excel.
On s'assure de la validité de adresse électronique , en envoyant un courriel contenant un lien unique permettant de télécharger le fichier. 

  * [[http://demo.pxxo.net/widgets/demos/tester/Pxxo_Widgets_Form_Download/|Exemple d'utilisation en ligne]]
  * [[fr:install|Installer]]

===== Paramètres =====

^ Nom          ^ Valeur  ^ Description                                                 ^
| filename |  -  | chemin physique vers le fichier à télécharger |
| url |  Automatique  | Permet de dissocier l'url du formulaire et l'url de téléchargement |
| csv |  download.csv  | chemin physique vers le fichier de collecte des informations  |
| groups |  -  | Titre du formulaire ou listes des titres des groupes de champs  |
| fields |  -  | Liste des champs à saisir |
| sizes |  -  | Liste des taille des champs |
| options |  -  | Liste des choix possibles pour un champ (si son type l'accepte) |
| required |  -  | Liste des champs obligatoires |
| values |  -  | Liste des valeur pré-saisie dans les champs |
| types |  -  | Liste des types des champs saisies : text (défaut), mail, select, password etc... |
| button |  Envoyé  | Texte du bouton pour envoyer le formulaire |
| tmpdir |  automatique   | Répertoire de stockage des fichiers de contrôles |
| mailfield |  -  | indice du champ contenant le courriel |
| subject   |  Download  | sujet du mail qui sera envoyé |
| from      |  guest@localhost  | adresse mail de l'envoyeur du mail |
| replyto |  nobodynowhere.com'  | adresse mail de retour |
| usesmtp   |  false  | utilisation ou non de smtp pour l'envoi du mail |
| smtp_host |  localhost  | nom du serveur smtp |
| smtp_port |  25  | numero du port du serveur smtp |


**Remarque :**

L'aide à construction dynamique d'un formulaire est  détaillé sur l page du widget [[fr:doc:Pxxo_Widgets_Form_Generic]].


===== Exemples : =====

<code php>

require_once 'Pxxo/Widgets/Form/Download.php';

$params = array();
$params['lang'] = 'fr';
$params['button'] = 'télécharger';
$params['groups'] = array('Télécharger le manuel Cygwin');
$params['fields'] = array('Nom', 'Prénom', 'Courriel');
$params['required'] = array(true);
$params['mailfield'] = 3;
$params['filename'] = dirname(__FILE__).DIRECTORY_SEPARATOR.'cygwin-ug-net.pdf';
$params['from'] = 'nico@truc.fr';
$params['csv'] = dirname(__FILE__).DIRECTORY_SEPARATOR.'exemple1.csv';

$obj = new Pxxo_Widgets_Form_Download($params);
$obj->main();
$obj->dump();


</code>