WebSearch Script Configuration 2THE PERL SCRIPTS ARE NO LONGER BEEING SUPPORTED - PLEASE GO TO TETRABB.COM FOR THE NEWEST VERSION OF THE WEBBBS FORUM
$basepath & $baseurl: Define these variables with the absolute path
and corresponding URL for a “base” directory under which the various
directories to be searched all lie. These variables are used to
convert the paths to URLs for the results page.
%otherurls: If you wish to be able to specify several other possible
URLs — if, for example, some of the files you wish to search fall
under a different virtual domain or have to be referenced “through”
a shopping cart or other CGI program — then you can define this
variable with the desired path/URL pairs. Note that the script will
check this variable for matches to convert paths to URLs *before* it
checks the $basepath and $baseurl variables.
Please also note that this variable, like the $basepath and $baseurl
variables above, is *only* used for purposes of converting paths to
URLs. It does *not* determine what files or directories are searched.
All directories to be searched *must* be included in the @dirs
variable (except, of course, for any WebBBS 4.XX directories)!
$AllowDateSearch: If this variable is set to 1, visitors will have
the ability to specify dates when searching your site, so that, for
example, their results listing can include only files updated during
the month of September. If you want all searches to automatically
search the entire file set, just set $AllowDateSearch to 0.
$DisplayByDate: As noted above, WebSearch will, by default, display
search results in order by the number of keyword matches on the page,
if “live” searches are conducted. If, instead, you’d like the
results displayed in order by date, with the most recently-modified
files listed first, then set the $DisplayByDate variable to any
value greater than 0! Of course, if you’re using a search index
and/or including WebBBS 4.XX message sets in your searches, then
this variable will automatically be set to 1, since relevancy
rankings aren’t available.
%extrachars: By default, WebSearch will allow search terms to
include any alphanumeric characters (A-Z and 0-9), as well as
dashes, underscores, apostrophes and periods. If there are other
characters you’d like to allow in search terms, such as “foreign”
characters or particular symbols, define them in this variable,
along with any relevant HTML “encoding” that may be used to
display them, as in the following example.
%extrachars = (
$NoMETAs: WebSearch will, by default, search META tag information and
display the contents of any META “description” tags as a description
of the page. If you don’t want this done — if for example, all your
pages contain the *same* META information — then set $NoMETAs to 1.
$METAsOnly: This is essentially the reverse of the above variable. If
this variable is set to 1, then WebSearch will look only at a page’s
title and at the content of its “description” and “keywords” META tags
(if any) when searching the page’s content.
$UseDescs: If for some reason you don’t want *any* descriptions shown
for the pages in the results list, set $UseDescs to 0.
$DescsLength: If you want “descriptions” of your pages included in
the results listings, but aren’t using META tags, then WebSearch will
take the first X characters of text and display it as a description.
X is defined in this variable.
$SplitNames: If your files use internal location tags (<A NAME=”x”>
tags), and you want the “pieces” of the files to show separately in the
results listing, you can set $SplitNames to 1. If you set it to 0,
such internal tags will be ignored, and all documents will be viewed
by the script as single entities.
$bodyspec: This variable should be defined as illustrated with any
attributes (BACKGROUND, BGCOLOR, TEXT, etc.) which you want to have
assigned to the <BODY> tag on pages created by the script.
$meta_file: The path to a text file containing any HTML code (META tags,
etc.) to be inserted within the <HEAD> section of the pages produced
by the script. (This file, of course, is optional.)
$header_file and $footer_file: These should be defined with the
full paths to text files (optional) containing HTML code to be placed
at the top and/or bottom of the pages. This allows you to include
certain “standard” information on all of them.
$keyword_log_file: You can, if you like, define this variable with the
full path of a text file in which WebSearch will store the keywords
searched for by those visiting your site.
$PrintNewForm: By default, WebSearch will include at the bottom of all
search results pages, a new search form. If you don’t want it to do
so — if, for example, you have a search form in one frame with the
results appearing in another — then set this variable to 0.
$FormExplanation: This variable should be defined with any short
“explanatory” text that you’d like included in your search forms, to
assist your visitors in using them.
$HourOffset: If you are in one time zone and your Web host is in
another, you can use this variable to adjust the “last modified”
(and/or “posted”) times shown in your search results listings. For
example,if your server is located in the Eastern time zone, but
you’re in the Pacific time zone, set it to “-3″.