############################################################################## # WWWBoard Version 2.0 ALPHA 2 # # Copyright 1996 Matt Wright mattw@worldwidemart.com # # Created 10/21/95 Last Modified 11/25/95 # # Scripts Archive at: http://www.worldwidemart.com/scripts/ # ############################################################################## # # # VERSION FRANCAISE : Sébastien Joncheray, http://www.perl-gratuit.com # # # ############################################################################## # If you run into any problems while trying to configure this scripts, help # # is available. The steps you should take to get the fastest results, are: # # 1) Read this file thoroughly # # 2) Consult the Matt's Script Archive Frequently Asked Questions: # # http://www.worldwidemart.com/scripts/faq/ # # 3) If you are still having difficulty installing this script, send # # e-mail to: scripts-help@tahoenet.com # # Include any error messages you are receiving and as much detail # # as you can so we can spot your problem. Also include the variable# # configuration block that is located at the top of the script. # # # # Hopefully we will be able to help you solve your problems. Thank you. # ############################################################################## # COPYRIGHT NOTICE # # Copyright 1996 Matthew M. Wright All Rights Reserved. # # # # WWWBoard may be used and modified free of charge by anyone so long as # # this copyright notice and the comments above remain intact. By using this # # code you agree to indemnify Matthew M. Wright from any liability that # # might arise from it's use. # # # # Selling the code for this program without prior written consent is # # expressly forbidden. In other words, please ask first before you try and # # make money off of my program. # # # # Obtain permission before redistributing this software over the Internet or # # in any other medium. In all cases copyright and header must remain intact.# ##############################################################################
Vous devez avoir les fichiers suivants de WWWBoard-vf Version 2.0 ALPHA 2:
a. ALPHA-2 - A LIRE (anglais). 1. lisezmoi.txt - Les instructions d'installation. Ce fichier. 2. wwwboard-vf.pl - Le script CGI Perl qui fait tout. 3. wwwboard-vf.html - Le fichier HTML de WWWBoard-vf que le visiteur voit. 4. faq.html - Une Foire Aux Questions pour les utilisateurs de wwwboard-vf. 5. data.txt - Où le numéro d'article courant est stocké. 6. messages/ - Où les messages sont créés et stockés. 7. wwwadmin-vf.pl - Un Outil d'administration pour supprimer des messages. 8. passwd.txt - Le nom utilisateur et mot de passe crypté pour WWWAdmin-vf 9. ADMIN_lisezmoi - fichier à lire éventuellement pour WWWAdmin-vf.
Vous aurez besoin d'éditer à la main les fichiers .pl de cette distribution. Voici une description des modifications nécessaires à apporter aux fichiers: ___________________________________________________________________________
WWWBOARD-VF.PL ===========
Ce fichier doit être placé dans le cgi-bin de votre serveur, ou s'il permet les extensions .cgi comme scripts Perl, vous pouvez simplement renommer ces fichiers en wwwboard.cgi, et changer la variable $cgi_url variable. Ce fichier doit également être mis avec chmod 755. Demandez à votre administrateur système concernant le cgi-bin et la commande chmod sur unix.
C'est le fichier le moins simple à modifier. Il y a pas mal de variables et de nombreuses options. Voici ci-dessous un résumé pour savoir comment configurer tout cela et utiliser les options:
########################################################################### # Define Variables
$basedir = "/path/to/wwwboard-vf"; Cette variable doit contenir le chemin absolue au répertoire wwwboard-vf. Donc, si vous avez toutes vos pages HTML dans /home/yourname/public_html et que vous faites un répertoire en dessous nommé 'wwwboard-vf', alors $basedir doit être: /home/yourname/public_html/wwwboard-vf
$baseurl = "http://your.host.xxx/wwwboard-vf"; Ceci est l'URL de base du répertoire où wwwboard-vf est mis. Donc, en gardant l'exemple ci-dessus, si l'URL de votre site est: http://your.host.xxx/~yourname/, $baseurl doit être: http://your.host.xxx/~yourname/wwwboard-vf/.
$cgi_url = "http://your.host.xxx/cgi-bin/wwwboard-vf.pl"; C'est l'URL de wwwboard-vf.pl. Cela sera utilisé dans les formulaires pour répondre à un article, ce doit donc être correct.
$mesgdir = "messages"; C'est le nom du répertoire (ajouté à $basedir) dans lequel seront enregistrés les articles. Il doit être créé par vos soins sous $basedir, et chmod 777.
$datafile = "data.txt"; C'est le nom du fichier (ajouté à $basedir) qui contient le numéro d'article courant. Il doit être chmod 777.
$mesgfile = "wwwboard-vf.html"; C'est le nom du fichier HTML du Forum (ajouté à $basedir et à $baseurl), que vous pourriez avoir envie de renommer index.html pour avoir un URL d'accès plus court.
$faqfile = "faq.html"; Nom du fichier FAQ faq.html (ajouté à $baseurl) sur WWWBoard-vf.
$ext = "html"; Ceci est l'extension à mettre pour les fichiers qui seront créés (un par article). La plupart du temps, ce doit être laissé à "html", mais à l'occasion vous pourriez avoir envie de le mettre à "htm" (plateforme DOS).
$date_command = "/bin/date"; INUTILE DANS CETTE VERSION ! This needs to be the path to your 'date' command. This script uses the date command to time stamp the messages individually with along date and to place a short 'added' date on the wwwboard.html page.
$title = "Forum WWWBoard-vf"; C'est le titre de votre forum, qui apparait un peu partout.
AJOUT POUR LA VERSION FRANCAISE : $body_opt=''; Vous pouvez préciser ici des paramètres de couleurs pour les pages HTML. ceci sera ajouté dans le tag <BODY> des fichiers HTML créés et/ou affichés. Vous pouvez ainsi préciser : - une couleur de fond en mettant par exemple: $body_opt='BGCOLOR="#C0C0C0"'; - une image de fond en mettant par exemple: $body_opt='BACKGROUND="http://www.votresite.com/votre/image/de/fond.gif"'; - une couleur de texte en mettant par exemple: $body_opt='text="#000080"'; - une couleur de lien en mettant par exemple: $body_opt='link="#008000"'; - une couleur de lien visité en mettant par exemple: $body_opt='vlink="#FF0000"'; Mettez les valeurs de votre choix, vous pouvez combiner tout cela, en séparant les éléments par un espace, exemple : $body_opt='bgcolor="#C0C0C0" text="#000080" link="#008000" vlink="#FF0000" alink="#FF0000"';
# Terminé ###########################################################################
Il y a également des options à configurer:
########################################################################### # Configure Options
$show_faq = 1; # 1 - OUI (par défaut); 0 = NON Cette option vous permet de choisir si vous voulez ou non qu'un lien vers la FAQ apparaisse sur chaque page.
$allow_html = 1; # 1 = OUI; 0 = NON (recommandé) Cette option vous permet de choisir si vous autorisez les TAGS HTML dans les articles ou non. Si vous ne les autorisez pas, tout texte envoyé entre des <> autour est supprimé du message. Mettre cette option à 1 autorise les tags html dans les messages, et vous pouvez interdire cela en mettant '0'.
$quote_text = 1; # 1 = OUI; 0 = NON En laissant cette option à 1, lors d'une réponse, le message précédent sera mis et indenté avec ':' devant chaque ligne, dans la case de réponse, afin de distinguer la réponse elle-même de ce qui a été dit auparavant. Mettre cette option à '0' pour ne pas avoir le message précédent dans la case pour écrire le texte de réponse.
$subject_line = 0; # 0 = Objet modifiable, avec 'Re:'; 1 = Objet avec 'Re:' # non modifiable; 2 = Objet vide, à remplir. Il y a trois options dans la façon d'afficher le titre de l'article précédent lors de l'écriture d'une réponse. Laisser cette option à '0' (par défaut), permet à l'utilisateur de modifier le titre dans le formulaire de réponse. Mettre cette option à '1', indentera l'objet de l'article (Re:) mais n'autorisera pas l'utilisateur à le modifier. La troisième et dernière possibilité est de mettre ceci à '2'. Dans ce cas, l'Objet est vide et l'utilisateur doit le saisir dans le formulaire de réponse.
$use_time = 1; # 1 = OUI; 0 = NON Cette option vous permet de choisir si vous souhaitez utilisez l' heure:minute:seconde en plus de la date jour/mois/année sur la page principale. Jour/mois/année sera automatiquement placé sur la page principale wwwboard-vf.html quand un article est ajouté, mais si vous laissez cette variable à '1' l' heure:minute:seconde sera également affichée à côté. Ceci est très utile pour les forums recevant beaucoup d'articles, mais si vous voulez gagner de la place sur la page principale, vous pouvez mettre cela à '0' pour que heure:minute:seconde n'y soit pas.
# Terminé ###########################################################################
WOW! Vous avez tout bien fait. C'était le fichier le plus délicat à configurer.
___________________________________________________________________________
WWWBOARD-VF.HTML =============
wwwboard-vf.html doit être placé dans le répertoire que vous avez défini dans $basedir du fichier wwwboard-vf.pl. Il doit être chmod 777 afin que votre uid sur le serveur (User ID) ait la permission de le modifier.
Ce fichier nécessite nettement moins de modifications que wwwboard-vf.pl. Il y a trois choses que vous voudrez changer dans ce fichier. Les deux premières sont tout simplement le titre du Forum WWWBoard-vf. A l'origine ces 2 lignes ressemblent à:
<title>Forum WWWBoard-vf</title> et <h1>Forum WWWBoard-vf</h1>
Modifier ce titre et en-tête en ce que vous voulez. Cela sera probablement la même chose que la variable $title que vous avez définie dans wwwboard-vf.pl.
La troisième chose à changer est cette ligne:
<form method=POST action="http://your.host.xxx/cgi-bin/wwwboard-vf.pl">
Vous devez changer l'URL d'action du formulaire dans action="" et la remplacer par ce que vous avez défini dans wwwboard-vf.pl comme $cgi_url.
___________________________________________________________________________
FAQ.HTML ========
Ce fichier n'a pas besoin d'être modifié, à moins que vous ne vouliez en changer l'en-tête, ou le titre, ou que vous souhaitiez ajouter un lien de retour au Forum.
Ce fichier doit être placé dans le répertoire $basedir avec le nom défini dans $faq_file dans le fichier wwwboard-vf.pl
Il ne devrait pas être nécessaire de changer son chmod (744, lisible par tous).
___________________________________________________________________________
MESSAGES/ =========
C'est un réperoire qui doit être créé dans $basedir comme défini dans wwwboard-vf.pl. Il doit être chmod 777 afin que les articles puissent y être écrits avec votre UID.
___________________________________________________________________________
DATA.TXT ========
Mettez simplement ce fichier dans $basedir comme défini dans wwwboard-vf.pl avec chmod 777 afin que le script puisse le modifier et incrémenter le nombre (d'articles). C'est ici que le nombre d'articles est stocké.
___________________________________________________________________________
LISEZMOI.TXT ============
C'est le plus simple. Lisz-le, c'est tout!
FIN DE LA TRADUCTION. Le reste ne vous sera probablement pas utile. __________________________________________________________________________
Version 2.0 Improvements Over 1.0:
* HTML does not mess up postings like the last version did. * There are many more options to allow flexibility in design. * One CGI program instead of three. Makes everything smoother and more efficient. * File names are derived from an incremented number up to 99999 so that messages won't overlap, like they could have with the old pid numbers that were used. * Many more things I can't even begin to list.
___________________________________________________________________________
Version History:
Version 2.0: Complete Re-Write of Version 1.0 11/4 - ALPHA 1 Version Released because many people were writing asking if they could get a copy of it. ___________________________________________________________________________
As with all of my scripts which you can find at my scripts archive:
http://worldwidemart.com/scripts/
These are provided at no charge. You can modify/edit/change/anything you want to these scripts. There are only two things that I ask, neither of which will you be sued for if you don't follow. :-)
1) Please let me know where these are being used I like to see my work in action. you can let me know simply by filling out the on-line from located at: http://worldwidemart.com/scripts/implement.html 2) Please keep my name somewhere in the script. It doesn't have to be noticeable to users, but I appreciate it being in the script somewhere in case you ever pass it on or anything like that. 3) Oh yah, there's a third one, but its the one I care least about. I know how many people like to keep everyone at their own site and therefore do not link to the outside too often, but if at all possible, I would appreciate a link to my scripts archive. Once again, this isn't necessary. 4) Do the rules ever stop you say? This last one is easy to follow: ***HAVE FUN!***
___________________________________________________________________________ Matt Wright * mattw@worldwidemart.com * http://worldwidemart.com/scripts/