Changes - minor - Mise à jour du Readme pour les infos utiles à la mise en place du script.

This commit is contained in:
Zatalyz 2024-11-18 10:59:12 +01:00
parent 3478af8776
commit 93c505c7cf

View file

@ -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
<?php
session_start();
?>
```
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.