---

Doppelklick

---

Through this script it's possible to run message boards, similar to newsboard in the www. The discussion board is similar structured like the guestbook. It has several more features than the common newsboards which can be found elsewhere:

• every user of the board receives his password, so that in future only this user is able to use his name
• messages can be removed from the board by their writers, by giving their passwords
• the board's maintainer has the possibility of logging every action, or actions after his liking
• there are several options to style the board's design after one's own wishes
• single messages, as well as whole threads or the whole content of the board can be mailed
• etc. etc. etc.

Source Code

board32.pl
cgi-library.pl

Complete Source in archived form V 3.2
Archive of all programs and scripts

Sample execution

You can find a sample execution at:
http://.../cgi-bin/board32.pl?rw=read&varfile=/home/unrzc9/data/cgi-board.var

Execution

Execution of the program can be achieved by calling it from it's exact location:
http://www.xwolf.com/cgilocal/board32.pl (or wherever it is stored)
plus two parameters:

• rw=read/write - With rw=read all entries of the board are read, with rw=write you can make a new entry.
• varfile=(filename) - Here you call the file, where all important settings of your board are stored

The Settings

These are the settings of a sample varfile (a copy of my own):

# After this point the parameters are starting.

remove_days==120

# After remove_days days, messages will be removed automatically

# The following file with html-code will be displayed at top if its set

HTML_TOP==

# The following file with html-code will be displayed at bot if its set

HTML_BOT==

hintergrund==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/back1.jpg

# Here you can define the background of the page. An URL-address.

titel==The CGI-Board

# The title of the guestbook.

top==

# What you want to see above the title. Maybe an icon...

bottom==

# What you want to see at the end of the page.

book==/home2/xwolf/data/cgi-board.dat

# The file of the board-entries. Must be (chmod a=rw)

book_alt==/home2/xwolf/data/cgi-board.alt

# The back-save-file of the board-entries. Must be (chmod a=rw)

forbit_html==0

# If set to 1 , no html-tags are allowed. Else set 0.

counter==0

# 0 off, 1 sets the improved counter on. Don't forget to create the needed files for this

allow_home==1

# If 1 , the user can give his homepage too, else 0

language==english

# You can set it to 'english' or to 'german'

need_mail==0

# If the author is forced to give his email-address

answer_mail==0

# If an mail will send to the author after his entry. Not yet ready.

message_mail==1

# 1 for on, 0 for off. Enables the possibility to send messages with email.

need_pass==1

# Set it to 1, if the users of the board have to use passwords, else 0

passcode==/home2/xwolf/data/cgi-board.pass

# In this file the passcodes of the users will be written.

logfile==/home2/xwolf/data/cgi-board.log

# This file logs the things the user defines in the variable 3

log==3

# 0=no log,1=log wrong passcodes,2=log delete message,3 log all

moderator==xwolf@xwolf.com

# Write here the email-address of the moderator of this board!

mod_name==Wolfgang Wiese

# Write here the name of the moderator.

compact==0

# 0 or 1. If it's set to 1, below the displayed text of an entry, the table

no_dl==1

# 0 or 1. If 1 is set, the <dl>'s will not made at follow-ups.

# with all documents will appear. If 0, not.

show_time==1

# If 0, no time will shown. 1 will show the date, 2 the date and time

italic==0

# 1 or 0. If 'on' the input will be displayed italic.

icons_on==yes

# 'yes', 'no' or 'only' - will display the links below the text with icons, only with icons, or without

text_start==

text_stop==

# These both tags will surround the output. If italic is on, they will

# be set to and .

max_chars==3000

# The number of chars, someone can use in his texts. calculate with 50-100 chars per line

# a read-call.

sort_new==1

# 0=appending, 1=normal sort or 2=normal sort and new messages at top.

infocol==#000000

# The color of the text behind the messagestitle

icon_next==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/2arrow4.gif

icon_last==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/2arrow3.gif

icon_new_message==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/writit3.gif

icon_answer==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/doc07.gif

icon_this_topic==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/idea02.gif

icon_all==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/2arrow2.gif

icon_delete==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/toxic.gif

icon_mail_this==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/envelop2.gif

icon_mail_topic==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/letter.gif

icon_mail_all==http://www.rrze.uni-erlangen.de/~unrzc9/pictures/randys/email02.gif

# Script was made by Wolfgang Wiese, xwolf@xwolf.com

# http://www.rrze.uni-erlangen.de/~unrzc9

You can leave out some of these parameters except title, book, language, and counter. All others will be set to default values then.

If you are not sure how to set parameters, the program offers the option to do that automagically: At first execution add the argument new_config=1. Here is an example: http://www..../board31.pl?rw=read&new_config=1&varfile=/home2/xwolf/data/cgi-board.var This method is a bit more convinient. Please mind to set the varfile to 'writable'. After that, you can set the file to read-only again.

Caution!

As the entries will be written to a file in your directory, this file has to be write- and readable: CHMOD a=rw (filename). Same is true for the varfile. At first execution, the file for the entries should be empty! Following files are needed:

• a varfile. See above. Write- and readable
• an (at first execution empty) datafile for the entries. Write- and readable
• if you have set need_pass, a file is needed where passwords can be stored in. It must be write- and readable for the CGI program.
• if the hidecounter is used, two files, with the name of the datafile PLUS the ending '.count' respectively '.ignore'. The '.count'-file has to be write- and readable, the '.ignore'-file needs just reading-attributes. And a readable file has to be created, where the names of logins are stored, that can access the full host-information of the counter. See: The hidden counter (access counter)

Remarks

It is possible to create an own input mask for new entries, and to give the parameters by method 'POST' to the program. In this case you have to set rw=save. Names of variables are e.g.: name, email, homepage, text. I don't think that this is necessary, though. You should leave that to gurus who have nothing better to do...

Further info can be found in the CGI-Forum.

Have fun using the board!

The Board Index

Source Code

check_boards.pl
cgi-library.pl

Sample Execution

Board index of the FAU

Execution

The program is just for displaying all the boards which are used on the server which uses the discussion board script.

The following syntax is used for the statistic

<IMG SRC="http://.../cgi-bin/boards/check_boards.pl?[&language=(Sprache)]">Board index of the FAU</a>

Where:
(lang) = the output can be in English or German: 'german' or 'english' can be used here. Default value is 'german'.

Best viewed with

Worst viewed with