diff --git a/README.md b/README.md index d8efb84..0949a17 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,17 @@ Ouais, du php. Na. J'ai découpé en plusieurs fichiers, sans doute que ça peut se condenser. Je ne suis pas dev, il est donc possible que ce soit très foireux. Toute aide pour améliorer est bienvenue. ## Installation +### Prérequis +- msmtp (optionnel) +- php + +Le script utilise soit la fonction mail de php soit msmtp, donc faut avoir php ET de quoi envoyer des mails sur votre serveur. + +Moi, j'utilise msmtp (https://alinea.ninm.net/dokuwiki/pratique:informatique:mail_relai ), c'est bien, (presque) simple et facile. J'ai quand même laissé de quoi passer juste par la fonction php, commentez/décommenter le bon morceau dans ``form.php``. + +Afin que php puisse utiliser msmtp, veillez à ce que les droits sur ``/etc/msmtprc`` soient ouverts pour ``www-data``. + +### Paramétrage Copiez les fichiers php là où vous voulez sur votre site. Vérifiez les chemins (je pourrais améliorer ça dans la config ; on verra à l'usage). Incluez "form.php" et "form_struct.php" où vous voulez sur une de vos pages php : ``` php @@ -18,19 +29,26 @@ Copiez les fichiers php là où vous voulez sur votre site. Vérifiez les chemin Cela permet que l'affichage et la gestion des données soit sur la même page. -Le script utilise la fonction mail de php, donc faut avoir php ET de quoi envoyer des mails sur votre serveur. Moi, j'utilise msmtp (https://alinea.ninm.net/dokuwiki/pratique:informatique:mail_relai ), c'est bien, simple et facile. +Très important ! Ajoutez tout au début de la page contenant le formulaire, avant tout autre chose, avant le code html. : + +``` php + +``` +Sinon, ça va râler. ## Configuration -Modifiez le fichier "form_config.php" pour adapter à vos propres paramètres. En particulier le mail... +Modifiez les paramètres dans ``form_config.php`` pour adapter à vos besoins (en particulier le mail). ## Personnalisation et multilingue Modifiez "form_lang.php" pour personnaliser les messages, voir ajouter des langues. "form_struct.php" concerne le formulaire "presque" html. Ajoutez les classes de votre site web. -Non, je n'inclue pas de css, faut que ce soit cohérent avec les sites, donc : débrouillez-vous. +Je n'inclue pas de css, faut que ce soit cohérent avec les sites, donc : débrouillez-vous. -Il y a tout de même la classe "spam" pour l'affichage des messages d'erreurs quand c'est lié à des pratiques de spam. À vous de la mettre en rouge, en gras, etc. +Il y a tout de même quelques classes, par exemple pour l'affichage des messages d'erreurs quand c'est lié à des pratiques de spam. À vous de la mettre en rouge, en gras, etc. C'est aussi là qu'il y a la liste des questions parce que si c'est multilingue, c'est mieux de traduire vos questions, justement.