Dansie FAQ Wizard 2.0 ReadMe
By Dansie Website Design
Version 1.0 (c) 3/24/1999
Version 2.0 (c) 2/19/2010
http://www.dansie.net


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

COPYRIGHT NOTICE AND SOFTWARE LICENSE AGREEMENT
Use of the Dansie FAQ Wizard 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 FAQ Wizard 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. A license is nontransferable from person to person. 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 FAQ Wizard script except as instructed in
the ReadMe. The text links, and copyright credit to http://www.dansie.net must
remain in the script free of modification and appear on the various pages of the
Dansie FAQ Wizard script. Violation of this license agreement may void your 
right to technical support and subject you to legal action.

Do not modify the script except for the $vars variable near the top of the
script.

Modifying the script 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 this script or you
have information about someone conducting piracy, please contact us at:
piracy@dansie.net or 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 server. (Not that we
intentionally put anything in it that will cause any problems on your server, 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
Dansie FAQ Wizard does not run on your website as advertised. For any and all
other reasons, all software license sales are final and are non-refundable. If
necessary, we will FTP in and get it running for you.

Please read all instructions below carefully.


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

faq.pl              (The script)
ReadMe.txt          (Instructions)
faq_vars.lib        (variables settings file.)
faq_header.txt      (Insert text and HTML content here for the top of your FAQ pages.)


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

You must know how to use an FTP (File Transfer Protocol) program to install this
script. You don't have to know anything about Perl or HTML. Always upload the
Perl script in ASCII format and chmod 755.

Cookies must be enabled in your browser. This program utilizes JavaScript. For
best results, be sure to use an updated browser version.

Always make a backup copy of faq_vars.lib before you make any changes to it.
That way if you make a mistake, you can revert back to your older copy.
Always open and edit faq_vars.lib with a plain text editor such as Notepad or
SimpleText.


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


1. Make a sub directory in you cgi-bin named "faq".
   /cgi-bin/faq/
2. Set required variables in faq_vars.lib.
3. Upload faq.pl and faq_vars.lib to your /cgi-bin/faq/ directory in ASCII
   format.
4. Chmod both the "faq" directory and the faq.pl script 755.
5. Point browser at script with "?login" query string and enter your admin
   password as set in faq_vars.lib.
   Example: http://www.YourName.com/cgi-bin/faq/faq.pl?login
   Bookmark this URL so you can login to your FAQ any time.
6. Click the "Add New FAQ" button and begin building your FAQ database.


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

Most common problems:

1. You didn't upload the script in ASCII format.
2. You didn't chmod the script and it's directory 755.
3. Your host doesn't have your site properly configured to run Perl scripts.
4. Your server may not have all the required Perl modules required for this
   script to run.
5. If the script executes, but it yields an error message about not being able
   to find the system path, you may need to set the $vars variable near the top
   of the script.
6. If you get a "50 Error" it's because you entered your admin password incorrectly
   5 times and caused your IP address to become banned.  To get back in, FTP into 
   your website and delete the "wrong_password_ip_log.txt" file in your 
   /cgi-bin/faq/ directory.

If you still can't get it working, send us your FTP address, login name and
password. We will be happy to go in and get it running for you. Send it to us
securely here:
https://www.dansie.net/ftp_secure.html


##############################################################
# Inserting a FAQ link on your website's pages:
##############################################################

You can place a link on your website to your Dansie Searchable FAQ like so:
<A HREF="http://www.YourName.com/cgi-bin/faq/faq.pl">Frequently Asked Questions</A>


##############################################################
# Tips:
##############################################################

Insert an IMG tag to your company logo in the faq_header.txt file.
Set $footer_html in faq_vars.lib with "faq_footer.txt" and you can insert text
and HTML at the bottom of the fAQ's pages.
Make a periodic backup copy of your faq_db.txt file in your /cgi-bin/faq/ directory.


################################################################################
TELL A FRIEND AND RECEIVE A FREE UPGRADE AND ONE MORE YEAR OF TECHNICAL SUPPORT:
################################################################################

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 Dansie FAQ Wizard, we will send you a free upgrade and one
more year of technical support. 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 Dansie FAQ Wizard.


##############################################################
UPGRADE INSTRUCTIONS:
##############################################################

You can purchase an upgrade of the latest version and one more year of technical
support here:
http://www.dansie.net/upgrade_payment.html

1. Rename the new script to "faq_new.pl" and upload it in ASCII format to your
   /cgi-bin/faq/ directory.
2. Chmod the new script 755.
3. Point your browser at it to see if it works.  If so, delete your old copy and
   rename the new copy to "faq.pl".
4. If you get an Internal Server Error, see TROUBLE SHOOTING INSTALLATION above.



