--------------------------------------------------------------------

FouleTexte 1.5
(Forum de discussion PHP)
par T.Arsicaud / 2000
--------------------------------------------------------------------
Version du 05/10/2001
Merci d'avoir choisi FouleTexte 1.5. Vous trouverez dans ce document
des indications sur les caractristiques de ce forum de discussion, sur
le systme requis pour son utilisation et sur sa procdure d'installation.

I/ CARACTERISTIQUES DE FouleTexte 1.5

FouleTexte 1.5 est un forum de discussion crit en PHP, dont l'une
des principales caractristiques est d'utiliser exclusivement des
fichiers textes pour la sauvegarde et la lecture des messages posts
par les utilisateurs. Il ne ncessite pas l'installation d'une base
de donnes sur le serveur (du type mySQL) et peut donc tre utilis pour
mettre en place facilement des forums de discussion sur des espaces
d'hbergement proposant PHP, mais pas ncessairement de bases de donnes
en complment (ce qui est notamment le cas chez de nombreux hbergeurs
gratuits).
Simple d'installation, FouleTexte 1.5 propose les fonctions classiques
d'un forum de discussion : il permet d'afficher l'arborescence des
messages posts, de lire chaque message, et d'afficher les intituls
des messages qui le prcdent ou le suivent ventuellement. Il est
possible de rpondre un message dj post en intgrant automatiquement
ses citations dans le corps du nouveau message.
Il propose galement une interface d'administration, avec mot de passe,
permettant de supprimer ventuellement certains messages posts.
Notez qu'une option d'affichage vous offre la possibilit de conserver
ou de supprimer automatiquement les tags html ventuellement entrs par
les utilisateurs (recommand pour des raisons de scurit).
FouleTexte 1.5 a t conu pour faciliter au maximum l'intgration du
forum de discussion dans des pages Web possdant une structure
relativement complexe. Il est notamment possible de paramtrer la taille
et la couleur des tableaux utiliss pour la mise en page et l'affichage
des messages posts par les utilisateurs.
Une dmo de FouleTexte est disponible l'adresse suivante :
http://www.echodelta.net/scriptsphp/fouletexte/demo/

II/ NOUVEAUTES par rapport FouleTexte 1.1

FouleTexte 1.5 permet dsormais de rpartir l'affichage des messages
sur plusieurs pages dfinies dynamiquement (auparavant, l'ensemble des
messages apparaissait sur une seule et mme page). Il est important de
noter que Foutexte 1.5 reste entirement compatible avec les versions
prcdentes, 1.0 et 1.1. Pour les modalits de mise jour de FouleTexte,
veuillez consulter les indications ci-dessous.

III/ SYSTEME REQUIS

FouleTexte fonctionne avec (et partir de) PHP 3.0.16.
En cas de problmes avec une version antrieure, n'hsitez pas
me contacter par email, l'adresse : deltascripts@ifrance.com.
Comme nous l'avons vu, FouleTexte ne ncessite pas de bases de donnes.

IV/ CONDITIONS D'UTILISATION

FouleTexte 1.5 est gratuit. Vous pouvez l'utiliser, le modifier comme
bon vous semble, tant que vous conservez la mention "FouleTexte 1.5 -
(c) 2000 Thierry Arsicaud (deltascripts@ifrance.com)" copie au dbut de
chaque script. N'hsitez pas m'envoyer un mail si vous utilisez FouleTexte
sur votre site, pour me faire part de vos commentaires ou de vos suggestions.

V/ INSTALLATION
Pour installer le Livre d'Or sur votre site, vous devez disposer
d'un logiciel de FTP disposant d'une commande CHMOD, l'image du logiciel
gratuit FTP WORKS 1.33, tlchargeable l'adresse suivante :
http://www.corbanware.com/ftpworks.html
Les tapes de l'installation sont les suivantes :
a) crez un rpertoire sur votre espace d'hbergement (nommez le comme vous
le souhaitez)
b) changez les droits d'accs ce rpertoire, l'aide de la commande CHMOD
(ou quivalente), en indiquant "777" ou "rwxrwxrwx" (cette opration est
ncessaire pour permettre la sauvegarde des messages posts par les utilisateurs
,
et donc l'criture l'intrieur de ce rpertoire).
c) transfrez y les fichiers suivants :
post.php Page permettant de poster un nouveau message
listemessages.php Page permettant d'afficher les intituls des messages post
s
lire.php Page permettant de lire un message post
confirmpost.php Page d'avertissement ou de confirmation suivant
l'envoi d'un nouveau message
admin.php Interface d'administration
L'installation de FouleTexte 1.5 est alors termine.
Vous pouvez commencer utiliser le forum en vous rendant sur le Web
aux adresses correspondantes.
Chaque fois qu'un message sera post, un nouveau fichier texte, du type
"msg1.dat", sera cr sur le serveur. Si vous utilisez un logiciel FTP
permettant de mettre jour automatiquement votre site, pensez
"isoler" le rpertoire cr prcdemment, car sinon vous risqueriez
d'effacer les nouveaux messages posts par les utilisateurs.

VI/ MISES A JOUR

Les mises jour de FouleTexte 1.0 et 1.1 sont simples effectuer :
il suffit de remplacer les anciens fichiers listemessages.php,
lire.php, confirmpost.php, post.php et admin.php prsents sur le
serveur par ceux compris dans la nouvelle distribution (en ayant
pralablement repris les paramtres d'affichage et le code html insr).
Les nouveaux scripts n'affectent en rien les donnes postes avec
l'ancienne version de FouleTexte. Les utilisateurs de FouleTexte 1.1
peuvent donc passer FouleTexte 1.5 sans risquer de perdre les donnes
postes auparavant.

VII/ ADMINISTRATION
L'interface d'administration est directement accessible sur le Web
(script admin.php). Aprs avoir choisi un mot de passe, elle vous
permettra de supprimer ventuellement des messages posts par les
utilisateurs.

VIII/ CONFIGURATION DES PARAMETRES D'AFFICHAGE

Vous pouvez modifier la taille et la couleur des tableaux utiliss
pour l'affichage des messages et de leurs intituls. Cette opration
(optionnelle) doit tre effectue hors ligne, avant de (re)transfrer
les pages concernes :
post.php
listemessages.php
lire.php
confirmpost.php
Pour modifier les paramtres d'affichage, ditez les lignes de code
correspondantes, situes au dbut de chacun des scripts.
Pour que le forum se "fonde" d'avantage dans votre site, vous pouvez par
ailleurs insrer votre propre code html, au niveau des commentaires
apparaissant galement dans les scripts.

IX/ CREDITS
FouleTexte 1.5 a t dvelopp par Thierry Arsicaud, en septembre 2000 /
octobre 2001. N'hsitez pas m'envoyer un mail pour me faire part
de vos ventuelles difficults d'utilisation, de vos commentaires
ou suggestions. N'oubliez pas de visiter rgulirement mon site Web
pour des mises jour de FouleTexte et le tlchargement de nouveaux
scripts (livre d'or, moteur de recherche, etc...).
--------------------------------------------------------------------
Thierry Arsicaud - deltascripts@ifrance.com
http://www.echodelta.net/scriptsphp/