--------------------------------------------------------------------
Comment'R 1.0
(Livre d'Or - PHP)
par T.Arsicaud / 2000
--------------------------------------------------------------------
Version du 15/6/2001
Merci d'avoir choisi Comment'R 1.0. Vous trouverez dans ce document
des indications sur les caractéristiques de ce script, sur le système
requis pour son utilisation et sur sa procédure d'installation.
I/ CARACTERISTIQUES DE Comment'R 1.0
Comment'R 1.0 est un script écrit en PHP, permettant d'installer
facilement un Livre d'Or sur votre site Web.
A l'image des Livres d'Or classiques, Comment'R 1.0 offre la possibilité
aux utilisateurs de laisser leurs impressions et commentaires sur une
page Web facilement paramétrable et consultable par tous.
Ce script a été conçu pour faciliter au maximum l'intégration du Livre d'Or
dans des pages Web possédant une structure relativement complexe. Il est
notamment possible de paramétrer la taille et la couleur des tableaux
utilisés pour la mise en page des divers messages postés par les
utilisateurs. Le nombre de commentaires affichés sur une page peut lui-même
être adapté et modifié.
Comment'R 1.0 utilise un fichier texte pour la sauvegarde et la lecture
des commentaires postés par les utilisateurs. Il ne nécessite donc pas
l'installation d'une base de données sur le serveur, du type MySQL.
Le script livredor.php4 correspondant au Livre d'Or est accompagné par
le script admin.php4, qui permet de supprimer facilement les éventuels
commentaires indésirables postés par les utilisateurs.
Une démo de Comment'R 1.0 est disponible à l'adresse suivante :
http://delta.citeglobe.com/scriptsphp/commentr/demo/
II/ SYSTEME REQUIS
Comment'R 1.0 fonctionne avec (et à partir de) PHP 3.0.16.
En cas de problèmes avec une version antérieure, n'hésitez pas
à me contacter par email, à l'adresse : deltascripts@ifrance.com.
Comme nous l'avons vu, Comment'R 1.0 ne nécessite pas de bases de données.
III/ CONDITIONS D'UTILISATION
Comment'R 1.0 est gratuit. Vous pouvez l'utiliser, le modifier comme
bon vous semble, tant que vous conservez la mention "Comment'R 1.0 -
(c) 2000 Thierry Arsicaud (deltascripts@ifrance.com)" copiée au début de
chaque script. N'hésitez pas à m'envoyer un mail si vous utilisez Comment'R 1.0
sur votre site, pour me faire part de vos commentaires ou de vos suggestions.
IV/ 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, téléchargeable à l'adresse suivante :
http://www.corbanware.com/ftpworks.html
Les étapes de l'installation du Livre d'Or sont les suivantes :
a) créez un répertoire sur votre espace d'hébergement (nommez le comme vous
le souhaitez)
b) changez les droits d'accès à ce répertoire, à l'aide de la commande CHMOD
(ou équivalente), en indiquant "777" ou "rwxrwxrwx" (cette opération est
nécessaire pour permettre la sauvegarde des messages postés par les utilisateurs,
et donc l'écriture à l'intérieur de ce répertoire).
c) transférez y les fichiers suivants :
livredor.php4 Script affichant les commentaires déjà postés, ainsi qu'un
formulaire permettant d'ajouter un commentaire
admin.php4 Interface d'administration
L'installation de Comment'R 1.0 est alors terminée.
Vous pouvez commencer à utiliser le Livre d'Or en vous rendant sur le Web
à l'adresse correspondante (www.serveur.com/repertoire/livredor.php4).
Les commentaires envoyés par les utilisateurs sont stockés dans le fichier
texte "livre.dat", créé automatiquement dans le répertoire défini précédemment.
Si vous utilisez un logiciel FTP permettant de mettre àn jour automatiquement
votre site, pensez à "isoler" ce répertoire, car sinon vous risqueriez d'effacer
les nouveaux commentaires postés par les utilisateurs. N'hésitez pas à effectuer
régulièrement une copie du fichier livre.dat contenant l'ensemble des données
envoyées par les utilisateurs.
V/ ADMINISTRATION
L'interface d'administration est directement accessible sur le Web
(script admin.php4). Il est important de noter que ce script n'est
PAS PROTEGE par un mot de passe. Pour des raisons de sécurité, il est
fortement recommandé de le renommer, en prenant garde à ce que son nouveau nom
soit assez difficile à deviner (par exemple : NOMCOMPLIQUE.php4).
Bien qu'il puisse sembler rudimentaire, ce système de protection est
efficace, et empêchera que des utilisateurs peu scrupuleux ne tentent
d'effacer des messages à votre place.
VI/ CONFIGURATION DES PARAMETRES D'AFFICHAGE
Vous pouvez modifier la taille et la couleur des tableaux utilisés
pour l'affichage des commentaires postés par les utilisateurs et pour le
formulaire. Cette opération (optionnelle) doit être effectuée hors ligne,
avant de (re)transférer le script.
Pour modifier les paramètres d'affichage, éditez les lignes de code
correspondantes, situées au début du script livredor.php4.
Pour que le Livre d'Or se "fonde" d'avantage dans votre site,
vous pouvez par ailleurs insérer votre propre code html, au niveau des
indications apparaissant également dans le script.
VII/ CREDITS
Comment'R 1.0 a été développé par Thierry Arsicaud, en décembre 2000.
N'hésitez pas à m'envoyer un mail pour me faire part de vos éventuelles
difficultés d'utilisation, de vos commentaires ou suggestions.
N'oubliez pas de visiter régulièrement mon site Web pour des mises à jour
de Comment'R 1.0 et le téléchargement de nouveaux scripts (forum de
discussion, moteur de recherche, ect...)
--------------------------------------------------------------------
Thierry Arsicaud - deltascripts@ifrance.com
http://www.echodelta.net/scriptsphp/
|
