web design and hosting
features and pricing my account customer support about ICG Link, Inc. contact ICG Link, Inc.

Message Board / Discussion Script
   
 
 
MINIMUM BASIC SETUP

Create a folder within your www/data directory and name it whatever you like (DiscussionName in all the examples below).

Create an HTML page which includes the following two lines in the body:
<! DISCUSSION>
<! POSTBUTTON>
Save this page as DiscussionName.main within www/data/DiscussionName/

<! DISCUSSION> will be replaced by all the existing posts to the board.

<! POSTBUTTON> will be replaced by a "Post a New Message" button.

Link to the board using the following link:
<a href="/cgi-bin/discussion.pl/DiscussionName/">Link Text</a>



OPTIONAL TEMPLATES

DiscussionName.thread - If it exists, it will be used instead of DiscussionName.main to display individual posts. The following lines of code are required on this template:
<! DISCUSSION>
<! POSTBUTTON>
DiscussionName.new - If it exists, it will be used instead of DiscussionName.main for the page on which a user actually types in any new post for the board. The following line of code is required:
<! DISCUSSION>
DiscussionName.ban - If it exists, it will be used to ban certain IPs. (See below for details.)

DiscussionName.pass - If it exists, it will be used to define how the board is password protected. (See below for details.)

DiscussionName.login - If it exists, it will be used to display the login page if the board is password protected. (See below for details.)

ADVANCED OPTIONS for DiscussionName.main

<! POSTBUTTON> - The default text for postbutton on .main is "Post a New Message"

To specify the text used for the postbutton:
<! POSTBUTTON value="text for button here">
To use an image instead of a button:
<! POSTIMAGE SRC="http://www.yoursite.com/image.ext">
The <! POSTBUTTON> tag may be used more than once (for example above and below the <! DISCUSSION> tag)

ADVANCED OPTIONS for DiscussionName.thread

<! POSTBUTTON> - The default text for postbutton on .thread is "Post a Response"

To specify the text used for the postbutton:
<! POSTBUTTON value="text for button here">
To use an image instead of a button:
<! POSTIMAGE SRC="http://www.yoursite.com/image.ext">
<! MAINBUTTON> - Allows a user to post a new message as a new thread instead of a response. The default text for this button is "Post a New Message". The button text can be changed or an image can be used as above.

<! NEXTBUTTON> - Goes to the next post top to bottom regardless of thread. Default button text "Next Post". The button text can be changed or an image can be used as above.

<! PREVBUTTON> - Goes to the previous post top to bottom regardless of thread. Default button text "Previous Post". The button text can be changed or an image can be used as above.

<! DISCUSSION><! /DISCUSSION> - When used alone in the ".thread" template, <! DISCUSSION> generates a standard HTML layout for message content. If accompanied by <! /DISCUSSION> in your template, the script will not generate HTML for the message content, but will consider everything between <! DISCUSSION> and <! /DISCUSSION> as the HTML to use instead.

These tags are for use between <! DISCUSSION> and <! /DISCUSSION>:
<! DATE> - will insert the date the message was posted <! EMAIL> - will insert the poster's email address if the address was entered <! NAME> - will insert the poster's name <! SUBJECT> - will give the message's title <! MESSAGE> - will insert the message body


ADVANCED OPTIONS for DiscussionName.new

<! DISCUSSION><! /DISCUSSION>

When used alone in the ".new" template, <! DISCUSSION> generates a standard HTML submission form. If accompanied by <! /DISCUSSION>, in your template, the script will not generate HTML for the form, but will consider everything between <! DISCUSSION> and <! /DISCUSSION> as the HTML to use instead.

If using both <! DISCUSSION> and <! /DISCUSSION>, the following tags must be between them:
<! NAME> - will insert a text field for the poster's name
<! SUBJECT> - will insert a text field for message's title
<! MESSAGE> - will insert a textarea for message body
<! SUBMITBUTTON> - will insert a submit button reading "Submit Post"
If using both <! DISCUSSION> and <! /DISCUSSION>, the following tags may optionally be used between them:
<! SUBMITBUTTON VALUE="" or SRC=""> may be used as above to specify button text or an image for the button.
<input type="hidden" name="f_required" value="http://www.yoursite.com/filename.html"> may be used to specify an error page if all the required fields are not filled out.
<input type="hidden" name="notify" value="someone@someaddress.com"> may be used to specify an email address for notification of new posts.

BANNING BY IP ADDRESS

Create a a file called DiscussionName.ban within www/data/DiscussionName/

The first line of the file should be the full URL to the page to which banned users are to be redirected. Then include any full or partial ip addresses to be banned. For example:
http://www.icglink.com/banned.html
199.1.88.49
199.1.88.50
207.3.43
Once this file exists, the script will begin writing each user's ip address in HTML comments in the source of your message board.

EXCLUDING HTML IN POSTS AND REPLIES

If you would like to prevent your visitors from posting messages or replies with imbedded html code, you can use one of the following alternative tags:
<! POSTBUTTON_NOHTML> or <! POSTIMAGE_NOHTML>
Either one will make a post area that includes a hidden field called f_nohtml with a value of 1. If that field exists, your visitors can not use html code in their messages. If you are using the hand coded, advanced method described above rather than the "Minimum" method, you can include the following field with the same result:
<input type=hidden name=f_nohtml value=1>


PASSWORD PROTECTION

You can password protect your message board in order to keep all or parts of it private. For example, you could let members see a board but allow only administrators to post. To password protect a message board, simply add a tab-delimited text file called DiscussionName.pass in your /web/data/DiscussionName folder.This file will have three lines that describe which components of the board will be password protected. Here's an example where we have protected replying with the group groupname:
read
post
reply   groupname
(Note: the word reply is separated by the word groupname by a tab). If you want one group to protect the entire board, use the same groupname on each line.If you want to write protect the board, but allow anyone to read it, you could set your file up as follows:
read
post    groupname
reply   groupname
and the board will only ask for a login when you try to post or reply to a post. Use our standard password protection system to manage the passwords. Simply set up a group (with the name groupname in this example) and add users to that group according to the instructions.

Of course, the login page will be generic and plain white if you don't add a login template page called DiscussionName.login to your /web/data/DiscussionName folder. This file should include the tag <! login> which gets replaces by the username/password login table.

ADMINISTRATION

To administer your board, simply go to our Board Admin page using the form below and enter your user name, password and board name.
Domain Name:


EXAMPLE

For an example try this link: /cgi-bin/discussion.pl/testboard/
ICG Link, Inc. 7003 Chadwick Drive, Suite 111, Brentwood, TN 37027