home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fresh Fish 8
/
FreshFishVol8-CD1.bin
/
new
/
comm
/
bbs
/
bull
/
bulletin.doc
< prev
next >
Wrap
Text File
|
1994-08-03
|
5KB
|
130 lines
Citadel bulletin Program
Version 2.11
Copyrighted 1992-94 Custom Services
***All Rights Reserved***
Introduction:
Citadel has long lacked an ability to display bulletins. To correct
for this, I created Bulletin. This program will read a directory
and display all the files of the name *.hlp as bulletins. It also
has the ability to scan sub-directories and display the items in the
directory as a menu if that item is selected. There is no limit to
the number of items or levels available, but for practical usage it
makes sense to limit a directory to 15-20 items. While this door is
made for the Citadel BBS program, it may be used with any BBS program
that supports STDIO doors.
Format:
Each text file is opened and the first line is read and used as the
menu description. This makes up the menu. In each directory there
is a file called header.dir, this is the description of the contents
and is displayed the same as an item when you select the item which
is a directory. You should have one in the top level bulletin
directory. the basic structure looks like this:
[bulletin directory]
|
+---------------+---------+
| |
[ directory] [ *.hlp ] Level 0
|
+----+-------+-------------------+
| | |
header.dir [other directores] [ *.hlp] Level 1
The files (*.hlp) at level 0 would be displayed along with each
directory. The first line is displayed. If the directory is selected
the header.dir file is displayed, then the *.hlp files make up the
menu(along with other directories). This allows you to organize by
subjects(door games for example).
The rest of the files(*.hlp, header.dir) are just plain text to display
when the item is selected. This program is compatible with the news
files of the space empire and Nuclear Warfare doors for example. If
you direct your door news files(or create a link is running 2.0), you
can have the bulletins display them for users. Note, registration of
this door will remove the reminder that displays at the beginning of
each level.
Requirements:
You must be running the Citadel 3.42.E13 or later to have an autodoor
directed toward the user Citadel. You must also have CTDLAUX: mounted
and the configuration data setup for the door and event as follows:
#door Bull bull bbs:bbs/bulletins anyone modem unlimited
Bulletins for Users.
<ctdlaux: >ctdlaux: bbs:bbs/bulletins
#door Bxll bulletin bbs:bbs/bulletins autodoor modem unlimited
Bulletins for Users.
<ctdlaux: >ctdlaux: bbs:bbs/bulletins
#event All 0:00 autodoor quiet 1440 "Bulletins" "Citadel" Bxll
This creates two door entries, one the users can use at anytime with
the command ".D Bull". The other door entry is an autodoor for every
user. The Event(required for an autodoor) says that the bulletins
door is available every day, all day(1440 minutes == 24 hours).
You may taylor these entries as you desire.
This door also uses two environment variables for registering. If you
have not registered this program yet, then do not worry about them since
the program will give an error if they exist and are incorrect.
Variable Usage
BULL_REGISTRATION This is the registration key.
BULL_BBS_NAME This is the BBS name the door is registered too.
Do not create them until you have registered. If they exist and are
incorrect(the BBS_NAME is case sensitive), the bbs will delay and report
an error to the user. Once you have registered your BBS, you can create
them with:
SETENV BULL_BBS_NAME "The Amiga Zone"
SETENV BULL_REGISTRATION <the key I give you>
SETENV does not save the values permanently. You will have to have
these statements in your USER_STARTUP(or STARTUP-SEQUENCE if under 1.3).
CLI Usage:
This door may be run from the cli. If you put it on your path, then
you could run the door the same as the users from you cli shell window
with:
bulletin <directory>
<directory> is the top level directory which contains the bulletins.
it may be any place on you disk drives.
Shareware:
This door is a shareware product. The registration fee is only $10.
You may use this program for up to 30 days. Beyond that time, you
should feel really guilty that you have not paid the fee.
Registration will get you a key for your BBS. When you register, please
include the BBS name, name of the program your registering, and the
$10 fee. The Key will remove the reminder.
Send your registration fee, or if you decide not to register a
comment or two as to why(and what improvements to make) to:
Custom Services
P. O. Box 254
Moorestown, NJ 08057
Bugs:
There are no know bugs in this program. If you have a problem with
this door, contact me via the Citadel 68K or Amiga rooms on your
nearest Citadel. You can always call the Amiga Zone at (609) 953-8159
and leave comments.