| Directories |
In your webspace (www directory), create
the sub-directory 'boards'. Below this directory,
create one directory for each discussion
board that you will be implementing. The
names you use for the directories will not
be easily visible to the user, so names like
'board1', 'board2' etc. are perfectly acceptable. |
|
Once the boards directory has been created,
a template_form.html file needs to be created
in this directory, this is the form that
the user submits/posts into the message board
using. A sample template_form.html file can be downloaded
here. The INSERT_ keywords must be retained if
you make any changes to
your template_form.html
file. These are replaced
by the software
at run-time. |
|
|
| Creating the empty board. |
Once a directory has been created, it should
be populated with the following
files :- |
|
top.html |
Contains the HTML for the top of the discussion
board pages. Here is a basic sample. |
|
bottom.html |
Contains the HTML for the bottom of the discussion
board pages. Here is a basic sample. |
|
msg.xml |
Contains the messages, this should initially
start 'empty'. Download and use this template
file initially. Download msg.xml. |
|
pass.txt |
Contains the admin password. Intially, create
a file containing a single line with 'admin:'
as the only entry. We'll talk about changing
the admin username/password shortly. |
|
forum.conf |
Config file for your discussion board. Download
this template file and
modify as required
(with caution!), comments
are contained in
the file. Download forum.conf. |
|
|
| Accessing and customising. |
The files forum.conf, top.html and bottom.html
should be customised as required. If your
message board stops working for any reason,
it's most likely that you've made an error
in the forum.conf file, please overwrite
it with the default from this page and try
again! The URL for your message board will
be /cgi-bin/XMLBoard/xmlboard.cgi?board=<board
name>. The template_form.html file that
resides in the boards directory can be customised
as required, but ensure that the INSERT_
keywords remain in place. These are substibuted
by the message board software at run-time. |
|
|
| Admin password |
It is important that the admin password and/or
username is changed as soon as possible.
After following the instructions above, the initial admin name will be 'admin' and
the password will be blank! Log on as admin into the discussion board
from the xmlboard.cgi URL
detailed above
(enter admin into the first
box, and then
click on the Admin button). |
|
|
| Need help? |
UVNET can offer consultancy and customisation
for all CGI scripts. We can also undertake
the necessary work needed to implement any
CGI functionality. Contact sales@uv.net now. |