home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / donatev1.zip / DE.DOC < prev    next >
Text File  |  1993-09-13  |  6KB  |  125 lines
  1.  
  2.       ▐▐▐▐▐▐▐▐   ┌───────────────────────────────────────────────────────┐
  3.       ▐▐ ▐▐ ▐▐   │ Program Name: Donations Encourager                    │
  4.       ▐▐ECCA▐▐   │ Release #   : 1                                       │
  5.                  │ Release Date: August 1993                             │
  6.       ▐▐ ARE▐▐   │ Software    : Maximus, Maximus/2                      │
  7.       ▐▐ ▐▐ ▐▐   │ Author      : Chris Dornfeld                          │
  8.       ▐▐▐▐▐▐▐▐   └───────────────────────────────────────────────────────┘
  9.  
  10. ■ Overview
  11.  
  12.    The Donations Encourager is a program designed to assist SysOps in getting
  13. donations from their users. I know what SysOps go through to keep their BBSs
  14. online, and sometimes users need a little extra encouragement to contribute to
  15. the cause. Hence this program, Donations Encourager. With it, your users will
  16. see a message highlighting their name as a non-donator and then a delay for a
  17. SysOp-specified amount of time, or if they have donated they will receive a
  18. special thank-you message. There is also an option to make a user "exempt" from
  19. seeing either message, for people like the SysOp who don't want to waste their
  20. time waiting for the delay to run out and don't want to see a message of
  21. thanks.
  22.  
  23. ■ Setup
  24.  
  25.    DE is easy to setup. The following files were included:
  26.  
  27.    DE       MEC - The MECCA program displaying the donation message
  28.    DEPAUSE  BBS - Sample 5-second delay linked after DE
  29.    DESETUP  MEC - The DE SysOp control program for customizing & maintaining DE
  30.  
  31.    The *.MEC files above should be compiled using MECCA and then all 3 files
  32.   should be moved to your main BBS directory (usually \MAX). Next, install the
  33.   two main files as shown below:
  34.  
  35. ─ End of WELCOME.MEC ──────────────────────────────────────────────────────────
  36. ...
  37. [link]\Max\DE
  38. ───────────────────────────────────────────────────────────────────────────────
  39.  
  40.   ..and..
  41.  
  42. ─ MENUS.CTL ───────────────────────────────────────────────────────────────────
  43. Menu SysOp
  44.         ...
  45.         Display_File    \Max\DESetup              SysOp "*DE Setup"
  46.         ...
  47. End Menu
  48. ───────────────────────────────────────────────────────────────────────────────
  49.  
  50.    Then compile your WELCOME.MEC with MECCA, and your MENUS.CTL with SILT, and
  51. DE is all set. You can also insert DESETUP as a Function-key macro if you wish.
  52.  
  53. ■ Warranty
  54.  
  55.    None. This software is free, so why should I support it? What you do with
  56.   it is your business; I am never held responsible for any problems "caused"
  57.   by use of this program.
  58.  
  59. ■ DESetup Commands
  60.  
  61.   [1] Set Donations Msg Delay Time - Change pause length after DE
  62.   [2] Thank a Donating User        - Remove Delay/Msg from a User & Thank
  63.   [3] Make a User Exempt           - Remove Delay/Msg from a User w/o Thanks msg
  64.   [4] Test out DE                  - View sample DE screen
  65.   [?] Help                         - Online summary of commands
  66.   [Q] Quit                         - Exit from DE Installation
  67.  
  68. ■ About Option [1]: Set Donations Msg Delay Time
  69.  
  70.    This option allows you to change the length of the pause given to the user
  71.   after displaying the donations screen (i.e., after displaying DE.BBS). Valid
  72.   times are from .5 - 10 seconds. Examples: 0.5, 1.0, 7, 9.5, 10. This creates
  73.   or overwrites the DEPAUSE.BBS file, linked by DE.BBS when finished displaying
  74.   the message. A sample DEPAUSE.BBS, included in this package, is set for the
  75.   default pause time of 5 seconds. Change it if you wish.
  76.  
  77. ■ About Option [2]: Thank a Donating User
  78.  
  79.    When a user of yours finally catches on and decides to send you a contribu-
  80.   tion, they no longer deserve the annoying message and frustrating delay. They
  81.   also deserve a message of thanks commemorating them for their donations. So
  82.   when you receive their money, fire up DESETUP and enter either their name
  83.   WITHOUT SPACES (Examples: JOEUSER instead of Joe User), or their user number
  84.   where the SysOp's number starts at 0. Then when they log on, the message and
  85.   delay are gone and in their place is a special thanks.
  86.  
  87. ■ About Option [3]: Make a User Exempt
  88.  
  89.    Then there are the special occasions where a user isn't required to donate
  90.   (such as for CoSysOps or something) and therefore don't want to see either
  91.   the msg/delay OR the thanks msg. When this is the case, follow the same
  92.   instructions here as with option #2 and when they log on, they will not even
  93.   suspect DE is passing them by. Another method of removing either message from
  94.   the "authorities" is to put a line like [abelow link]DE in your WELCOME.MEC
  95.   and only those Asst-SysOp or below will see the message.
  96.  
  97. ■ About Option [4]: Test out DE
  98.  
  99.    This simply loads the DE.BBS screen for a test-drive of how it will look.
  100.   Note that if the user you are on as is marked as Exempt or Donating, you
  101.   will either see nothing or the thank-you message.
  102.  
  103. ■ About MecWare
  104.  
  105.    MecWare is my software "company". I, Chris Dornfeld, am the only member as
  106.   of now. I produce programs written in Maximus MECCA language for the
  107.   convenience of Maximus SysOps and for the needs of myself. Many of my
  108.   programs, such as this one, were written with release into a major file
  109.   network such as SDS in mind. Many of my previous programs can be found in
  110.   the SDS still. I don't run my own BBS as of yet, but by October when I have
  111.   a new computer my BBS (which is finished now as for software) will go online.
  112.   I may or may not choose to support MecWare on it.
  113.  
  114. ■ Note from the Author
  115.  
  116.    Thanks for taking the time to view this doc. I worked rather hard on the
  117. program included here, and your support is appreciated. If you have any
  118. problems or suggestions, leave me a note in most FidoNet Maximus-related
  119. echoes. And watch for future releases!!
  120.  
  121. * You are free to modify this program to your liking, as long as it is only
  122.   distributed in its true, unmodified form!
  123.  
  124. ■ Donations Encourager is by Chris Dornfeld, 1993
  125.