DINGDONG
~~~~~~~~

DING2.DLL - User Announcer V2.0 (User Side)
CAMDING2.DLL     "         "    (Host Side)  

An Excalibur Plug-In from Insight Media.


What does it do ?
~~~~~~~~~~~~~~~~~
DINGDONG simply announces who has just logged on/off your system to
the other users.  It displays this message in the users Excalibur
terminal status bar, allowing uninterrupted use of the system.
DINGDONG will also play a different wave file when a user logs on and
off the system.


Whats new to v2.0 ?
~~~~~~~~~~~~~~~~~~~
The new version 2.0, allows the sysop to place users into a particular
group and associate wave files for that group.  An on and off wave
file is chosen for each group.  When the user logging on activates
cam_ding.dll, the groups are checked and the appropriate wave file
is played on the sysops machine.  If the user isn't in a group, then
no wave file is played.  This enables the sysop to "HEAR" which group
of users are logging on, ie. other sysops, co-sysops, VIP subscribers.


OK This sounds good, how do I use it ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you are installing it for the first time, then please use the following
instructions.  If you are upgrading from version 1.0 to 2.0 then please
skip to the Upgrading DingDong section.

Unzip the DING2.ZIP file into your excal directory, usually c:\excal
The zip file should contain the following files :
DING2.DLL    - User Side Plug-In
CAMDING2.DLL - Host Side Plug-In
DING_ON.WAV  - Wave File for User Logging On.
DING_OFF.WAV - Wave File for User Logging Off.
README.TXT   - This File.

Start up Merlin and load the main login screen, ie. the first screen the
user is shown when they log on to your system.  Add an action to all the
hotspots/buttons that chain the user to another screen, as follows:

Action : Plug-In
DLL Name : camding2.dll
Commands : 

Now save your screen and log onto your bbs locally.  Click on the 
hotspot/button to launch the plug-in.  Now you can wait until a user
logs on to your system and you will be notified via the status bar
in your Excalibur terminal software.


Upgrading DingDong from 1.0 to 2.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Delete the old cam_ding.dll and dingdong.dll from your excal
directories.  Now unzip the ding2.zip file into the excal
directory. The files have been renamed for version 2 as
problems were arising with sysops running the previous version
of dingdong on the BBS machine whilst dialling into a system
running version 2.
Now edit the screens that actioned dingdong before it was
upgraded and edit the actions to read camding2.dll instead
of cam_ding.dll


Configuring the Groups.
~~~~~~~~~~~~~~~~~~~~~~~
Once the camding2.dll has been activated, you will find the
following lines have been added to your insight.ini file (located
in the windows directory):

Group 1 FileName=
Group 1 On Wave=
Group 1 Off Wave=
Group 2 FileName=
Group 2 On Wave=
Group 2 Off Wave=
Group 3 FileName=
Group 3 On Wave=
Group 3 Off Wave=
Group 4 FileName=
Group 4 On Wave=
Group 4 Off Wave=
Group 5 FileName=
Group 5 On Wave=
Group 5 Off Wave=


First you need to create the group files.  You can define up to 5
groups.  Use a text editor to create a file called cosysop.txt and
in the file place the ID's of all your co-sysops.  The ID's must be
one per line as follows :

1
3
42
89

Save the file and the edit the insight.ini file.  Find the line that
says "Group 1 FileName="  and enter the path and filename of the 
cosysop.txt file you created.  If you placed it in the same directory
as cam_ding.dll then you only need to put cosysop.txt in with no path.
Now choose an on and off wave file that will notify you when a cosysop
logs on and enter the names against the Group 1 On Wave= Group 1 Off 
Wave= lines. ie.

Group 1 On Wave=cosyson.wav
Group 1 Off Wave=cosysoff.wav

Ok thats all there is to it, when a user logs on, the group files are
scanned and if the user is found to be in a group, the appropriate
wave files are played on your system, so you can hear who's logged on
and off.


Unregistered Restrictions.
~~~~~~~~~~~~~~~~~~~~~~~~~~
Yes, there are some otherwise you wouldn't register.  The unregistered
version only displays the users ID Number, ie. User 48 Just Logged On.
Or User 175 Just Logged Off.


How do I register ?
~~~~~~~~~~~~~~~~~~~
Registration can be made directly with Insight Media or Cyberspace UK.
Or alternatively, you can order a copy through any EWDN distributor 
worldwide.

When you receive your registration key, you should edit the INSIGHT.INI
file, which is in your windows directory, and find the section titled
[Ding Dong Announcer]

You should see the following line directly after the title :
Registration Key=Unregistered

Replace the Unregistered with your registration key, and thats it.
DingDong will now tell you who logged on/off by displaying the users
handle.


Contacting Insight Media.
~~~~~~~~~~~~~~~~~~~~~~~~~
Should you need any more help with this plug-in, then you can either
contact Chris by Email on chris@insight-media.co.uk or you can contact
me, Darren, the programmer on darren@insight-media.co.uk
Ring the Insight Media BBS on +44 (0)1942 762762 - Ringdown
or @bbs1.insight-media.co.uk via an Internet connection.

The best forum for support is the list server plugins@insight-media.co.uk
as I am the list owner and will pick up mail daily.

Thanks for trying our plug-ins, and please register to enable us to
continue producing top quality plug-ins for Excalibur.


Obtaining Upgrades.
~~~~~~~~~~~~~~~~~~~
If you want to be notified via Internet Email of any updates to Insight
Plug-Ins, then send an Email to programming@insight-media.co.uk with
your BBS Name and list the products and versions you currently have.
You will then be told if your versions are the latest, and also be
notified as new versions become available.
The plug-ins list server, as mentioned above, can be used to have the
updates mailed to you.

