home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
MISC
/
DVOTE10A.ZIP
/
DOORVOTE.DOC
< prev
next >
Wrap
Text File
|
1997-10-03
|
9KB
|
194 lines
────────────────────────────────────────────────────────────────────────────
DoorVote v1.0a
by SaltySoft
Copyright (C) 1997 David Kiesling
All rights reserved.
Support BBS:
Shoe Salt BBS 707-465-3087 33.6 kbps
World Wide Web:
http://www.vpdev.com/saltysoft
SaltySoft Software
Internet Email: c/o David Kiesling
saltysoft@vpdev.com 550 Sandhill Rd.
Crescent City, CA 95531 USA
────────────────────────────────────────────────────────────────────────────
Table of Contents
I. Introduction
II. Setup
III. Samples & Examples
IV. Support
V. Attention Programmers!
VI. A Few Last Words
------------------------------ Disclaimer ------------------------------
The author of this program and his affiliates cannot be held legally
responsible for any damage caused as a result of the use or misuse of
this program, nor for the precious bytes it takes up on your HD.
------------------------------------------------------------------------
-------------------------- License Agreement ---------------------------
This program is distributed under the shareware concept. You are granted
a license to use and distribute this program as you wish. However, the
contents of the compressed .ZIP archive or the uncompressed EXE file may
NOT be modified in any respect by anyone other than the author.
------------------------------------------------------------------------
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
I. Introduction
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Requirements: * BBS that can call a batch file to run a door
* 8086 or higher processor (I know, I'm pushing it!)
Sysops normally have to do a lot of guesswork on the popularity of
certain doors on their BBS. Face it, most users just don't want to
bother giving the sysop feedback on anything.
As each user exits a certain door, DoorVote bluntly asks users how
they liked it, giving them a list of answers to choose from. It
records their answer and tabulates all the votes in a Vote Results
File, viewable by the sysop. A Log File is also created so the sysop
can find out exactly who chose which option.
Once a user has voted, DoorVote will not ask them to vote again.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
II. Setup
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
DoorVote is run with the following syntax:
doorvote.exe <config file>
ex: doorvote.exe doorvote.cfg
For multiple nodes, simply create a config file for each node. The
config filenames can be anything you like.
You also can just have a separate config file for each door you set
DoorVote up with, rather than having more than one copy of DoorVote on your
system. But remember to have a different name for the Logfile and Voting
Results File for each door, so that the results don't get mixed up.
Layout of Config File:
----------------------
LINE 1: David Kiesling <- Sysop Name
LINE 2: Shoe Salt <- BBS Name
LINE 3: 0000000000 <- Registration Code
LINE 4: C:\TRIBBS\DOOR.SYS <- Full path to DOOR.SYS file
LINE 5: 0 <- Non-standard IRQ for the comport
0 = use the standard IRQ for the port
LINE 6: 5 <- Maximum minutes allowed in door
0 = read minutes left from dropfile
LINE 7: 5 <- Keyboard input timeout in minutes. If
user hasn't press a key in this amount
of time, Fake Bulletin will terminate.
0 = disable this feature
LINE 8: doorvote.log <- Log filename to use
(for sysop to view voting log)
LINE 9: doorvote.dat <- Voting results filename to use
(for sysop to view voting results)
LINE 10: votehead.ans <- ANSI file to display at top of screen
above menu
LINE 11: votehead.bbs <- Same as above, except ASCII instead of
ANSI, for if caller has ANSI turned off
LINES 12-21: <- Voting choices available to user.
Minimum of 2 and maximum of 10 choices.
See doorvote.cfg for example.
Doorvote.cfg contained in this archive is a sample config file
and contains short notes reminding you what each line is for.
IMPORTANT!!
Remember to delete doorvote.log and doorvote.dat every time you modify
the voting choices in the config file. Otherwise it will get confused
and do crazy stuff. These two files are not only used as report files
for the sysop, they're also used as records that the program reads. So
if you decide to modify those files in any way, don't say I didn't
warn you. In short - Don't do it!
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
III. Samples & Examples
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Votehead.ans and Votehead.bbs are sample ANSI and ASCII files for use
as a menu header. Votehead.ans is displayed if the caller has ANSI
enabled and votehead.bbs is displayed if not. You can modify or
replace either as you wish, but note that only the first 5 lines of
either file will be displayed above the menu, simply because more
than that won't fit!
Now you're probably wondering how to set DoorVote up to run after a
certain door before it returns to the BBS. You just put it in the
door's batch file to run right after the door. Here's a sample batch
file for the classic doorgame Trade Wars 2002:
cd\tribbs\doors\tws <- change to door directory
tw2002.exe <- run door
cd\tribbs\doorvote <- change to DoorVote directory
doorvote doorvote.cfg <- run DoorVote
cd\tribbs <- change to BBS directory
board <- restart the BBS
Pretty easy, huh? I think that's a good enough explanation, but if you
don't have much experience with this kinda thing I'd be happy to help
you out.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
IV. Support
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
You don't have to be a registered user to recieve support for
DoorVote. Please contact me in any of the ways mentioned at the
beginning of this file for support. I'd love to hear any and all
comments, questions, or suggestions.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
V. Attention Programmers!
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Are you a programmer?
The new owner (as of 01/01/97) of TriBBS, Gary Price, has made a
new API for PowerBASIC for easier creation of programs that access
TriBBS's data files. I've used it for recent TriBBS utilities I've
made. It's completely FREE for anyone that wants it and I highly
recommend it. It is strictly for PowerBASIC 3.2. You may contact
Gary Price:
by email - gwprice@worldnet.att.net
by BBS - Freejack's Place (Home of TriBBS) 207-739-7121
by web - http://www.tribbs.com
PowerBasic is a programming language which is quickly rising in
popularity, containing elements of both C and Pascal and even some
built-in Assembly. Although 99% compatible with QuickBasic 4.5, it's
far more advanced. It sells for $150 but a free demo may be picked
up from their web site at http://www.powerbasic.com
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
VI. A Few Last Words
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Special thanks to the DoorVote beta testers:
Chris Richardson