Sunrise Door and Home Software Friday November 24, 2017  





USER PROFILES WINServer Documentation

Download PDF Version

Version 2.1
Author/Contact Al Lawrence/Sunrise Door Software
Overview This Door can be used to capture information about a user, for other users to review. The Sysop has complete control over the questions to ask, and the way the answers will be displayed.
Non-Registered
 Restrictions
- Maximum number of database entries is 10
- Door time limit disabled
- Allow Player to Send and Read Messages from the Door Message Center
- CHAT option is disabled
Installation (1) Create a directory to hold all files
(2) Unzip the archive into the above directory
(3) MOVE the WCX file to your WC5 directory and delete it from the directory created in step (1)
(4) Create a menu entry to run the wcBASIC Door and you MUST pass the FULL drive:\path of the directory as a command line parameter when defining the Door on the menu. An example follows:

Program Name: PROFILES
Parameter:      c:\wc5\doors\PROFILES

(5) Modify the supplied CFG file. A description follows:

CONFIGURATION FILE

# = Requires registration to change to a different value.

** = You can allow certain security levels to play a specific number of times per day instead of the default number specified
previously in the CFG file. The format of each line is:
SECURITY LEVEL=NUMBER of GAMES (Ex: SYSOP=5)

NOTE: There are NO Blank Lines in the Config File!!
SUNRISE-80 BBS Your BBS Name
Al Lawrence Sysop's First AND Last name
00000000 Registration Number
# 0 Time Allowed in Door per day. (0 = BBS Time remaining)
Y Y = Log all callers to USAGEx
N = Do not log callers
2 1 = DO NOT Display ADOPT-A-DOOR Message
2 = Display ADOPT-A-DOOR message
c:\wc5\profile Drive:\Path\ to PICTURE directory
# Y Y = Allow player to send PRIVATE messages from the Door Message Center
N = Do NOT allow PRIVATE messages
# 0 Place PRIVATE messages in this BBS Conf #
# Y Y = Allow player to send PUBLIC messages addressed to ALL from Message Center
N = Do NOT allow PUBLIC messages
# 1 Place PUBLIC messages in this BBS conf. #
# Y Y = Allow Player to Check for Mail from the Door Message Center
N = Do NOT allow Check for Mail
Y Allow player to send EMAIL to Door Author
xxxx@yyyyyyy.zzz Door Author's EMAIL Address
N Y = Allow uploaded pictures to be available IMMEDIATELY (CAUTION!!)
N = Sysop must make picture available MANUALLY (Suggested)
NONE=0 **
NONE=0 **
NONE=0 **
NONE=0 **
NONE=0 **
G Door Rating. Default is G.
Maximum Characters: 5

Maintenance None
Valid Input Characters
 (CHAR.OK)
If you wish to restrict the type of characters a caller may enter, in response to any questions, be sure to either create or edit the CHAR.OK file. This file contains all the valid characters you will accept in response to a Profile question. You can delete CHAR.OK, if you do not wish to validate any input characters or you may edit it to add/change existing entries.

A CHAR.OK file is supplied that contains only the alpha and numeric keys
Questions/Display
Verbiage (PROFILE.DAT)
This file contains all the questions you will be asking the callers to complete, whether or not they must answer the question and the corresponding display verbiage to be used when displaying the caller's answers to the questions.

PROFILE.DAT an ASCII file created/edited with any ASCII editor. Each line will reference an individual question, with a maximum of 38 questions.

The format of each line in the file, is as follows:

aaaaaaaaaaaa|b|ccccccccccccc

where a = the question to be asked (maximum of 50 characters)
b = Y (question MUST be answered)
N (question may be bypassed)
c = verbiage to be used when displaying answer (max of 18 char.)

The program will perform checks on the PROFILE.DAT file and will report any errors it detects. A message will be displayed containing the offending PROFILE.DAT line number and an error number. The error numbers and their meaning follows:

Error 1: Question length greater than 50
Error 2: 'Must answer' field contains other than Y or N
Error 3: Display verbiage length greater than 18
Error 4: File contains more than 38 questions

PLEASE NOTE: When designing the questions, bear in mind that answers to the questions are limited to 18 characters.
Picture Attach and
Picture Downloading
PROFILE allows the Sysop to ATTACH a picture to a User's profile.

The format of the picture files are left up to the Sysop (ie: GIF, PCX, etc). The caller uploads the picture file thru the Profile Door itself. If the Sysop, after reviewing the file, accepts it he/she uses the SYSOP option off the Profile Door Menu to add the FILENAME of the picture to the appropriate field in the caller's record. The Drive:\Path\ to the Picture Filename must be defined in the PROFILE.CFG file.

Callers that choose to view another callers profile, will be informed that there is a picture available for Downloading/Viewing. The caller is given the option of downloading it and viewing it offline OR if they are using a terminal program with a GIF viewer TSR, viewing it as they download it.
Trashcan File This is a text file you must create (if you wish to use one), with a filename of PROFTCAN.DAT and it must reside in the Door directory. This file is used if you want to block the use of "offensive" words callers may choose to use. Each word must appear on a separate line within the text file with a maximum of 100 words.

NOTE: The word must match EXACTLY !!!
Usage Log As an option, we provide you with the ability to log every player to a text file. IF you enter Y in the CFG file to log callers, the Door will place the caller's name as well as the ON and OFF times each time a caller selects the Door. A separate file will be created for each Node and the name of the file will be USAGEx, where x is the Node number.

You may delete these files at any time and the Door will recreate them the next time a caller enters the Door. If you do NOT want to continue logging callers, change the CFG file entry to N.
Adopt-A-Door The concept, ADOPT-A-DOOR, allows a caller to register (ADOPT) a door. It would be the same as sending in a donation, only this way it is earmarked for registering a particular door. In a way, the user feels he/she is "getting something in return". As a Door author I have decided to build this concept into each of my Door programs. The concept replaces the usual message "tell the Sysop to register this Door" we find in most
doors.

If the Door is unregistered then a message appears on the opening screen to that effect. After finishing or suspending a game, a message screen is displayed about the ADOPT-A-DOOR concept. The message also tells the caller to contact the Sysop to find out if there is any further details to the ADOPT-A-DOOR concept. Some Sysops give extra D/L time, online time, etc to callers that ADOPT-A-DOOR.

If the Door has been registered, either by the Sysop or other callers, the names of those contributors will be displayed in the closing screen.

NOTE: If you want to display the names of the callers that contributed to registering the Door, you must create an ASCII file called ADOPT.SYS. You create it with an ASCII text editor. Enter the names of the contributors (one on each line, maximum of 5 entries, each a maximum of 30 characters long). This file must be saved, in ASCII format, and placed in the Door directory.
Legalities THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
Distribution You may make this file available for downloading from your BBS or you may upload it to any BBS or WEB site of your choice, provided that you do not make any changes to the contents of the archive (ZIP/EXE file). The archive and its individual contents may not be used by any service that charges any money whatsoever, without the written permission of the author.
Registration Registration and the subsequent insertion of the registration number into your configuration file, allows for the display of your BBS name on the opening and closing screen as well as the reduction of a delay built into the opening screen display along with the ability to change certain values in the configuration file.

Once a door is registered, any changes to registration information (Sysop name or BBS Name) will require the doors to be re-registered at the registration fee in effect at that time.

Be sure to use the proper upper/lower case when filling in your name and BBS name, as they MUST match the way you entered them in the configuration file.
Misc. The latest version this product, along with and other fine DOOR and HOME EDITION products are always available for download from this web site.


Moving Eye Line

Moving Eye Line


Last modified: August 11, 2013        Valid XHTML 1.0 Transitional