home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 005 / cw_hh_36.zip / HOWHEARD.DOC < prev    next >
Text File  |  1994-09-30  |  5KB  |  78 lines
  1.      ┌────────────────────────────────────────────────────────────────────┐
  2.      │ HowHeard     PCBoard 15.2 PPE     New Caller Upgrader  <Shareware> │
  3.      └────────────────────────────────────────────────────────────────────┘
  4.  
  5.      This PCBoard 15.2 PPE, when placed in your newuser logon script,  lets
  6.      you assign up to 5 options to "How did you hear of us" or "Why are you
  7.      calling" type questions.  Based on their response you can upgrade to a
  8.      specific security level, add a note to Comment Line 2, add xxx days to
  9.      exp date (or a non-expiring date)  or you can even register them  in a
  10.      private conference. Response can be configured individually so that no
  11.      one response gets the same upgrade options!
  12.  
  13.      Installation of HowHeard is fairly straight-forward.  Here is how I do
  14.      it. My new caller logon script looks like this, just 2 lines:
  15.           !E:\PPE\HOWHEARD\HOWHEARD.PPE
  16.           !E:\PPE\WELCOMAT\WELCOMAT.PPE
  17.      The first line is for HowHeard,  the other is for another PPE I wrote.
  18.      There are a number of ways you can do this... you can put HOWHEARD.PPE
  19.      in your scripts, but there's no guarantee the user will answer them...
  20.  
  21.      You need to create a menu file  for the user to choose a "how I heard"
  22.      option, you can use PCBoard's @Xxx color macros but you need to number
  23.      the options in sequence with how listed in the config file.   HowHeard
  24.      can also support RIP screens if you so desire.
  25.  
  26.      HowHeard Config File.
  27.  
  28.      The config file, and all HowHeard files, must be in the same directory
  29.      as the HOWHEARD.PPE file. The config file MUST be called HOWHEARD.CNF.
  30.      Here's a sample HOWHEARD.CNF file, an expanation of this file with it.
  31.      ┌─────────────────────────┐
  32.      │ Your BBS Name           │ Who HowHeard is registered to
  33.      │ 00000                   │ 00000 if unregistered - or your reg number
  34.      │ Validation Code         │ Validation Code (unregistered leave blank)
  35.      │ E:\PPE\HH\MNU           │ Path/Filename of the OPTIONS display file.
  36.      │ E:\PPE\HH\MNUO          │ Path/Filename of OTHER display (or blank).
  37.      │ 4                       │ Number of the User Note field to write to.
  38.      │ 2                       │ How many options  provided in config file.
  39.   *  │ Looking To Join Intelec │ 60 Chars for the User Note in User Record.
  40.      │ 40                      │ New Security Level if this choice is made.
  41.      │ 0                       │ Days to Add to Expiration Date (0=non-exp)
  42.      │ 1                       │ Which conference to register this user in.
  43.   *  │ Calling About The PPE's │     Lines 12-15 are same descriptions
  44.      │ 30                      │     as lines 8-11 but for option two.
  45.      │ 182                     │     The "registered version" supports
  46.      │ 106                     │     up to 5 different upgrade levels!
  47.      └─────────────────────────┘
  48.  
  49.   *  See section below marked [OTHER]
  50.  
  51.      All but the first 5 lines are optional, but if not used there's little
  52.      point in even using this utility. If there's a field in the configfile
  53.      that you do not wish to use (such as registration in a conference) you
  54.      must leave the line empty (blank).  The Comment 2 field  is limited to
  55.      30 characters.  If the New Security Level field is left blank then the
  56.      security level as defined in PCBoard will be kept.  If it is not used,
  57.      as with any field in the config file,  you must leave an empty (blank)
  58.      line in it's place. The Days To Add to Exp Date are the number of days
  59.      to add to the date the script is answered (refered to as today's date)
  60.      and if left blank then the  number of days to exp  in PCBoard is kept.
  61.      If you want to assign a non-expiring exp date to a response,  then put
  62.      a 0 in this entry for this response.
  63.  
  64.      [OTHER]
  65.      If you place the word "Other" on one of the 5 option text lines,  this
  66.      will permit you to get a "more specific response" from the user as far
  67.      as how they heard of your system.  When you use the word "Other" for a
  68.      menu item number (in menu and in HOWHEARD.CNF file) when the menu item
  69.      is selected  it will display the "OTHER Display" that you also defined
  70.      in the HOWHEARD.CNF file. It will also write the users response to the
  71.      User Note field.
  72.  
  73.      Lastly, HowHeard supports an external "prompt file" called PROMPTS.HH.
  74.      If you want to operate HowHeard to support "RIP" graphics  then create
  75.      a file called PROMPTS.HHR to contain the RIP version of the prompts in
  76.      the PROMPTS.HH file.  There, I hope I haven't confused anyone too bad.
  77.  
  78.