Table of Contents
SlyVote can be acquired in one of the following ways:
- Download SlyVote from the Digital Distortion BBS Doors and Tools page
Minimum Synchronet version and .js scripts
exec/load directory) :
- dd_lightbar_menu.js (
In addition, SlyVote has an option to post a poll, which executes postpoll.js (in the
SlyVote requires an ANSI terminal, since SlyVote makes use of lightbar menus which do cursor movement, as well as a scrolling frame to display poll results.
exec/load are up to date (it wouldn't hurt to also ensure your .js files in your
exec/load to your sbbs/exec and sbbs/exec/load directories.
Synchronet 3.17 can be downloaded from Vertrauen (the home BBS of Synchronet). The fresh install of Synchronet 3.17 is ftp://ftp.synchro.net/sbbs317b.zip, and the upgrade package is ftp://ftp.synchro.net/sbup317b.zip. After installing Synchronet 3.17, if you want to use the latest daily-built (beta) Synchronet binaries, you can download sbbs_dev.zip for Windows or sbbs_dev.tgz for Linux. If you want to build it yourself on Linux, see
nix for instructions. See
dev for more information on updating to the latest development build of Synchronet.
SlyVote is comprised of the following files:
- slyvote.js: The SlyVote script
- slyvote.cfg: The SlyVote configuration file
slyvote.cfg is a plain text file, so it can be edited using any text editor.
You can copy slyvote.js and slyvote.cfg to a directory of your choice. slyvote.cfg, if it exists in these directories, will be read from these directories in order: sbbs/mods sbbs/ctrl Same directory as slyvote.js
Also, SlyVote also depends on dd_lightbar_menu.js, which should exist in your sbbs/
Configuration with Synchronet
Run SCFG (Synchronet configuration) and add the following configuration to SCFG->External Programs->Online Programs (Doors) in the section of your choice. Note that this assumes SlyVote is installed in sbbs/xtrn/slyvote.
Name SlyVote Voting Booth Internal Code SLYVOTE Start-up Directory ../xtrn/slyvote Command Line ?slyvote.js Clean-up Command Line Execution Cost None Access Requirements ANSI Execution Requirements Multiple Concurrent Users Yes Intercept I/O No Native Executable No Use Shell to Execute No Modify User Data No Execute on Event No Pause After Execution No BBS Drop File Type None Place Drop File In Node Directory
SlyVote can be configured to use a single sub-board or multiple sub-boards, allowing the user to choose a sub-board and vote on polls and view poll results in the various sub-boards configured with SlyVote. SlyVote's configuration file has the following options:
|showAvatars||Whether or not to show avatars of the people who post polls in the results. Valid values are true and false. Defaults to true.|
|useAllAvailableSubBoards||Whether or not to use all available sub-boards where voting is enabled. Valid values are true and false. This defaults to true. If this is set to true, then any subBoardsCodes values in the configuration file (described below) will be ignored.|
|subBoardCodes||A comma-separated list of internal sub-board codes specifying which sub-board or sub-boards to use for polls. A single sub-board code can be specified if you only want to use one sub-board with SlyVote. Also, subBoardCodes can appear multiple times in slyvote.cfg, and all specified sub-boards will be used. If any of the specified sub-board codes don't exist or refer to sub-boards that don't allow voting, then they will not be used.|
|startupSubBoardCode||Optional: An internal sub-board code for a sub-board to automatically start in if there are multiple sub-boards configured. If this is set, SlyVote will not prompt the user for a sub-board on startup and will start in the sub-board specified by this setting.|
Additional notes for sysops
For sysops, polls can be deleted when viewing results from SlyVote.
SlyVote uses the following lines from Synchronet's text.dat file (located in the sbbs/ctrl directory):
- 120 (CantPostOnSub)
- 503 (SelectItemWhich)
- 759 (CantReadSub)
- 779 (VotingNotAllowed)
- 780 (VotedAlready)
- 781 (R_Voting)
- 787 (PollVoteNotice)
- 791 (BallotHdr)