













                           APPLY PEX for ProBoard 2.12
                              (C) 1996 LP Software

                                  - FREEWARE -











































                                        - 1 -




     -----------------------------------------------------------------------
         Description
     -----------------------------------------------------------------------

     APPLY.pex is a Proboard EXecutable for ProBoard 2.12.
     It is a totally configurable full-screen application form.


















































                                        - 2 -




     -----------------------------------------------------------------------
         Why?
     -----------------------------------------------------------------------

     There are one or two other user configuration editor pex's around...
     but all of them that i have seen are very non-configurable and dont do
     what I want! So i aimed to create a user config editor that lets you
     use your OWN ansi, only prompt for items that YOU want people to edit,
     allow you to force people to answer only the questions that YOU think
     should be answered. Also, i wanted to make one that was relatively bug-
     free (unlike one of them that continually cut my userbase in half until
     i removed it! Now thats bad) Finally, i wanted to make it freeware so
     that anyone can use it, and everyone will use it <grin>.











































                                        - 3 -




     -----------------------------------------------------------------------
         Licence
     -----------------------------------------------------------------------

     All LP Soft pex's will be FREE for non-commercial use!  That is, you
     dont have to send ANY money!  I encourage ALL pex programmers to create
     FREEWARE pex's. Look at it this way, if you put a new PEX on your
     board, how many of them do u actually register?  I believe that it is
     more important to spread useful utilities rather than restrict their
     use by adding NAG screens to make it practically useless without
     registering!

     So... Spread this PEX far and wide! And use it for FREE on your BBS!
     Any other commercial use of this software (such as distributing this
     package as part of another program) must get my permission FIRST. If in
     doubt, ASK me!

     By the way, the following are probably trademarks, registered
     trademarks or just someone that you shouldnt try to rip off:
     IBM, ProBoard.




































                                        - 4 -




     -----------------------------------------------------------------------
         Installation
     -----------------------------------------------------------------------
     Quick install:
         *   Copy APPLY.PEX to the PEX directory
         *   Copy APPLY.ANS to the \PB\TXTFILES directory
         *   Copy APPLY.CFG to each node's directory (ie the dir that you
             run proboard from). For single nodes, it would be \PB. For
             multi-node
             bbs's it would be \PB\NODEx
         *   Edit the CFG file to suit your bbs/ansi!!!
         *   Add a menu item of type 60 (ProBoard SDK) with option line:
             APPLY.PEX APPLY.CFG
         *   Try it!










































                                        - 5 -




     -----------------------------------------------------------------------
         Configuration
     -----------------------------------------------------------------------

     Being very configurable is one of the greatest features of this
     program! So you should fiddle around with the CFG file and make it look
     how YOU want it to look.... You might even be able to pick up a few
     sample CFG files from other boards....

     The CFG file MUST be placed in the directory from which you run
     ProBoard (you can find this out by pressing ALT-J while a user is
     online and see what directory you are in!). By default, it is called
     "APPLY.CFG". However if you wish to have several CFG files for example,
     or one CFG file for ALL nodes, you can pass the filename off the CFG
     file as an optional parameter to the PEX on the options line (eg "APPLY
     CFGMENU.CFG" or "APPLY C:\PB\APPLY.CFG")

     The cfg fle is a plain text file (you can use any text editor to create
     it) with lines in the following format (explained later):

             FieldName ( x, y, length, type, prompt, default)

     Lines beginning with a semicolon and blank lines are treated as
     comments. The case (upper/lower) is not significant, and spaces are
     generally ignored except in text that will appear on the screen. if you
     wish to include a ")" in a text string in the last parameter, or a ","
     in any other text parameter then you must precede it with a "\" (eg:
     "TEST (1,1,Press enter (Y\))" has parameters 1, 1 and "Press enter (Y)"

     There is one extra line in the file that has special meaning. It starts
     with the word CONFIG and contains general configuration information in
     the following format:

             Config ( on, off, male, female, nosex, applyansi, infocheck,
                      statusx, statusy, statuslen, statuscol, blank,
                      foreground, blankcol, hilite, finished, notfinished)

     where:
                  on = the word "on"
                 off = the word "off"
                male = the word "male"
              female = the word "female"
               nosex = the word "unknown" shown when the users sex is
                       unknown
           applyansi = the filename of the ANSi file in the TEXTFILES
                       directory (without extension)
           infocheck = if this is set to "Y" then if the user hasnt entered
                       details for ALL of the compulsory fields (ie those
                       of type FORCED) then the user editor will be
                       invoked. Otherwise it will exit immediately.
             statusx = the x position of the status line
             statusy = the y position of the status line
           statuslen = the length of the status line
           statuscol = the colour of the status line
               blank = the character to be used to pad out the fields
          foreground = the colour of the field data
                                        - 6 -




            blankcol = the colour of the blanks
              hilite = the background colour of the hilighted item
            finished = the text shown to prompt the user when they have
                       finished entering compulsory data and have pressed
                       ESC
         notfinished = the text shown when the user has not filled in all of
                       the compulsory fields and has tried to exit

     example:
             Config(ON,OFF,Male,Female,Unknown,APPLY,Y,2,22,76,9,.,15,8,3,
                    Have you finished? [Y/n],
                    You must enter a value for the hilighted item!)
     (Note: you should place all parameters on one line for it to work)

     The other lines in the CFG file must start with one of the following
     FieldNames:

             Alias, BirthDate, VoicePhone, DataPhone, City, Language,
             DefaultProt, DateFmt, Sex, ScrHeight, Country, State,
             FaxPhone, Ansi, Avatar, RIP, IBM, ClrScr, HotKeys, More, FsEd,
             Comment, Company, Address1, Address2, Address3

     These names correspond to options in PROCFG's user editor. Company is
     an exception to this - it is not found in PROCFG however it is a valid
     part of the userbase and other third party utils might use it.

     You can put these field names just ONCE in the CFG file. The order that
     you put them in the CFG file is important! When a user pressed DOWN,
     the hilight goes to the next field in the CFG file (and wraps around to
     the top at the end). Similarly by pressing up, the user moves the
     hilight to the previous field in the CFG file. Note that you dont have
     to include all of the fields! If you only want the user to edit 5
     fields then delete all of the others that you dont want!

     As mentioned before, the line is in the format:
             FieldName ( x, y, length, type, prompt, default)

     where:
           x = the x co-ordinate of the field on the screen
           y = the y co-ordinate of the field on the screen
      length = the length of the "bar" that is drawn when the field is
               hilighted
        type = one of the following:
               OPTION : The user doesnt *have to* fill the field in
               FORCE  : The user can't exit until this field has been filled
               SET    : The field is set to the default value. User cant
               edit it.
      prompt = the prompt at the bottom of the screen when the item is
               selected
     default = the default value of the item.
               The following accept strings as default:
                    Alias, VoicePhone, DataPhone, City, Comment, Company,
                    Address1, Address2, Address3
               The following accept either Y or N as default:
                    ScrHeight, Country, State, FaxPhone, Ansi, Avatar, RIP,
                    IBM, ClrScr, HotKeys, More, FsEd
                                        - 7 -




               BirthDate cant have a default!
               Sex can have M or F or U
               Language can have the name of the language file (without
               extension)
               DefaultProt can have the hotkey for the default protocol
               DateFmt can be either "MM/DD/YY", "DD/MM/YY" or "YY/MM/DD"


















































                                        - 8 -




     -----------------------------------------------------------------------
         Sample CFG file:
     -----------------------------------------------------------------------

     APPLY.CFG:

     ; ---------------------------------------------------------------------
     Config     (ON,OFF,Male,Female,Unknown,APPLY,Y,2,22,76,9,.,15,8,3,Have
     you finished? [Y/n],You must enter a value for the hilighted item!
     (Press ENTER to continue\))
     ; Note: the above 3 lines should be printed on ONE line
     ; ---------------------------------------------------------------------
     Alias      (17, 2,25,FORCE ,Enter an alias to be known as on this BBS,)
     BirthDate  (17, 3,25,FORCE ,Enter your REAL date of birth,)
     VoicePhone (17, 4,25,FORCE ,Enter your VOICE phone number,)
     DataPhone  (17, 5,25,OPTION,Enter the number you are calling from,)
     City       (17, 6,25,FORCE ,Enter your Location [Suburb\, State],)
     ; ---------------------------------------------------------------------
     Language   (61, 2,15,OPTION,Press space to toggle between languages,)
     DefaultProt(61, 3,15,OPTION,Select a file trasfer protocol to be used,)
     DateFmt    (61, 4,15,OPTION,Select your prefered date format,)
     Sex        (61, 5,15,OPTION,Enter your sex,)
     ScrHeight  (61, 6,15,OPTION,Enter your screen height (normally 24),)
     ; ---------------------------------------------------------------------
     Country    (17, 8,25,OPTION,Enter your BBS name (if u r a sysop),)
     State      (17, 9,25,OPTION,Enter your BBS Software name,)
     FaxPhone   (61, 8,15,OPTION,Enter your BBS Phone number,)
     ; ---------------------------------------------------------------------
     Ansi       (13,11, 3,OPTION,ANSi graphics is ON by default,y)
     Avatar     (13,12, 3,OPTION,Avatar graphics is OFF by default,)
     RIP        (32,11, 3,OPTION,RIP graphics is ON when detected,)
     IBM        (32,12, 3,OPTION,IBM characters are ON by default,)
     ClrScr     (51,11, 3,OPTION,Clear Screen codes are ON by default,y)
     HotKeys    (51,12, 3,OPTION,Hotkeys are ON by default,)
     More       (73,11, 3,OPTION,"More?" prompt is ON by default,)
     FsEd       (73,12, 3,OPTION,Full screen editor is enabled by default,)
     ; ---------------------------------------------------------------------
     Comment    ( 5,15,71,OPTION,Where did you hear about this bbs?,)
     Company    (26,16,50,OPTION,Name a user who can verify you,)
     ; ---------------------------------------------------------------------
     Address1   (26,18,50,OPTION,Enter any groups that you belong to,)
     Address2   (26,19,50,OPTION,What filez that you have leeched lately?,)
     Address3   (26,20,50,OPTION,What other boards do you call often?,)
     ; ---------------------------------------------------------------------












                                        - 9 -




     -----------------------------------------------------------------------
         How to use the PEX
     -----------------------------------------------------------------------

     Using the PEX is designed to be intuitive! So it should do what u
     expect it to do! If it doesnt, write to me and tell me what it should
     do! Basically, you use thee UP and DOWN arrow keys to move between the
     fields. Simply pressing ENTER or TAB will take you to the next field.
     The field that you are currently editing is hilited. To change fields
     that are simply ON or OFF, use the space bar or any other key to toggle
     it. When you are finished editing all of the fields, press ESC to exit.
     If you have finished all of the compulsory questions, you will be
     prompted to press Y (or enter) to exit. Normally, the local keyboard
     uses UP and DOWN arrow keys to adjust the users time. In the APPLY pex,
     you use UP and DOWN to move between fields! So, if you want to adjust
     the users time, use the HOME and END keys to increase or decrease the
     users time!







































                                       - 10 -




     -----------------------------------------------------------------------
         Contacting the author!
     -----------------------------------------------------------------------

     I would appreciate ANY mail regarding this software! So mail me NOW!
     My addresses:

              FidoNet : 3:711/951
               PB-Net : 246:8501/2005
             Internet : dyoung@extro.ucc.su.oz.au
                      : 9422970@ugrad.ug.cs.su.oz.au
                      : darryl_young@F961.N711.Z3.fidonet.com
            SnailMail : PO Box 24 Cherrybrook NSW Australia 2126
                  BBS : Beyond Reality (+61-2) 484-4804 (Open 24hours)










































                                       - 11 -




     -----------------------------------------------------------------------
         Credits, Greetz
     -----------------------------------------------------------------------

     Greetz to:
             EFC (for a few maad FREEWARE pex's - keep em coming!)
             [NiCK] (for the great advice/testing of ANY prog! Thanx!)
             Fesz/Darq (Seth - for the ideas!)
             ... and all the guys on my board who tested/suggested! Thanx!















































                                       - 12 -
