P O W E R L O G O N Version 4.03 for Wildcat! 5 _____________________________________________________________ Logon Scripting Utility Developed by Crazy Larry's Online Art 503-357-2710 cloa@europa.com http://www.europa.com/~cloa/ _____________________________________________________________ TABLE OF CONTENTS Overview . . . . . . . . . . . . . . . . . . . . . . . . . 2 New Features . . . . . . . . . . . . . . . . . . . . . . . 2 Installation . . . . . . . . . . . . . . . . . . . . . . . 3 Editing Logon Scripts . . . . . . . . . . . . . . . . . . . 3 Power Logon Commands . . . . . . . . . . . . . . . . . . . 4 Debugging/Troubleshooting . . . . . . . . . . . . . . . . . 6 Packing List . . . . . . . . . . . . . . . . . . . . . . . 6 Shareware Notice . . . . . . . . . . . . . . . . . . . . . 6 Subscription Service . . . . . . . . . . . . . . . . . . . 6 Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . 7 Page 2 OVERVIEW _____________________________________________________________ Power Logon is essentially a "scripting utility" that allows you to fully control the sequence of events that occurs when a caller logs onto your BBS. Separate scripts can be created for each Access Profile, and/or for an individual user. With Power Logon, it is possible to arrange the sequence of events by simply placing the commands in each script file, in the order that you want them to be executed. Since user-specific scripts are available, you can offer your callers a custom logon sequence as a bonus for subscribing to your BBS, or as a separate service. Some files included in the archive use long-file names, and must be in the full, long-file-name format for Wildcat! to see them. I suggest using a program such as WinZip for Windows 95 to extract the files from the original archive. NEW FEATURES _____________________________________________________________ If you used Power Logon for Wildcat! v4.nn, then you already know how powerful, and useful this product is. However there have been several changes to this program as a result of the many changes in Wildcat! 5 and wcCode itself. Several of the commands have changed, and a few are no longer supported. If you are upgrading, you should consider creating all new configuration (script) files for this version. Power Logon now supports long-file-names supported by Win 95, which makes things a lot easier for me . Now your scripts are named according to the access profile, and user names. One of the best new features in Power Logon, is the built-in "Who Called Today" program! Two commands are available that allow you to add a callers name to this list, and display the list. This feature is disabled if neither of these commands appear in any of your scripts. For more information, see the list of commands later in this documentation. You can also use the included program, "List Who Called.WCX" to view the list of the days callers from any menu. An additional file called "Navterm.wcx" has also been added, and is used to include callers that use wcNavigator to access your BBS, to the list of who called. Wildcat! turns control of the logon sequence over to the GUI side when a user logs on to your BBS. This means that the logon script will never be used during logon. If Navterm.wcx is used, it will add the callers name to the list of who called automatically. Local logons will not be recorded. Page 3 INSTALLATION _____________________________________________________________ To install or upgrade from a prior version of Power Logon: 1] Place all wcCode executable (*.WCX) files in your Wildcat home directory. 2] Run wcMenu, and add the file "LOGONCFG.WCX" to your Sysop Menu. (Be sure to set the access level for this program so that you can use it). 3] If you plan to use the built-in Who Called Today feature, you might want to add the file "List Who Called.Wcx" to your Main, or any other menu before exiting wcMenu. 4] Save the changes to your menu, log onto your BBS, and run the configuration program that you just installed. 5] If you registered Power Logon for Wildcat! 4, you need to copy "PWRLOGON.KEY" from your old home directory to your new \WC5\DATA subdirectory. EDITING LOGON SCRIPTS _____________________________________________________________ Logon scripts are simple text files that you can easily edit offline using your favorite text editor. The Configuration program will launch Windows "Notepad" to edit them. When Power Logon starts, it looks for a user-specific script file. If one is not found, it will then look for a script that matches the users access level. If this file does not exist, it will look for the default LOGON.PLS. If this file is not available, it will execute the normal, default logon sequence that MSI hard-codes in Wildcat! Logon scripts can be as long as you want them, but they will only be read up to the 100th line. You can add comments in your script files wherever you please, however, for the best results, you should be aware of the following guidelines. 1] Comments should begin with a "<" character so that Power Logon will recognize and ignore it. 2] Any text that does not start with the "<" character will be treated as an instruction. If the instruction is not valid, Power Logon will ignore it, however, instructions take time to proccess. 3] If you want to put comments next to your commands, it is important that you put the command first, followed by a comment character (<) and the comment itself. 4] Adding blank lines will help to make your script files a bit easier to read, and will be ignored entirely. 5] Commands are not case sensitive. Page 4 POWER LOGON COMMANDS _____________________________________________________________ Command Description ============== ======================================= ADDTIME n Adds "n" minutes to the callers time left for the day. ADDWHOCALLED Adds the callers name to the built-in built-in "Who called today" list. ASKCHECKMAIL Asks the caller if s/he would like to check his/her inbox. BEEP Beeps the local and remote console BIRTHDAY Displays the appropriate message if it is the callers birthday. CHANGESETTINGS Displays the "Your settings" menu to the caller. CHECKBULLETINS Checks for updated bulletins, and prompts the user to view the Bulletin menu if any exist. CHECKFASTLOGON Exits the program at this point if the caller used a fast-logon character. CHECKGROUP Displays any appropriate group display files. CHECKMAIL Checks for waiting mail. CHECKNEWFILES Asks the caller if s/he would like to check the database for new files CHECKNEWSLETTER Prompts the user to read the newsletter if it has been updated since his/her last call. CHECKSYSOP Checks to see if the Sysop is logging in. If so, exits the logon proccess regardless of the use of a fast logon character. CLS Just as it sounds, it clears the screen. CR Sends a carraige return to the caller DISPLAYFILE (filename) Displays the specified file to the caller. A full path is required. * DLNAVIGATOR Prompts the user when the file WCNAV.EXE has been updated since their last logon. Page 5 DOWNLOAD (filename) Prompts the caller to download the file specified. ENTER Displays the "Press [ENTER] to continue" prompt. GREETINGS Displays the "Good Morning, you are..." prompt -in a centered Window. HELLO Displays your hello files in numerical order LOGOFF Forces a logoff NEWFILES Checks for new files (does not prompt the user beforehand). See "CheckNewFiles" * PLAYWAVE (filename) Plays the .wav files specified. Note that the logon sequence is suspended while the .wav file is playing. QUESDATE Checks to see if the QUESDATE questionnaire has been updated. QUESTIONNAIRE (filename) Displays a questionnaire file that follows this command. (no path is required) QUOTES Displays the "Quote of the day". RUN (filename) Runs a specified .WCX file. This file must exist in your Wildcat! home directory -this is not my choice, but MSI has made it this way. No path or extension is required. If you need to pass a parameter to the wcCode you are launching, you must use a forward slash "/" to properly define it. Example: RUN COMMENT TO SYSOP /Y -This would force the caller to leave a comment to the sysop. * STATS Displays a custom statistics screen UPLOAD (filename) Prompts the caller to upload a file. If the filename is not specified, a batch upload is allowed. USERDISPLAY Displays any user-specific display files that my exist. WHOCALLEDTODAY Displays the "Who called today" list. WHOISONLINE Displays the list of who is logged in on other nodes. * denotes new commands to this version Page 6 DEBUGGING _____________________________________________________________ If you have trouble running Power Logon, you can place the command DEBUG at the top of a script file. This will tell Power Logon to create a file called DEBUGLOG.nnn in your \WC5\DATA directory, where the nnn is the node number. This log file will list what time the configuration file was used, and what commands were read as instructions or comments. These files are useful for customer support, but left unattended can grow quite large. You can also view your debuglog.nn files simply by running the Configuration Utility for Power Logon (LOGONCFG.WCX). PACKING LIST ------------ Power Logon should never be shipped without all of the files listed below. If -any- of these files are missing from the original archive, please pick up a new copy, as there may be a chance that you have a "contaminated" copy. LOGON.WCX The actual logon program. LOGONCFG.WCX The configuration (editor) for Power Logon. MAIN.WCX (optional) Use this program if you want to support fast logon characters with Power Logon. It also provides the caller with unique, "windowed" prompts at logon. LIST WHO CALLED.WCX This program allows you to view the list of the days callers separate from Power Logon. Due to the long filename, you may need to use WinZip for Win95 to extract this file. NAVTERM.WCX This program is optional, and is only used to add callers using wcNav to your who called today list. PWRLOGON.TXT This document. REGISTER.FRM The registration form for CLOA products. CLASS.TXT The "CLASS" subscription form. FILE_ID.DIZ The detailed description for this program. DESC.SDI The small description for this program. Page 7 SHAREWARE NOTICE _____________________________________________________________ This product is being released as shareware. Although there are no limits to the unregistered version, if you use this product for more than 30 days, you should register it. Your registration will work for all future versions and updates. To register your copy, refer to the file REGISTER.FRM. For fastest service, call the support BBS at 503-357-2710, and register it online using your Credit Card. SUBSCRIPTION SERVICE _____________________________________________________________ This program is supported by a new Subscription Service for the Wildcat! 5 line of products called "C.L.A.S.S.", Crazy Larry's Automatic Subscription Service. This service allows you to register all wcCode products for Wildcat! 5, for a specified period of time. For additoinal information, please read the file CLASS.TXT. DISCLAIMER _____________________________________________________________ By using this or any other CLOA wcCode product, you take all responsibility for any damages that may result from it's use or misuse, on your system, NO EXCEPTIONS! Thousands of Wildcat! Sysops around the world are using CLOA wcCode products, and not a single fatality has been reported. Please note that animals are never used for product testing! AKNOWLEDGMENTS _____________________________________________________________ My thanks to all of the SysOps that have helped during the development of this, and all other wcCode products, through alpha and beta testing. My warmest regards to those who have supported my tireless efforts by registering!