cgredir_html.cgi (3679, 2000-03-12)
cgredir.cgi (2519, 2001-02-15)
# --------------------------------------
# Advanced MetaSearch Add-On
# 'Framed Redirection' v4.x
# File: FRedir_ReadMe.txt
# --------------------------------------
# All Rights Reserved
# (c) CurryGuide.com, 2001.
#
#
#
# IMPORTANT:
#
# This program, its components, subroutines are property of CurryGuide.
# As agreed, you are only allowed to use this program under the following
# conditions:
#
# 1. This 'Framed Redirection' add-on and other related files
# (hereinafter mentioned as 'script') remains under the copyright of
# CurryGuide which includes the programming design, architecture,
# individual operational blocks, subroutines etc. You, the buyer is
# quoted as the 'buyer' hereinafter.
#
# 2. The 'script' as a whole or any part of it may NOT be resold,
# copied, transferred to another party or used in any other program
# for ANY purposes.
#
# 3. The 'buyer' is only allowed to update or modify individual elements
# or programming blocks or subroutines where they are clearly marked
# as modifiable or commented as modifiable.
#
# 4. E-Mail Technical support is provided under the terms defined in the
# 'Package Description' on the website.
#
# 5. Under no circumstances CurryGuide shall be held liable to ANY
# loses, fines, judiciary proceedings directly or indirectly related
# to purchase or usage of this 'script'. The 'buyer' uses this program
# entirely on his/her own risk.
#
# 6. One single package entitles the 'buyer' to use it on one (1) single
# individually identifiable domain or sub-domain ONLY.
#
# 7. The 'buyer' must clearly identify his/her requirements and clarify
# all technical compatability issues before the actual purchase.
# The 'buyer' also understands that NO refunds can be claimed.
#
# 8. Headers and CopyRight information at the begining of each file MUST
# remain intact. Under no circumstances you are allowed to alter or
# modify or remove them.
#
# 9. CurryGuide reserves the sole right to review and/or change the
# 'Purchase and Usage Conditions'. Current 'Purchase and Usage
# Conditions' will be available on a CurryGuide website.
#
# ---------------------------------------------------------------------
# Ref: AM4.00(std)-01-2001-AON-FRDR-DOC
TABLE OF CONTENTS
-----------------------------------------------------------------------
1. The Package
2. System Requirements
3. Installation
4. Customization
5. Problems
6. Technical Support
---------------------------------------------------------
1. The Package
--------------
The package usually comes in a compressed zip file. When unzipped
it should contain the following files:
1. cgredir.cgi - the main add-on script (written in perl)
2. cgredir_html.cgi - second script that works with the above script
2. FRedir_ReadMe.txt - this file.
2. System Requirements
----------------------
Advanced MetaSearch Engine v4.0 (or higher) installed and working properly.
3. Installation
---------------
>> (a) Check the perl path in both add-on scripts ('cgredir.cgi' and
'cgredir_html.cgi'). Initial setting is as follows:
#!/usr/local/bin/perl
Change it to CORRECT path to perl on your server, if required.
>> (b) Open the Search Configuration File/s from your 'conf'
sub-directory and find the 'Section H'.
Assign the URL of your 'cgredir.cgi' to the '$Framed_Redirection_Url'
parameter as shown below:
$Framed_Redirection_Url = "/cgi-bin/cgsearch/cgredir.cgi";
You can also assign the full (absolute URL) like this:
$Framed_Redirection_Url = "http://your-server.com/cgi-bin/cgsearch/cgredir.cgi";
>> (c) Save the changes you have just made to your Search Configuration
File/s.
NOTE: If you have other Specialty-Search packages installed
(example: Auction, News, MP3, Job, FTP, Book etc.) and want to use
Framed-Redirection on them you should also modify those Search
Configuration file (auction.pl, news.pl etc.) as shown in the
previous step.
>> (d) Now, make necessary modifications and HTML customizations
in the 2 Framed-Redirection scripts (cgredir.cgi and cgredir_html.cgi).
See the script files for details. They are clearly explained.
>> (e) Save the changes you may have made to these Framed Redirection
scripts and upload them to the Main Script Directory (cgsearch).
Set permission to both scripts (if required):
cgredir.cgi - chmod 755 (-rwxr-xr-x)
cgredir_html.cgi - chmod 755 (-rwxr-xr-x)
Installation is complete if you have followed all the above 3 steps
(from 'a' to 'e') correctly.
Now, your Advanced MetaSearch Engine is ready to handle Framed-Redirection.
But, before you can actually show the results with Framed-Redirection enabled
URLs you must make the following customizations.
4. Customization
-----------------
a) Open your Search Configuration File/s again and find the 'Section B'
where your Result Link HTML parameters are placed.
To make any URL Framed-Redirection enabled you MUST the following
NEW TAG:
##redirurl## ( instead of ##url## )
You can use this New ##redirurl## TAG on these 4 parameters:
$link_html
$link_html_no_d
$link_html_no_s
$link_html_no_ds
Example: If you want to enable Framed-Redirection on the result Title link ONLY
you can do something like:
##title##
You can still use the ##url## TAG if necessary, but it will not make a
Framed Redirection. Use the ##redirurl## TAG where you want a link to
open in a Framed Window.
Addition of this New ##redirurl## TAG allows you to design your result-links
with absolute control while leaving you with the option to add usual linking
as well (on the same result).
After you have made necessary customizations to your result links, save
the Search Configuration File/s and upload to the original location
(in the 'conf' sub-directory).
Now, search and see try your Framed Redirection Addon.
5. Problems
------------------
a) 500 Server Error
Make sure you upload you files in ASCII mode (not BINARY). Usually
all HTML files, images are uploaded in Binary mode. BUT cgi
scripts usually need to be uploaded in ASCII mode.
6. Technical Support
--------------------
Unless otherwise stated, you are entitled to 15 days e-mail support
on Installation issues ONLY. In any correspondence, please mention
your Customer ID.
Technical Support: support@curryguide.com
Website: http://services.curryguide.com/meta_prog/
___________________________________________________________________
Ref: AM4.00(std)-01-2001-AON-FRDR-DOC
No part of this document shall be reproduced, copied, published in
any other media or transferred to a third party without written
permission.
All Rights Reserved, 2001.
CurryGuide.com (A division of Highfield Business Corporation)
Web: http://services.curryguide.com/
-------------------------------------------------------------------