Readme for Golden Sysop

Installation:

1) Unpack GSYSOP.ZIP into a new directory

2) edit file FORUMS.CFG:

example:
NUMBER=1
OS2UGER=Deutsches OS/2 User Forum
PEARLS=Pearl Support Forum

First line: NUMBER=[Number of forums you're sysop for]
further lines: [GOWORD for forum]=[Forum LongName]

please note: NUMBER= must appear in first line of FORUMS.CFG. Each forum must appear in a separate line.

3) Create CFG files for your forum(s):

SAMPLE.CFG is a sample file (in this case, SAMPLE is the GO Word for a Forum). If you're sysop at GCPSUPPORT you have to create a GCPSUP.CFG file (for example).

To create such a CFG file, please copy SAMPLE.CFG and rename it. Edit the new files with E or EPM and edit the first line of the file.

This line is set to:

PrePath=e:\gcp299m\

Please replace e:\gcp299m\ with the complete path of your Golden CommPass installation (ending with \ )

4) Start the program with doubleclick onto GSYSOP.EXE

5) If you have created more than one individual CFG (this means, if you're working for more than one forum) a dialogue appears, which allows you to select one forum you actual want to work with. 

6) Select PreviewFiles/Select Libraries to define the libraries you want to scan (maybe you get all Previewed libraries of your Forum, but you're only interested in a few or one section).


July, 30th 1997: Only E-Mail to uploader works well, all other features not implemented yet.

News on December, 31th 1997:

Now the following features work well:

- E-Mail to Uploader
- Private and sysop-public message to uploader
- New Message (to announce new uploads)
- Disposition features: Download, Release, Merge, Cancel, Move
- Building TopTen's: Top 10, Top 100, Top 20, .... as comma-separated ascii files (alltime.res)




FAQ


How to use the configurable Mail/Message files?

You have the following "template" files for your automatic messages and mails:

MAIL_OK.TXT		to use for e-mails generated by selecting "Upload OK"
MAIL_VIR.TXT		to use for e-mails generated by selecting "Virus!"
MAIL_LIC.TXT		to use for e-mails generated by selecting "License!"
MAIL_CON.TXT	to use for e-mails generated by selecting "wrong forum!"
NEW_1.TXT		to use for forum message announcements (for new uploads).

You can edit these files the way you like. Notice, these files are _exactly_ the mail/message
you will send.
To make it more "automatic" you can use the following "fields". Golden Sysop
automatically will replace these "fields" with the right things.
For example: If you want to insert the correct actual file name
in your mail or message, you insert the "field" [FileName] into your template file.

Golden Sysop uses knows the following fields:

[Forum] - For the forum GO-Word, such as GCPSUP
[ForumName] - For the Forum Description that you have entered in FORUMS.CFG
[Name] - for the Uploader's user name
[FileName] - for the name of the upload that was distributed
[FileDescription] - the complete description of the uploaded file
[LibraryNumber] - the library number where the upload was distributed
[UploadDate] - the date of the upload
[UploadTime] - the time of the upload
[ForumNameDativ] - only for german sysops (please ask 104125,2070 for detailed information)
[FileTitle] - the title (or short description) of the uploaded file
[Date] - the current date in this form: YY/MM/DD
[DateLong] - the current date in this form: 31 Dec 1997

There are two more fields, which are only allowed to use in NEW_1.TXT for announcement messages:

"[FileSize]" - the size of the file
"[LibraryName]" - the library's name (for example: You have a library 0 "Sysop Library".
                     In this case, "0" is the "[LibraryNumber]" and "Sysop Library" is the "[LibraryName]")

Please note: You have to insert _exactly_ these "field" names. Only if you have exactly used these
names, Golden Sysop will work properly.


The Subject (or title) line

Each of the mail/message templates have a first line, a so called "subject line").

For example, this line is:

{Subject:New File [DateLong]}

This line must be start with { and end with } - and the "Subject:" is also needed!
After {Subject: you can insert the subject you want to have for the mail or message. It's allowed
to use the "fields" (see above for a list of these "fields").


The signature lines

Please note that automatic mails and messages, created with Golden Sysop, do not use the Signatures
that are provided (if configured) by Golden CommPass. To have signatures in your mail or messages, 
you have to insert the signature lines into the template files for your Golden Sysop mails and messages.

In a sample file these lines are:

.___YOUR NAME____
.Sysop [ForumName]

For a simple signature, just replace the "___YOUR NAME____" string with your name.

In my case, I use the following signatures lines in each of my mail/message template:

.  Carsten Mller
.
.  Sysop
.  [ForumName]



How to use the TopTen functions


Building TopTen is just implemented and works only for

- all libraries (you can not select the libraries that you want to have for the TopTen)
- alltime TopTen (this means you can not create monthly or weekly TopTen's)

First, you have to create a new forum catalog (there's a button in Golden Sysop which you can use 
give Golden CommPass the command to create a new catalog).

Note: If you create this new catalog with Golden CommPass and _not_ with Golden Sysop, you have
the chance to select the libraries you want to have for the TopTen! Golden Sysop's button to download 
a new catalog will create a catalog of _all_ libraries!)

After creating a new catalog you can select what kind of TopTen you want to have (for example Top10,
Top100, Top250 or maybe Top 173...? <g>) and push the "Build Top x" button.

After the build process you see the result in the multiline edit field at the right side of the Building
TopTen Window.

The result comes in comma separated form and is stored in the file "alltime.res" in your Golden Sysop
directory. This alltime.res file you can easily open in many word processor or spreadsheet applications
to reformat it or use it otherwise.

At this moment, these are all of the features to build a TopTen. There are coming more.... soon!



How to use the membership report feature

Golden Sysop 0.9 and higher provides a new user interface to download membership reports. It's a little
bit easier to select what kind of membership report you want to have.

Just select Membership/Get Membership reports - the user interface is simple and easy to use.



How to use the mail to members feature

Well, the "Mail to members" feature (you find it with the menu Membership/E-Mail to members) is
one of my privat favorites of Golden Sysop. With this feature you're able to create mails to lots of
your forum's members with just a few mouse clicks.

For example: If you want to "welcome" all new members, which joined your forum within the last days
you have to get a membership report ("by date joined"). After downloading the report, you take 
the mail to members feature of Golden Sysop and do the following:

- load the membership report file (in this case it's the FORUMNAME.DJN file)
- load your e-mail template file (which you have created before)
- Push the OK button

With the next online pass of GCP your mails will be sent to _all_ the members that are in the 
membership report name (in this case FORUMNAME.DJN).

A "little" sample for your e-mail template file for this function you can found as "MEMBERS.TXT"
in the Golden Sysop ZIP archiv. Feel free to change it with any ascii editor (such as E.EXE) to 
configure it in the way you want to have it.

Please note: The E-Mail to members function does _not_ support field variables (you know, the fields
that you have in the E-Mail to uploaders or the New Message functions). 

This feature not only works for DJN files. It also works for all other membership report files.0



What is planned for future releases of Golden Sysop?

Well, there are many things I really want to implement in the next future. These are:

- Completing the TopTen features:
  weekly and monthly TopTens, automatic generating uplades and messages with the TopTen results

- Creating membership base features:
  Editing membership entries to modify flags, user names, speacial accesses and all that stuff

If you have suggestions, bugs or something else, please feel free to contact me: 104125,2070






