CosmicScripts.com


CosmicSimpleBBS & RSS User Guide


© Copyright CosmicScripts.com (Lyle Hopkins) 2004. All rights reserved. No part of this or any of the attached documents shall be reproduced/stored in any way whatsoever without written permission from the Copyright holder. The Copyright holder holds no responsibility for errors or omissions. No liability is assumed in any way for damages resulting from the use of this document/program.


Sections in this file

1. Installation instructions
2. Trouble shooting
3. BUG report
4. Getting rid of 'CosmicScripts.com' link
5. Using the script


1. Installation Instructions

If you are installing as an RSS feed then your firstly need to remove the files board.html, mainboard.html, message.html and oldboard.html. Then rename the files rss_board.html, rss_index.html, rss_message.html and rss_oldarticles.html to board.html, index.html, message.html and oldarticles.html respectively.

All files from the zip file should be uploaded into a sub-folder of your cgi-bin (we recommend a folder named 'bbs' or 'rss').
ALL FILES, BAR ANY PICTURE FILES, SHOULD BE UPLOADED IN ASCII.

You also need to create a new data folder within the public viewable area of your site (usually in "public_html" or "www"). Do not create this folder within your cgi-bin. We suggest you call this folder "messages" in bbs mode or "articles" in rss mode. The files mainboard.html and oldboard.html OR index.html and oldarticles.html should be placed in this folder, or somewhere publicly viewable, such as "public_html/rss". For RSS the files rss1.xml and rss2.xml should also be put in this folder.

The table below shows what chmod (Unix) each file should be given File Chmod

Filename chmod
bbs.cgi 755
admingen.cgi 755
messages.txt 777
messagesold.txt 777
approve.txt 777
adminpass.txt 777
"messages" or
"articles"
777
sessions 777
rss1.xml 777
rss2.xml 777


The table below shows what file permissions (Win32) each file should be given.

Filename Permissions
bbs.cgi read write execute
admingen.cgi read write execute
messages.txt read write execute delete
messagesold.txt read write execute delete
approve.txt read write execute delete
adminpass.txt read write execute delete
"messages" or
"articles"
read write execute delete
sessions read write execute delete
rss1.xml read write execute delete
rss2.xml read write execute delete

The following files should be opened and modified. To start with, make sure the first line of the file (if it's a script) points to the location of perl on your server. This is usually:

#!usr/bin/perl or #!usr/local/bin/perl. (Make sure you point to perl ver5+)

Files to Adjust
bbs.cgi Adjust user defined variables at top of file
board.html Adjust the HTML to suit your site. Make sure any <!-- COMMENT --> tags stay in place as they are used by the script.
message.html Adjust the HTML to suit your site. Make sure any <!-- COMMENT --> tags stay in place as they are used by the script.

2. Trouble shooting

If the board messages are not being displayed check the file permissions of messages.txt and the messages folder. Also check that the relative path to the messages folder is correct.

If you have any other problems running this script then please check that you have followed the installation to the word. If problems persist then check the FAQ at:

http://www.cosmicscripts.com/faq.shtml

If that's no help then post a message on the help board at the same address and you should get a reply.


3. BUG report

If you find any bugs, glitches or problems then please contact me at:

bugs@cosmicscripts.com

with the subject "CosmicBBS bug report".


4. Getting rid of 'CosmicScripts.com' link

On some of the scripts you may find a small link back to CosmicScripts.com generated at the bottom of the page. Removing this will infringe the copyright and cause you to be sued. So don't try it! If you do want to loose the link then it costs $10 per script. You will then receive an amended script without the link back. Go to:

http://www.cosmicscripts.com/amended


5. Using this script

Link to mainboard.html or index.html to display the Bulletin Board or RSS feed. Once you have added the first message or article the HTML will update to that set in board.html and message.html. If you are selecting to keep old board messages then link to oldboard.html or oldarticles.html to display them.

This script has several useful features. It blocks HTML and JavaScript so people cannot corrupt you page, but allows you to use certain effects, such as Bold, Colored text and URL's. To have bold text use [b], such as [b]Bold[/b], to have colored text use [c color] such as [c red]red[/c] or even [c #00FF00]green[/c]. URL's will be read and changed to HTML links.

The RSS feeds are output to rss1.xml and rss2.xml. For a guide on what to do once you have your feeds visit our starting an rss feed guide.

To use the scripts admin capabilities run bbs.cgi?want=admin from your browser. From there you will be able to regenerate the board, edit, remove or approve messages and add new articles. For this you will first need to run admingen.cgi to generate the login password.

BBS and RSS powered by CosmicScripts.com
free cgi scripts from CosmicScripts.com
cgi scripts from CosmicPerl.com