Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
howto:door:slyvote [2018/03/01 12:21] – old revision restored digital manhowto:door:slyvote [2019/01/03 13:21] – Changed spelling of files to lowercase. Updated the Synchronet 3.17 download links to the official release. nightfox
Line 1: Line 1:
 ====== SlyVote ====== ====== SlyVote ======
-[[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|SlyVote]] version 0.34 beta (released on 2018-01-28) is a voting booth door for Synchronet (written in JavaScript) for viewing and voting on polls, as well as creating polls.  SlyVote makes use of the voting feature added in Synchronet 3.17 and also supports displaying of avatars for the people who post polls (avatars were also added in Synchronet 3.17).+[[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|SlyVote]] is a voting booth door for Synchronet (written in JavaScript) for viewing and voting on polls, as well as creating polls.  SlyVote makes use of the voting feature added in Synchronet 3.17 and also supports displaying of avatars for the people who post polls (avatars were also added in Synchronet 3.17).
  
 ===== Getting SlyVote ===== ===== Getting SlyVote =====
 SlyVote can be acquired in one of the following ways:\\ SlyVote can be acquired in one of the following ways:\\
-  * Browse to the ''[[dev:CVS]]'' and download SlyVote from the SlyVote directory within ''[[dir:xtrn]]'' ([[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/xtrn/SlyVote|CVS link]] or [[http://cvs-mirror.synchro.net/cgi-bin/viewcvs.cgi/xtrn/SlyVote|mirror CVS link]])+  * Browse to the ''[[dev:CVS]]'' and download SlyVote from the SlyVote directory within ''[[dir:xtrn]]'' ([[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/xtrn/slyvote|CVS link]] or [[http://cvs-mirror.synchro.net/cgi-bin/viewcvs.cgi/xtrn/slyvote|mirror CVS link]])
   * Download SlyVote from the [[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|Digital Distortion BBS Doors and Tools page]]   * Download SlyVote from the [[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|Digital Distortion BBS Doors and Tools page]]
  
 ===== Minimum Synchronet version and .js scripts ===== ===== Minimum Synchronet version and .js scripts =====
-SlyVote requires Synchronet 3.17 or newer (for 3.17 beta, a build from August 19, 2017 or newer) and the latest of the following JavaScript scripts (in the ''[[dir:exec]]''/load directory) :\\+SlyVote requires Synchronet 3.17 or newer and makes use of the following JavaScript scripts (in the ''[[dir:exec]]''/load directory) :\\
   * sbbsdefs.js   * sbbsdefs.js
   * text.js   * text.js
   * frame.js   * frame.js
   * scrollbar.js   * scrollbar.js
-  * DDLightbarMenu.js+  * dd_lightbar_menu.js (''[[custom:javascript:lib:ddlightbarmenu.js]]'')
   * smbdefs.js   * smbdefs.js
   * avatar_lib.js   * avatar_lib.js
Line 23: Line 23:
 First, ensure that you have an up-to-date Synchronet system running Synchronet 3.17 or higher, and ensure that your Synchronet JavaScript files in sbbs/''[[dir:exec]]''/load are up to date (it wouldn't hurt to also ensure your .js files in your ''[[dir:exec]]'' directory are also up to date).  The easiest way to update your JavaScript files would probably be to download [[ftp://vert.synchro.net/Synchronet/sbbs_run.zip|sbbs_run.zip from Vertrauen]], extract that somewhere, and then copy the .js files from ''[[dir:exec]]'' and ''[[dir:exec]]''/load to your sbbs/exec and sbbs/exec/load directories. First, ensure that you have an up-to-date Synchronet system running Synchronet 3.17 or higher, and ensure that your Synchronet JavaScript files in sbbs/''[[dir:exec]]''/load are up to date (it wouldn't hurt to also ensure your .js files in your ''[[dir:exec]]'' directory are also up to date).  The easiest way to update your JavaScript files would probably be to download [[ftp://vert.synchro.net/Synchronet/sbbs_run.zip|sbbs_run.zip from Vertrauen]], extract that somewhere, and then copy the .js files from ''[[dir:exec]]'' and ''[[dir:exec]]''/load to your sbbs/exec and sbbs/exec/load directories.
  
-Before the official Synchronet 3.17 is/was released, daily 3.17 beta builds can be downloaded from [[http://vert.synchro.net|Vertrauen]] (the home BBS of Synchronet).  For daily pre-built Windows binaries/executables, download [[ftp://vert.synchro.net/Synchronet/sbbs_dev.zip|sbbs_dev.zip]], and for Linux binaries, download [[ftp://vert.synchro.net/Synchronet/sbbs_dev.tgz|sbbs_dev.tgz]], or you may build it yourself (see ''[[install:nix]]'' for building Synchronet on *nix systems).  See ''[[install:dev]]'' for more information on updating to the latest development build of Synchronet.+Synchronet 3.17 can be downloaded from [[http://vert.synchro.net|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]].  For daily-built Linux binaries, download [[ftp://vert.synchro.net/Synchronet/sbbs_dev.tgz|sbbs_dev.tgz]], or you may build it yourself (see ''[[install:nix]]'' for building Synchronet on *nix systems).  See ''[[install:dev]]'' for more information on updating to the latest development build of Synchronet.
  
 SlyVote is comprised of the following files: SlyVote is comprised of the following files:
-  * SlyVote.js: The SlyVote script +  * slyvote.js: The SlyVote script 
-  * SlyVote.cfg: The SlyVote configuration file+  * slyvote.cfg: The SlyVote configuration file
  
-SlyVote.cfg is a plain text file, so it can be edited using any text editor.+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.+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
  
 ===== Configuration with Synchronet ===== ===== Configuration with Synchronet =====
-Run SCFG (Synchronet configuration) and add the following configuration to [[util:SCFG]]->External Programs->Online Programs (Doors) in the section of your choice.  Note that this assumes SlyVote is installed in sbbs/xtrn/SlyVote.+Run SCFG (Synchronet configuration) and add the following configuration to [[util: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   Name                            SlyVote Voting Booth
   Internal Code                   SLYVOTE   Internal Code                   SLYVOTE
-  Start-up Directory              ../xtrn/SlyVote +  Start-up Directory              ../xtrn/slyvote 
-  Command Line                    ?SlyVote.js+  Command Line                    ?slyvote.js
   Clean-up Command Line              Clean-up Command Line           
   Execution Cost                  None   Execution Cost                  None
Line 59: Line 62:
 | 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. | | 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. | | 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. |+| 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. | | 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. |
  
Line 67: Line 70:
 SlyVote uses the following lines from Synchronet's text.dat file (located in the sbbs/ctrl directory): SlyVote uses the following lines from Synchronet's text.dat file (located in the sbbs/ctrl directory):
   * 120 (CantPostOnSub)   * 120 (CantPostOnSub)
-  * 501 (SelectItemHdr) 
   * 503 (SelectItemWhich)   * 503 (SelectItemWhich)
   * 759 (CantReadSub)   * 759 (CantReadSub)
Line 74: Line 76:
   * 781 (R_Voting)   * 781 (R_Voting)
   * 787 (PollVoteNotice)   * 787 (PollVoteNotice)
 +  * 791 (BallotHdr)
  
 ===== See Also ===== ===== See Also =====
howto/door/slyvote.txt · Last modified: 2023/12/10 13:22 by Nightfox
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0