                                        
                                                            
                                                
                                                              
                                            



                                       by

                              BulletProof Software

                            Copyright 1995 Eric Huss




Introduction

BulletProof User Setup is a PEX program that allows a user to configure his
or her user settings.  It provides powerful editing features, and easy-to-use
operations.  The SysOp can completely configure the menus to suit his or her
needs.  It also includes "programmable" functions which the SysOp can use
to allow the user to fully configure their logon procedure.  When the user
is updating a text field, such as "City", the editing functions are much
more powerful than those included with ProBoard.  It allows a user to use
the Home, End, Delete, and arrow keys (defined with ANSI).  It also prints
the user's old information while editing, and works in an insert mode.


Installation

Copy all of the PEX files contained in the archive into your PEX directory.
Next, on your main menu, enter a new function of type #60 (Run ProBoard SDK
File) with a hotkey of your choice, and in the data part enter BPUSETUP.
Next, in your SysOp menu, enter a new function of type #60 with a hotkey
of your choice, and in the data part enter BPUSETUP S.  The 'S' option enters
BP User Setup into SysOp mode for configuration.  The installation of the
other three PEX's included in the archive will be discussed later.
Installation is now finished.  The final step is configuring the program.  


SysOp Functions

Logon to your BBS and go to the SysOp menu and select BPUSETUP Configuration.
The following screen should appear:

                      BulletProof User Setup Configuration
                            by  BulletProof Software
                            Copyright 1995 Eric Huss

                            1)  Configure Page 1
                            2)  Configure Page 2
                            3)  Configure Page 3
                            4)  Configure Global Keys
                            Q)  Return to BBS and Save
                            A)  Return to BBS and Do Not Save

Configure Page 1 - Allows you to configure which functions will appear on
                   the first page.  Allows up to 10 functions.
Configure Page 2 - Allows you to configure which functions will appear on
                   the second page.  Allows up to 15 functions.
Configure Page 3 - Allows you to configure which functions will apear on
                   the third page.  Allows up to 15 functions.
Configure Global Keys - Allows you to configure the global option keys.
                   This includes "Next Page", "Previous Page", "Return to
                   BBS", and "Page SysOp".
Return to BBS and Save - Exits configuration and saves all changes.
                   NOTE:  Due to the fact that BPUSetup keeps its
                   configuration information in the BPUSETUP.PEX file, each
                   time you upgrade your old configuration will be lost.
                   Be sure you remember how things were set up before
                   replacing the BPUSETUP.PEX file.
Return to BBS and Do Not Save - Exits and discards any changes.

Page Configuration

On each page you can define which function will be available.  When you select
and entry number (1 through 10 on the first page, 1 through 15 on the second
and third pages), you will be prompted for a key to define this function.
Next, you will be prompted for the function number.  NOTE:  The "Address"
function takes up 3 lines.  Be sure you leave at least 2 entries blank
on the page you use with the address.

The "Change Password" function is unique.  It will first ask the user for the
old password for validation.  If the user types the correct password, then
he or she is given the chance to change the password.  After the user has
changed his or her password, then BPUSETUP updates the "Date Since Last
Password Change" field in the user file.  This is a variable that was defined
by the author of ProBoard, but has not yet implemented with version 2.01.

The "Check Mail At Login" function is also unique.  It will allow the user
to set the "Check Mail At Login" variable in the user file.  This is also
a variable defined by the author of ProBoard, but not yet implemented.
When used in conjunction with the BPUMSG.PEX file, the user can set whether
or not he or she checks for new mail at login.  More about this later.
The "Check Files At Login" function is the same.

Programmable Functions

Functions 27 through 36 are "programmable".  When you select one of these
to configure, BPUSetup will prompt for a description.  This is the text that
will appear on the menu.  Next, you will be prompted whether this is a 
Yes/No function or a Yes/No/Ask function.  This defines how this function
works.  If it is a Yes/No function, then when the user selects this option,
it will toggle it from whatever the previous setting was, and set the user's
flags accordingly.  If it is a Yes/No/Ask function, then whenever the user
selects this option, the user will be given the choice of Yes, No, or Ask.
Next, you input which flags this function controls.  See the example for the
Yes/No/Ask flag settings.

