Small docfile for the FileCreditor. * last update of this docfile 3-08-1995 * The main purpose of this door is to have an easy way to credit uploads and to let the user know his uploads have been validated. ************* NEW OPTIONS **************** - Now uses an external configuration which can be edited both from within the door and with the GUI Config Editor (included). - Credit Bytes AND Files (or not, whatever you want..) - Set a default factor for Bytes and Files (If you want to have a double credit week and don't want to edit every upload...) - Move Files - Auto Move Files (if you receive your uploads in a private dir and want to move them to an upload dir after validation) - You can edit the uploader from the main menu (online editor!!) - Keeps a record of all the users uploads (In the uploaders own directory). Now you can check what files someone has upped without browsing through an entire filebase. ****************************************** Some other features : - Fast in and out for quickly validating files. - Comment on uploaded files. (optional) (Both pre-defined and written comments) - Add (Remove) x times the filelength or add (Remove) a generic amount of bytes. - Give a penalty or a bonus for a file. - Works with online users too, extra bytes are added immediately. - Keeps a creditrecord for every user. This record shows the number of (different) penalties the user has and his last up- and download attempt. - Add comments to filedescriptions. (optional) (Pre-defined and written.) - Edit bad uploaders. (Even if the user is online) - Kill files. - And some other things... Archive contents. Doors:RobTools/Creditor/Creditor (The Main program) Doors:RobTools/Creditor/Process (Displays info to user) Doors:RobTools/Creditor/GoodComments (List of comments for good uploads) Doors:RobTools/Creditor/BadComments (List of comments for bad uploads) Doors:RobTools/Creditor/FileComments (List of filecomments) Doors:RobTools/Creditor/Creditor.doc (This file) CRConfig (A GUI config editor, place somewhere in your path) Installation. Put the creditor in your BrowseFile.src, it should replace the Validate File command, RetVal(6). Example : ;=============================================================== ; Browsefile.src CMD = "=" 250-255 { PRINT "Starting up the great creditbasher, please wait...." XenolinkDoor "doors:RobTools/Creditor/creditor ~20 ~576" } ;=============================================================== This door does not (yet) write a normal message to the user about his uploads. Instead the user receives a special message at login. If no files were processed the door gives the message : Checking uploads... There are no processed uploads in your name. If there are processed uploads the message could look like this : You earned 1x 686160 uploadcredits for the file ROKTZ225.LHA You earned 1x 1000000 uploadcredits for the file AMOSAIC13.LHA The Sysop says : Thank you, I was waiting for that... These messages are displayed by a special utilitiy. The best place for this utility is in your login menu. If you don't have a login menu you might want to make a "CHECK UPLOADS" command in your file menu. This process door is called like this : XenolinkDoor "Doors:RobTools/Creditor/Process ~20 Sysop_Name" Example login menu. ;============================================================ ; Loginmenu.src CMD = "" 2-255 { PRINT "" ChangeMsgSection(2) Readnew XenolinkDoor "DOORS:RobTools/Creditor/Process ~20 Sysop" XenolinkDoor "Doors:thewall/thewall" GotoMenu "Main.menu" } ;============================================================ ; Replace spaces in the Sysop's name with underscores. Maximum length for the name is 30 karakters. (The comment has to fit on the same line.) In order for the door to keep track of a user's last up- and downloadattempts a utility must be placed before every up- and download command in your bbs. Example : ;============================== ; Filemenu.src CMD = "D" { XenolinkDoor "^3^15000^Doors:RobTools/SaveUpDownload ~20 ~40 ~46 ~50 DOWN" Download } CMD = "U" { XenolinkDoor "^3^15000^Doors:RobTools/SaveUpDownload ~20 ~40 ~46 ~50 UP" Upload } ;============================== Use the ^3^15000^ only if you have multiple nodes. (raise the three for more than 3 nodes...) Operation : Pretty straight forward, just try it out. Notes : The options 1 and 2 in the main menu of the door (AddBytes and RemoveBytes) will compensate for the Bytes Xenolink gives. So giving 1x credits will actually add nothing to the user's record since Xenolink has already given 1x credits for the file. Option 3 will NOT compensate. Use this option to give or take something extra from the users bytes. If you disable File Crediting the user will get NO filecredits for his uploads. This means the door will remove the filecredits given by Xenolink. If you Disable Byte Crediting the user will get NO bytecredits for his uploads. This means the door will remove the bytecredits given by Xenolink. The MoveFile option (if checked) only works with the fast-validate command. If you credit files via options 1,2 or 3 the file will not be moved. A bonus or a Penalty will not change the number of uploads a user has. ** CHANGED ** When you give a negative amount of bytes for a file the door will NO LONGER add a bytepenalty to the users record. Editing the following userdata (with the creditors internal usereditor only!) will change the creditrecord : Privilege ByteRatio FileRatio Uploads UpLoadBytes MaxBytesPerDay ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: Thanks to : Lennart Schram and Robert Dekker for testing.... Send mail to : Rob Veenman internet robvtnz@xs4all.nl fidonet 2:280/208.3 BBS +31-29974260 To Do : ? I don't know... please send suggestions. I would like to know how YOU want to credit users. With this door you have many more options but maybe one is still missing. Please tell me your wishes and I will see what I can do... Also check out "THE ARCDOOR" : extract, dowload, delete, strip and view files from within archives. Have Fun....