Solutions : Site Search : Text Search

Text Search
Installation and Usage

FILENAME: ts.html

PURPOSE:

Describes installation and use of Text Search.

DEPENDENCIES:

se.pl - Search configuration and common logic modules (see: se.html)
jhzcs.pl - JHZ-CS configuration and common logic modules (see: jhzcs.html)
IID (Item Information Dataset)

REQUIREMENTS:

ts.cgi (web interface component)
ts.htm (template)

OPTIONAL:

Support for Banner Rotator System requires its components to be installed and configured according to specifications. Inclusion of Special Template markup supporting Banner Rotator System must also be included within the template supported by this product. See sample template provided with this product.

PACKING (PARTS) LIST

INSTALLATION:

Locate the following in "ts.cgi" and modify as described below:

############################################################
#
#	CONFIGURATION SECTION
#

require "/home/cust/yourdomainname/www/cgi-bin/se/se.pl";

$template_file			= $site_root."tmpls/se/ts.htm";
$search_data			= $site_root."data/ts/search.dat";

#
#	END CONFIGURATION SECTION
#
############################################################

1. Modify the absolute file path contained between quotes for the "require" statement to correctly point to "se.pl"
2. If the default install locations are not used, modify the file path relative to "$site_root" (defined in "jhzcs.pl") contained between quotes for the "$template_file" configuration variable assignment to correctly point to "ts.htm"
3. If the default install locations are not used, modify the file path relative to "$site_root" (defined in "jhzcs.pl") contained between quotes for the "$search_data" configuration variable assignment to correctly point to "search.dat"

Locate the following in "ts_data.cgi" and modify as described below:

############################################################
#
#	CONFIGURATION SECTION
#

#	Directory path of website root
$root = "absolute-path-to-root-directory";

#	Platform path delimiter
$delim = "/";

#	Directory path and filename of output file
$srch_data_fs = $root."data/ts/search.dat";

#	URL to prepend to page URLs
$base_URL = "http://www.jhz-cs.com";

#-----------------------------------------------------------
#	START and END and EXCLUDE content directives 
#	example could be for start "<BODY" and "</BODY>"
$srch_start	= "<!-- content start -->";
$srch_end	= "<!-- content end -->";

$exclude_content_start	= "<!-- EXCLUDE FROM SEARCH START -->";
$exclude_content_end	= "<!-- EXCLUDE FROM SEARCH END -->";
#-----------------------------------------------------------

#-----------------------------------------------------------
#	OUTPUT TO FILE SWITCH
#	Comment line to output to screen only
$output_to_file = 1;
#-----------------------------------------------------------

#-----------------------------------------------------------
#	Subdirectories not to search
#	nested subdirectories will not be searched either
@exclude_dirs = (
	"cgi-bin",
);
#
#-----------------------------------------------------------

#-----------------------------------------------------------
#	Files not to search
@exclude_files = (
	"test.html",
);
#
#-----------------------------------------------------------

#
#	END CONFIGURATION SECTION
#
############################################################

1. Modify "$root" to correctly point to the absolute directory path to the website's home directory. "$root" is search along with all nested subdirectories. "$root" is also used to point to the relative path of the output file defined in "$srch_data_fs"; see below.

   NOTE: If invoking locally on the PC development platform, be sure to correctly point to the absolute path, not the relative path. If invoking remotely on the web server, the path will typically be different than the local path.

2. Modify "$delim" to the platform specific path delimiter; ie., UNIX/Linux/MacOSX use "/", Mac OS 9 uses ":" and Windows uses "\"
3. Modify "$srch_data_fs" portion between quotes to correctly point to "search.dat"

   NOTE: This determines the location where the "search.dat" file will be written to. It is important to specify the location where "ts.cgi" expects this file to reside. If not using the default install locations, all configuration variables in "ts.cgi", "se.pl" and "jhzcs.pl" must be consistent.

4. Modify "$base_URL" to correctly specify the HTTP domain name address of the website. This is used within the "search.dat" file for dynamically generated links to the results output when "ts.cgi" is invoked at the website.
5. Modify "$srch_start" and "$srch_end" to specify the markup indicating what portion of each HTML file is to be included in the search. To use the default specified HTML comments, insert them into each HTML document at the start and end position of the content to be searched. Or, change the value to the desired markers such as the suggested "<BODY" and "</BODY>" to search the entire content contained between the HTML BODY tags. NOTE: the starting "<BODY" marker does not include a terminating ">" as additional parameters within the BODY tag would prevent that marker from being recognized within the HTML file.
6. Modify "$exclude_content_start" and "$exclude_content_end" to specify the "exclude" markup indicating what portion of each HTML file is to be excluded in the search. To use the default specified HTML comments, insert them into each HTML document at the start and end position of the content to be excluded from the search. NOTE: HTML tags and content contained within SCRIPT tags are automatically excluded.
7. Modify "$output_to_file" to 1 or "" (null) to specify whether or not the file is to be output to disk. This is used for testing in the PC development environment with "ts_data.cgi" being invoked from the command line. Turning this option off (optionally commenting this line with "#") causes the result to be sent to terminal.
8. Modify "@exclude_dirs" adding subdirectories to exclude from the search. Each entry must be wrapped in quotes and terminated with a comma.
9. Modify "@exclude_dirs" adding filenames to exclude from the search. Each entry must be wrapped in quotes and terminated with a comma.

DATA GENERATION

For generation of the search data file "search.dat" refer to the "USAGE" section below.

TEMPLATES:

Customize templates for appearance as desired:

ts.htm

Special mark-up within the Text Search templates includes the Search Banner indicating the string search for and the number of pages returned, and the repeating page link entries "Entry Start" and "Entry End" directives.

<!-- Entry Start -->
<!-- Entry End -->
	

TEST:

Test installation and configuration by invoking "ts.cgi" using a test page containing the Text Search controls.

USAGE:

To perform generation of the "search.dat" file invoke it either locally in the PC development environment or remotely on the web server; depending upon how ts_data.cgi is configured (paths are specific to the particular environment where it is intended to be invoked). When invoking locally from the PC development environment, upload the resulting "search.dat" file to the server location specified in "$search_data" contained "ts.cgi".

Following successful installation and satisfaction of dependencies and requirements, add the Text Search Controls to static pages and JHZ-CS page templates as follows:

For static pages:

 <form action="/cgi-bin/se/ts.cgi" method="post">
 <input type="text" name="search_text" value="" size="20">
 <input type="submit" value="Search">
 </form>

For page template the slight addition of value="<<search_text>>" results in that input field being primed with the text the user entered for subsequent use:

 <form action="/cgi-bin/se/ts.cgi" method="post">
 <input type="text" name="search_text" value="<<search_text>>" size="20">
 <input type="submit" value="Search">
 </form>

You may optionally modify the form's submit button to use your own image as opposed to the web browser default button with the follow:

 <form action="/cgi-bin/se/ts.cgi" method="post">
 <input type="text" name="search_text" value="<<search_text>>" size="20">
 <input type="image" name="search" value="search" src="/images/buttons/search.gif">
 </form>

Change "/images/buttons/search.gif" to correctly point to your button image.