KEYWORD.DLL - File Keyword Searcher V2.0 (User Side)
KEYWORD.HLP - User Help File
CAM_SRCH.DLL         "         "         (Host Side)  
KEY_TAG.EXE - Offline Viewer/Tagger
KEY_TAG.HLP - Offline Viewer/Tagger Help File

An Excalibur Plug-In from Insight Media.


What does it do ?
~~~~~~~~~~~~~~~~~
KEYWORD is a full blown File Keyword Searcher and New Files Lister.
It allows the user to search the file descriptions, both short and long,
to give them a list of files containing the entered text.  The user can
download and preview the resulted files, whilst the search still continues.
The download flag for the conferences and libraries are taken into account
and the keyword searcher will not search the conferences and libraries that
the user does not have download access to.
There is a New Files command, that lists the files that have been uploaded
since the user last logged on. This option does not search through libraries
which are on CD.

User configurable options allow the user to :
  Select which conferences to search for new files and keywords.
  Search CD areas only,  Search hard drive areas only, Or search both.
  Display the files upload date or actual file date.
  Minimize the searcher upon starting the search.
  Pop up the searcher upon completion of the search.
  Save the settings for future use.

The selected conferences are saved in the same directory as your BBS image
files.  This enables a separate list to be saved for every BBS running the
keyword searcher.

When the search has finished, the user may then view extended file information
for any of the resulted files.  This extended information includes the following:

File Name
Short Description
File Date and Time
Number of Downloads
File Size
Uploaded Date
File Cost
Whether or not the file is free to download (Bytes).
The Long Description.


Whats New in Version 2 ?
~~~~~~~~~~~~~~~~~~~~~~~~
Conference and Library download security updated to cater for multiple flags
with the ~OR, ~AND and ~NOT operators.
Default downloadflag is also used if no flags are set for the conferences or
libraries.
A log file can be used to log users search results.
Fully resizable interface with minimize and maximize.
Built in checks for user bytes/ratios/cash balance, as Excalibur's were found
to be inadequate.
User selectable "Always on Top" option for the keyword searcher application.
The user can now choose to search for new files uploaded in the last xxx days,
where xxx is a number between 1 and 999.
Save Results facility to allow the user to view the results offline with our
Keyword Tagger.  The user can then mark files for download and have the files
automatically download upon next connection to your system.
Command line options for Keyword Searcher to
	a) Launch Searcher as normal.
        b) Launch Searcher into New Files since last call mode.
	c) Download any files the user has marked using the offline tagger.


OK This sounds good, how do I use it ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Unzip the KEYWORD.ZIP file into your excal directory, usually c:\excal
The zip file should contain the following files :
KEYWORD.DLL  - User Side Plug-In
KEYWORD.HLP  - User Help File
CAM_SRCH.DLL - Host Side Plug-In
README.TXT   - This File.
KEY_TAG.EXE  - Offline Viewer/Tagger
KEY_TAG.HLP  - Offline Viewer/Tagger Help File

Start up Merlin and load your files screen or wherever you want to enable
the keyword searcher to be loaded from.  Add a command button with the following
action:

Action : Plug-In
DLL Name : cam_srch.dll
Commands : <see command line options>

Now save your screen and log onto your bbs locally.  Click on the command to 
launch the plug-in.  Now quit the keyword searcher and edit your insight.ini 
file which is located in your Windows directory.  Find the following section

[File Keyword Searcher]
CD Drives=
Registration Key=Unregistered
Log File=

The CD Drives= line is used to inform the keyword searcher which of your drives
are CD drives.  This information is used to decide if the searcher should omit
the library from a new files search and also if the Search CD Areas option is
not selected.  You should simply list the drive letters of all the CD's as
follows :
CD Drives=DEFG
This would assume that any libraries that contain files located on drives
D,E,F or G are CD Areas.
The Log File= line is used to enable the logging facility.  Just place a file
name in here, ie. c:\excal\keyword.log   and the users search results/fails
will be logged here.  At the moment there is no facility to trim the log file
automatically when it reaches a certain size.


Command Line Options.
~~~~~~~~~~~~~~~~~~~~~
You can now start the Keyword Searcher in 3 modes by using the following
command line options:

Placing -N in the action command field, will force the Keyword Searcher to
launch and start an immediate search for new files since the users last
call.  All conferences the user has download access to will be searched.

Placing nothing in the action command field, will start the Keyword Searcher
in normal mode.

Placing a -T in the action command field, will check if the user has any
files tagged for download and then attempt to download them.  All security
and files/bytes/balances are checked and adhered to.  The tag file is then
updated so the user can load the results back into the tagger and find out
why, if any, files were not downloaded.

You will need to at least have a CAM_SRCH -T somewhere on your BBS or the
user will not be able to use the offline tagging facilities.  The best place
for this would be on your login screen, as the Keyword Searcher will just
end if no files are tagged for download.


Unregistered Restrictions.
~~~~~~~~~~~~~~~~~~~~~~~~~~
The unregistered version stops after the first 3 files.  Apart from that, all
other options are available.


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
[File Keyword Searcher]

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

Replace the Unregistered with your registration key, and thats it.
The keyword searcher will now return all the files that match the
criteria.


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.

