Dansie Search Engine 2.7 ReadMe
By Dansie Website Design
http://www.dansie.net


##############################################################
DISCLAIMER AND LEGAL STUFF:
##############################################################

COPYRIGHT NOTICE
Use of the Dansie Search Engine software is subject to the terms of
the license agreement. By using this software you signify that you
have read the license agreement and accept its terms. Your purchase of
a Dansie Search Engine software license entitles you to one (1)
working copy of the script per license. You may NOT copy, reproduce,
resell, or give away copies of the script in any way shape or form
without first purchasing additional licenses. You may make one back up
copy should something happen to the working copy on your host. You may
not make any modifications to the Dansie Search Engine script except
as instructed in the ReadMe. The small text link and credit to
http://www.dansie.net must remain in the script and appear at the
bottom of the various pages of search engine script. Violation of this
license agreement may void your right to technical support and subject
you to legal action.
Dansie Search Engine
Version 1.0  January 15, 1998
Version 2.0  October 11, 2001

Do not modify the script except for the variables near the top.
Modifying the script below the variables is a violation of the
software license agreement and copyrights and may subject you to legal
action.

If you believe you may have received an unlicensed copy of the Dansie
Search Engine software or you have information about someone
conducting piracy, please contact us at:
http://www.dansie.net/question.html

Dansie Website Design will not be held responsible for any type of
damage or loss of time that may occur as a result of using this
script. This includes but is not limited to the corruption or loss of
data on your host. (Not that we intentionally put anything in it that
will cause any problems on your host, we just have to say this to
cover ourselves.) Customer assumes full responsibility for any damages
or loss of time that may occur. 

Refund Policy:
Make sure that your web host allows you to run CGI Perl scripts on
your website before you order. 30 day money back guarantee from the
date of purchase if the Dansie Search Engine does not run on your
website as advertised. If necessary, we will FTP in and get it running
for you. For any and all other reasons, all software license sales are
final and are non-refundable.

Please read all instructions carefully. Do not modify the script or vars.lib
except as instructed.


##############################################################
CONTENTS OF ZIP FILE:
##############################################################

search.pl  (The script)
ReadMe.txt (Instructions)
vars.lib   (File where all variables are set.)


##############################################################
IMPORTANT RULES OF THUMB:
##############################################################

You must be an expert at HTML and FTP to install this script. You
don't have to know anything about Perl, though a little experience
will help. After you extract the zip file, you may have trouble
opening vars.lib if "lib" is not a file extension that your computer
recognizes. Right click on the vars.lib icon, and select "Open
with...". Then, select a plain text reader from one of your programs
such as NotePad or WordPad. That should open it for you. Always upload
your Perl scripts to your host in ASCII format. Chmod your script 755
or better. Make sure the directory that this script is in is
executable (chmod 755 or better). You may need to name your script
search.cgi instead of search.pl depending on your host. Every line
with a variable in vars.lib must end with a semi-colon (;). Example:
$main_url = "http://www.dansie.net";
Do NOT put double quotes inside of variables that use double quotes.
Example:
$hr = "width="100%" align="center"";
Do NOT put single quotes inside of variables that use single quotes.
Example:
$header_html = 'Don't do this.';
You can, however, use double quotes inside of double quotes or single
quotes inside of single quotes if you first "escape" them with a back
slash like so:
$header_html = 'Who says this can\'t be done?';

If you want to keep a keywords log, then create a file called
"log.txt", upload it, and chmod it 666 (writable) and set the variable
called "$log" with the full system path and file name to that file.
Example:
$log = "/usr/local/etc/httpd/htdocs/cgi-bin/log.txt";

Failure to heed these warnings will entail countless hours of
frustration with your script not working. =)


##############################################################
INSTALLATION INSTRUCTIONS:
##############################################################

1. SET VARIABLES: Carefully set the variables in the vars.lib file. Accurate
system paths are VERY IMPORTANT! The NON REQUIRED VARIABLES you can set later
after you get the script working. The search engine has many customizable
features in the NON REQUIRED VARIABLES section. Adjusting the lang variables may
be done with caution. This allows the Dansie Search Engine to speak your
language.

2. UPLOAD: Upload the search.pl script and vars.lib file in ASCII format (not
binary) to your cgi-bin.

3. SET PERMISSIONS: Chmod the search.pl script 755. Chmoding vars.lib is not
necessary. What is chmod? See: http://wsftp.stormerhosting.com

