home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / yinfo130.zip / YOURINFO.DOC < prev    next >
Text File  |  1992-07-20  |  9KB  |  189 lines
  1. YourInfo v1.30 : By Keith Reid (aka Titus Crow =8)
  2. ==================================================
  3.  - A piece of QUALITY software Written FROM SCRATCH.
  4.  
  5. What does this thing do?
  6. ========================
  7. Well, seeing as how configurable Telegard is as far as commands and the 
  8. general look of the system goes.  I started to notice that there was one 
  9. command that would display a rather boring record of your user record.  
  10. Now, I've seen some really nice displays on boards that would make your 
  11. eyes bug out.  Boards like Maximus and Remote Access have MCI-like codes 
  12. for everything from Username to # of uploads and a lot in between.  So why 
  13. doesn't TG?
  14.  
  15. Good question!  Well, here you are!  This program will take any ansi file 
  16. you create and plug in the needed words and stats where you tell it to, 
  17. and then you just let TG display the output.  Voila!  Beautiful!
  18.  
  19. What's new with this version?  v1.30
  20. ====================================
  21. This version uses faster search routines to find the user data.  You'll find 
  22. that it runs about twice as fast as v1.25.
  23.  
  24. I've hardcoded the directory that the output file is placed in.  It will now 
  25. be written to your AFILES directory.
  26.  
  27.  
  28. What do I do to make it work?
  29. =============================
  30. YourInfo must be run from your main bbs directory or where your STATUS.DAT 
  31. file is located.  So if you're using the default settings for directories 
  32. that Telegard gives you, you would run it from your \BBS dir.
  33.  
  34. All YOURINFO does is take in an ansi file that you make, and fill in the 
  35. blanks with a users information, and then write that information to disk.  
  36. What YOU have to do is get TG to run YOURINFO and then display the output 
  37. file.  For those of you that are lazy (you know who you are!), I've included 
  38. a simple YOURINFO.MNU file that will do just that.  Plop this MNU file in 
  39. your menus directory, and then set up your menus so that they go to the 
  40. YOURINFO menu when the users push "Y".  
  41.  
  42. So for example, from your main menu you want to have the yourinfo display 
  43. shown when the user pushes "Y".  So you change the "Y" menu command to 
  44. look like this :
  45.  
  46. 1. Long descript :(Y)our User information
  47. 2. Short descript:(Y)ourInfo
  48. 3. Cmd letters   :Y
  49. 4. ACS required  :""
  50. 5. Cmdkeys       :-/
  51. 6. MString       :YINFO.BAT @R
  52.    Flags         :None
  53. Q. Quit
  54.  
  55. ...and that'll do it.  You just do that from whichever menus you want, and 
  56. there you have it.  All done!
  57.  
  58. Where your YINFO.BAT file would be something like : ------------
  59.  
  60.              YOURINFO %1 USERINFO.ANS USER.ANS AP
  61.  
  62. Don't forget to have TG display the USER.ANS file after this menu command is 
  63. completed.
  64.  
  65. The format of the commandline for YOURINFO is as follows : 
  66.  
  67.  YOURINFO <UserNumber> <Filename of Input ansi file> <output filename> [a,p]
  68.         
  69. The input ansi file can be anywhere as long as you give a full path for it, 
  70. otherwise you must also put it in your main bbs directory.
  71.  
  72. The output filename will be placed in your AFILES directory.
  73.  
  74. The last parameter is optional.  In it, you have either or both of the 
  75. switches.  The `A' switch will make the output ansi "unabortable" when 
  76. being displayed through TG.  The 'P' switch will insert a Telegard (PAUSE) 
  77. at the end of the display.
  78.  
  79. Example:
  80.           YOURINFO 20 C:\TheDraw\USERINFO.ANS YOURINFO.ANS AP
  81.           
  82. Will make an ansi file for user #20, using the file C:\TheDraw\USERINFO.ANS 
  83. as an input file, and writing C:\BBS\AFILES\YOURINFO.ANS as the output file 
  84. to be displayed.  The output file will be unabortable and will have a pause 
  85. inserted at the end.
  86.  
  87.  
  88. How do I make my input ansi?
  89. ============================
  90. In order for the output ansi to be easily readable (in other words, in 
  91. order for this thing to work nicely) the INPUT ansi must be specifically 
  92. formatted. (I'll assume that you're using THEDRAW to create your ansi's.)
  93.  
  94. 1.  Make yourself a normal ansi file (no animation yet please!) without 
  95. any of the YOURINFO control codes in it.  Make sure you have enough space 
  96. for each of the result strings like names and such, on each area.  SAVE 
  97. THIS FILE SOMEPLACE SAFE!  You don't want to go messing it up.
  98.  
  99. 2.  With the ansi screen you made in step #1, press ALT-J : this puts you 
  100. into ANIMATION mode.  Choose any mode you like!  The simplest and fastest 
  101. will be to use the Top->Bottom (thats T on the menu).  
  102.  
  103. 3.  When it's done fiddling with your ansi screen.  Go to the position 
  104. where you will have your first entry where you want to have a bit of user 
  105. info entered, and then type ALT-J, and then M.  This turns on the STORED- 
  106. CURSOR-MOVEMENTS.  From now on EVERY movement you make with the arrow keys 
  107. will be stored in your ansi.  It is a good idea to turn it off again after 
  108. you've typed in each bit of info.  This will keep the ansi neat and make it 
  109. display quicker as well.
  110.  
  111. 4.  Enter your control codes at each position where you would have the text 
  112. displayed, using the arrow keys to move from one place to another.  You may 
  113. use any color you like, as long as the color you use for the @ part of the 
  114. control code is the same as the second part of the control code.  You may 
  115. also have other characters entered AFTER the text entered.
  116.  
  117. For example : if you were displaying the # of uploads, you may want to have 
  118. the word `Uploaded' appear after the number of uploads.  So you would put 
  119. "@8 Uploaded" at the position you would have it displayed.  The `Uploaded' 
  120. part can be of a different color than the displayed (control code) color if 
  121. you like.
  122.  
  123. 5.  TG will continue on from the last position where you left your cursor, 
  124. so when you're done inserting all your codes.  Move your cursor to the 
  125. very last line of your ansi, and save your final ansi there.  Otherwise 
  126. after your ansi is displayed, TG will start by overwriting your ansi.
  127.  
  128.  
  129. What kind of user info can I display in the ANSI?
  130. =================================================
  131. Valid control codes are preceded by a @ symbol.  Control codes can be
  132. any of the following...
  133.  
  134.                        $   Users Password
  135.                        1   Users display line length
  136.                        2   Users display page length
  137.                        3   User's Sex, M or F
  138.                        4   last message base #
  139.                        5   # Public Message Posts
  140.                        6   # Private Message Posts
  141.                        7   # NetMail Posts
  142.                        8   # Uploads
  143.                        9   # Downloads
  144.                        >   #k Uploaded
  145.                        <   #k Downloaded
  146.                        (   Up/Down k ratio
  147.                        )   Up/Down #files ratio
  148.                        0   # Filepoints
  149.                        A   Street Address
  150.                        B   Birthday
  151.                        C   City and State/Prov
  152.                        D   DSL level
  153.                        E   Total Time Online
  154.                        F   First logged on Date
  155.                        G   # times logged on
  156.                        H   Time left [mins] today
  157.                        I   # of Illegal Logon attempts since last call
  158.                        J   Amount of time in Timebank
  159.                        K   Sysop Note (if you actually want to show them this!)
  160.                        L   Last logged on Date
  161.                        N   User's Pseudo
  162.                        O   User's Job
  163.                        P   User's Voice #
  164.                        Q   User's PCR
  165.                        R   User's Real Name
  166.                        S   SL Level
  167.                        T   User's Computer Type (I use this for a USER NOTE)
  168.                        U   User's average time/call
  169.                        W   Where user got bbs # from
  170.                        Z   User's ZipCode
  171.  
  172.  
  173. How do I register this AWESOME program?
  174. =======================================
  175. Don't bother.  The file is free, use it as you will.  If you find that you 
  176. like it, drop me a line in the Fidonet Pascal Echo, or through the official 
  177. Telegard Sysops network and tell me so!  If you like it enough, send me 
  178. some CASHOLA to pay for my tuition!  Thanks...
  179.  
  180.                     Keith Reid
  181.                     7731-#4 Moffatt Rd.
  182.                     Richmond, BC
  183.                     V6Y-1X9
  184. -------------------------------------------------------------------------------
  185. Programmed in Turbo Pascal v6.0 by Titus Crow
  186.  
  187. Yet another piece of COMPLETELY ORIGINAL PROGRAMMING!  Take the HINT!
  188. ------------------------------------------------------------------------Tc-----
  189.