How do you use this?  Well, the possibilities are up to you.  Here is one
possibility for a Yes/No function.  Define an entry as a programmable
function, and then define it as a yes/no function, and select an unused
flag.  Next, on your TOP.PBM menu, you can create an entry and in the flags
section, enter the same flag as you defined earlier.  Now the user can control
whether or not this entry in the TOP.PBM menu runs.  Possibilities are
"Show Who's Called Today At Login", "Show Top Users At Login", "Show Quote
of the Day At Login", etc.

For the Yes/No/Ask function, define an entry as a programmable function,
enter a description, and then for the Yes/No flag use an unused user flag,
and for the Ask flag, use a second unused flag.  Then, in the TOP.PBM menu,
create two new entries.  The first entry will be the normal function, and
in the "flags" part, enter the Yes/No flag you defined earlier.  Next, create
a second function that runs a ProBoard Questionnaire (Function #12).  In
the "flags" part, enter the Ask flag you defined earlier.  In the data 
section, enter the name of a questionnaire file.  Here is a sample file:

CAPITALISE ON
DISPLAY "Would you like to check for CD-ROM requests? [Y/N]"
GETCHOICE YN 1
IF 1 = "Y"
  MENUCMND 7 "*D*ZNOTICE.BAT"
  QUIT
ENDIF
IF 1 = "N"
  QUIT
ENDIF

Now, the user can define whether or not the function runs automatically,
not at all, or ask the user when her or she logs on.  The possibilities are
up to you.

BPUPASS.PEX

The BulletProof User Password Checker will check the "Date Since Last Password
Change" field in the user's file.  From this, it can force the user to change
his or her password if he or she has not changed it in x number of days.
Installation of this program is simple.  In the TOP.PBM menu, create a new
entry with a Ctrl-A hotkey.  Next, use Function #60 (Run ProBoard SDK File),
and in the data section, enter BPUPASS xx.  Replace xx with the number of
days you want the user to change his or her password.  For example:
BPUPASS 30 will force the user to change his or her password every 30 days.
Another option is to place an 'X' at the end of the command line.  This will
allow the user to use his or her old password if they choose to do so.
Example:  BPUPASS 30 X will force the user to change his or her password
every 30 days.  If the user enters his or her old password, then BPUPASS
does nothing.  Without the 'X' option, BPUPASS requires the user to try
again if he or she enters their old password.

BPUMSG.PEX

To install this PEX, create a new entry in the TOP.PBM menu.  Use a Ctrl-A
hotkey, select Function #60, and in the data field enter BPUMSG.
This PEX will check the user's "Check Mail At Login" variable in his or
her user file.  If it is set to "Yes" (value of 1), then it automatically
checks for new mail.  If it is set to "No" (value of 0), then it does nothing.
If it is set to "Ask" (value of 2), then it will ask the user if he or she
would like to check for new mail.  Make sure that if you are going to use
this program, then in ProCfg, under Options/System Options you set Check
Mail at Login to NO.

BPUFILES.PEX

To install this PEX, create a new entry in the TOP.PBM menu.  Use a Ctrl-A
hotkey, select Function #60, and in the data field enter BPUFILES xxx.
Replace xxx with whatever options you use with Function #37 (Show New Files).
This PEX will check the user's "Check Files At Login" variable in his or
her user file.  It then uses the same Yes/No/Ask properties as BPUMSG.

Shareware

This program is NOT free.  You may try it to see if you like it, but I 
ask that you send in the registration if you continue to use it.  
Simply fill out the REGISTER.TXT file included in this archive, and mail
it with $25 to:
Eric Huss
16613 E. 31st Street
Independence, MO  64055

This $25 registration fee will register ALL BulletProof Software PEX files.
You will receive a universal KEY file for ALL BulletProof Software PEX
programs, plus all the latest versions of those programs.

Support

I can be contacted in the following ways:
Internet:  ehuss@FileShop.COM
FidoNet:  Eric Huss   1:280/33
          I can also be found on the FidoNet ProBoard message base.
Snail Mail:
Eric Huss
16613 E. 31st Street
Independence, MO  64055

I will try to answer any messages as soon as possible.

History

Version 1.00 - First release.  01/29/95  Compiled for ProBoard 2.01.