4. TEST: Point your browser at it like so:
http://www.YourName.com/cgi-bin/search.pl
That's it! Search your web site!

5. SEARCH FORMS: Make a search form and insert it into one or more pages on your
website. See SEARCH FORM TEMPLATES below.


##############################################################
TROUBLE SHOOTING:
##############################################################

Possible reasons it may not work:
1. Your host doesn't have your site properly configured to run Perl scripts.
2. You didn't upload the script in ASCII format.
3. You didn't chmod the script 755.
4. One or more of the REQUIRED VARIABLES are not set correctly.
5. If clicking on a link returned by the search engine results in a 404 file not
found error, the $main_url and $main_sys_dir variables may not be set correctly.

If you still can't get it working, send us your FTP address, login
name and password. We will be glad to go in and get it running for
you. https://secure.stormer.us/~dansie/ftp_secure.html


##############################################################
SEARCH FORM TEMPLATES
##############################################################

The following is an HTML search FORM template that you can copy and
paste into any page on your website that will allow people to access
your search engine. Make sure to set the ACTION in the FORM tag to the
full URL to the search script. It should be the same URL as the
$url_to_this_script variable. Last, just make sure that the names of
the tags are exactly as you see below.

SIMPLE FORM:

<FORM METHOD=POST ACTION="http://www.YourName.net/cgi-bin/search.pl">
Search this site!<BR>
<INPUT TYPE=TEXT SIZE=35 MAXLENGTH=100 NAME="keywords">
<INPUT TYPE=SUBMIT VALUE="SEARCH">
</FORM>

POWER SEARCH FORM:

<FORM METHOD=POST ACTION="http://www.YourName.net/cgi-bin/search.pl">
Search this site!<BR>
<INPUT TYPE=TEXT SIZE=35 MAXLENGTH=100 NAME="keywords">
<SELECT NAME="method">
<OPTION>Intelligent Default
<OPTION>Any Words
<OPTION>All Words
<OPTION>Phrase
</SELECT>
<SELECT NAME="display">
<OPTION>10
<OPTION>20
<OPTION>50
<OPTION>100
</SELECT>
<INPUT TYPE=CHECKBOX NAME="partial_word_match" VALUE=1> Partial Word Match<BR>
<INPUT TYPE=HIDDEN NAME=power VALUE="1">
<INPUT TYPE=SUBMIT VALUE="SEARCH">
</FORM>


##############################################################
MISCELLANEOUS FEATURES:
##############################################################

The Dansie Search Engine 2.0 now has an Intelligent Default search
method. This method is a combination of all other search methods. What
it will do is look for phrase, all words and any words matches on all
pages, then rank them in that order. So stronger "phrase" matches will appear at
the top of the listings, then "all words" matches, and weaker "any words"
matches will appear at the bottom of the listings. It also ranks "any words"
matches in order of which pages contain the most number of those keywords. Pages
that contain the same type of keywords will be ranked according to which page
has the most number of those keywords.

If there are more than 20 listings in the results, a link will be provided to
view the next page
of 20, etc.

The search engine will ignore your HTML tags. However, it looks at all
text on your pages between your tags. If you have a navigation bar
that you need the search engine to ignore, then use these comment tags
in your page:

<!-- ignore -->
<A HREF="books.html">Books</A>
<A HREF="clothing.html">Clothing</A>
<!-- end ignore -->

They tell the search engine to ignore anything between them.
Otherwise, since your navigation bar is on all your pages, a search
for "books" could return a listing of every page on your website. Place the
comment tags on a line all by themselves.


##############################################################
TELL A FRIEND AND RECEIVE A FREE UPGRADE
##############################################################

We are always upgrading our scripts to make them easier to install,
easier for your customers to use, and to give you more customizing
abilities. If you refer someone else who purchases the Dansie Search
Engine, we will send you an upgrade - free. To receive the upgrade,
have the person you referred send us an email after they purchase
telling us it was you that referred them to us. Your free upgrade can
be collected anytime within one year of the referral. So tell a fellow
webmaster about the Dansie Search Engine. 


##############################################
UPGRADE INSTRUCTIONS
##############################################

You can purchase an upgrade here: http://www.dansie.net/upgrade_payment.html
1. Upload the new search.pl script in ASCII format to your email server
replacing the old one.
2. Locate any new variables in the new vars.lib file, if any, and paste them
into your old vars.lib file.
3. Upload your old vars.lib file with the new changes.
