home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / UPLOAD20.ZIP / UPLOAD.DOC < prev    next >
Text File  |  1993-10-24  |  8KB  |  171 lines
  1. UPLOAD.PPE, written by Steven Hauswirth
  2. ═══════════════════════════════════════
  3.  
  4. UPLOAD.PPE is a replacement for PCBoard's "Enter the Filename to Upload"
  5. prompt and is a CMD.LST replacement for U & UB. The functionality is three
  6. fold. First it will allow you to change your upload processor's configuration
  7. file according to what conference you are in (useful if you allow files of an
  8. older date in one conference over another or allow lower resolution GIF's in
  9. one conference than another). Second it will display conference specific
  10. pre-upload text displays. What this means is that you can have different
  11. displays that are shown right before the user types in the filename that
  12. will be uploaded. Third (and the reason I wrote this PPE) is that it will
  13. NOT ALLOW a set of files with sysop defineable extensions to be uploaded.
  14. This has many uses two of which is: if you allow GIF's in your adult
  15. conference and not the main board you can now regulate what is uploaded
  16. in your main board, or if you have a specific conference setup for a interbbs
  17. game play you can now stop the players from uploading their turn files into
  18. the wrong conference. When the PPE is executed the local screen is cleared
  19. (due to the shell to dos) but the remote user's screen will not clear, so
  20. it looks seemless.
  21.  
  22.  
  23. UPGRADING:
  24. For those of you who are upgrading from version 1.x then you only need to
  25. replace the UPLOAD.PPE (no setup changes for that ppe) and ADD the
  26. UPLOAD2.PPE to the directory. Then follow setup steps #5 & #6.
  27.  
  28.  
  29. Files suggested for operation:
  30. UPLOAD.0  \
  31. UPLOAD.1   } These are the files that are displayed right before uploading
  32. UPLOAD.2  /
  33. UPLOAD.DEF   This is the default file to displayed right before uploading
  34.              if you do not have a conference specific one
  35. UPLOAD.BAT   Used to switch upload processors configuration files
  36. UPLOAD.CFG   This is what you modify for your setup
  37. UPLOAD.PPE   The PPE to run
  38. UPLOAD.PPS   The source code
  39. UPLOAD.DOC   This file <g>.
  40.  
  41. Installation is long but fairly simple:
  42.  
  43.  1) Copy all the UPLOAD.* files to your C:\PCB\PPL directory (or any other
  44.     location of your choosing)
  45.  
  46.  2) Run MKPCBTXT to edit your PCBTEXT file (should be done for each PCBTEXT
  47.     you have).
  48.  
  49.  3) Press the F3 function key and select record #68.
  50.  
  51.  4) You'll see a line that says something similar to:
  52.     Enter the Filename to Upload (Enter)=none
  53.  
  54.     Replace it with a line such as this (reflecting your chosen dir):
  55.     !C:\PCB\PPL\UPLOAD.PPE /PCBTEXT
  56.  
  57.     Note: you MUST have the /PCBTEXT parameter on the command line
  58.           in order for this to work!!!
  59.  
  60.  5) Press the F3 function key and select record #162 of PCBTEXT.
  61.  
  62.  6) You'll see a line that says something similar to:
  63.     Thanks for the upload(s), @FIRST@!
  64.  
  65.     Replace it with a line such as this (reflecting your chosen dir):
  66.     !C:\PCB\PPL\UPLOAD2.PPE 
  67.  
  68.  7)  Exit PCBTEXT and load PCBSetup
  69.  
  70.  8)  Select File Locations
  71.  
  72.  9)  Select Configuration Files
  73.  
  74. 10)  Cursor down to the "Default CMD.LST File" field.
  75.  
  76. 11)  Press F2 to edit.
  77.  
  78. 12)  Make two entries that resemble the following:
  79.  
  80.        Command     Security  PPE/MNU File -or- Keystroke Replacement
  81.    ══════════════  ════════  ═══════════════════════════════════════
  82.    U                   0     C:\PCB\PPL\UPLOAD.PPE
  83.    UPLOAD              0     C:\PCB\PPL\UPLOAD.PPE
  84.    UB                  0     C:\PCB\PPL\UPLOAD.PPE
  85.  
  86.    Note: you there is NO  /PCBTEXT parameter on these command lines.
  87.  
  88. 13) Make the configuration file reflect your needs (Explained below).
  89.  
  90.     The reason for installing it in both the PCBTEXT and the CMD.LST
  91.     is that while in most cases the CMD.LST is all that is needed it
  92.     will not work if the user types "U;filename.ext". By installing
  93.     it also in PCBTEXT then the file will still be checked. If you
  94.     were to just install it in the CMD.LST only then it would also work
  95.     for the first file of a batch only. Thus the need for the dual 
  96.     installation. If anyone knows of a better way then I am more than 
  97.     willing to change this.
  98.  
  99.  
  100. Explaination of Configuration file:
  101. ══════════════════════════════════════════════════════════════════════════
  102. 2                :Number of conference specific configuration files that
  103.                   are to be used (excluding the default).
  104.                   If you do NOT wish to use this function then put
  105.                   "NONE" (without the quotes of course) on this line, and
  106.                   skip to the first conference that has 'not allowable
  107.                   extensions', thus the next four(+) lines would not exist
  108.                   in your config file.                   
  109.  
  110. c:\ulp\ulp.cfg   :The name that the new upload processor configuration file(s)
  111.                   should be named to (WITH path).
  112.  
  113. c:\ulp\ulp.use   :The name of your defaulting configuration file if you
  114.                   do not have a specific one for the conference that the
  115.                   user is in (use any name you want).
  116.  
  117. c:\ulp\ulp.0     :The name of the specific configuration file for the first 
  118.                   conference that has 'not allowable extensions'.
  119.  
  120. c:\ulp\ulp.1     :The name of the specific configuration file for the second
  121.                   conference that has 'not allowable extensions'.
  122.  
  123.                  {These would continue on until you reach the number of 
  124.                   conferences that will have specific upload processor 
  125.                   configuration files. The names can be set to anything as 
  126.                   long as the extension IS THE CONFERENCE NUMBER. And they 
  127.                   do not have to be in numerical order.}
  128.  
  129. 0                :Number of the first conference that has 'not allowable
  130.                   extensions'. If you do NOT want to use this function
  131.                   then put "NONE" on this line.
  132.  
  133. 2                :Number of extensions that will not be allowed in this
  134.                   conference
  135.  
  136. GIF              :First extension not allowed in this conference 
  137.  
  138. JPG              :Second extension not allowed in this conference
  139.  
  140.                  {Continue listing extensions one per line until you list 
  141.                   all the extensions not allowed on this conference}
  142.  
  143. 1                :Number of the second conference that has 'not allowable
  144.                   extensions' (does not have to be in numerical order).
  145.  
  146. 2                :Number of extensions that are not allowed in this
  147.                   conference
  148.  
  149. EXE              :First extension not allowed in this conference
  150.  
  151. COM              :Second extension not allowed in this conference
  152.  
  153.                  {Continue listing extensions one per line until you list 
  154.                   all the extensions not allowed on this conference}
  155.  
  156. {Continue on with this pattern for all the conferences that you want to have
  157.  'not allowable extensions'.}
  158.  
  159. There is a sample configuration file to help explain all this. A secondary 
  160. purpose of switching your upload processor's configuration files is that if 
  161. the user tells PCB that he/she is only uploading one file but actually does a
  162. batch upload...the upload processor can catch these undesirable extensions if
  163. you wish.
  164.  
  165. The source code for these PPEs is located within this archive as UPLOAD.PPS
  166. and UPLOAD2.PPS. Modify it as you need to for your system, but please do not 
  167. redistribute the modified source code.
  168.  
  169. If anyone has any suggestions as to new features then either leave me mail
  170. on Salt Air, U'NI net, or call my board at (312) 594-0643. 
  171.