Smart Search Setup Smart Search (v3.0) Setup Instructions Go to bottom if you are upgrading Setup: Set the path to perl at the top of each CGI file (except vars.cgi) e.g. #!/usr/bin/perl Open vars.cgi and follow the instructions inside to customize the script. Edit welcome.txt with the message you want new members to receive by e-mail. Edit all HTML files with header and footer info. News.html will contain the HTML displayed to members on the main account page (accounts.cgi). The text (.txt) files contain text displayed in e-mail messages. Create a directory in your cgi-bin (such as "smartsearch"). Upload all files in ASCii mode. Put all HTML and TXT files (except directories.txt) in a subdirectory called "html" ("smartsearch/html"). Put directories.txt, confirm.data, ccpay.data, ccpay_2checkout.temp, paypal.data and submissions.data in the same directory as the CGIs. Change the permissions of these files to CHMOD 777. Create a subdirectory called "accounts" ("smartsearch/accounts"), one called "keywords" ("smartsearch/keywords"), "data" ("smartsearch/data"), and another called "cached" ("smartsearch/cached"). Depending on your server, you might need to change the permissions of these 4 directories to CHMOD 777. Change the file permissions of all CGI files to CHMOD 755. You are done! Test it out now... Searchfeed and Smart CGIs promotion! Did you know that we worked out a deal with Searchfeed to pay YOU an extra 20% commission over their regular payout rate? If you don't know what Searchfeed is: it's a search engine which pays YOU every time you refer a visitor who clicks on the search results. Smart Search can display their listings on YOUR search results pages, making it easier to generate clicks. Just signup by clicking here and you will make 133% more money than their other affiliates! How to use: Unless you create your own HTML forms: send people to signup.cgi to create an account, to accounts.cgi to add listings (and more), and smartsearch.cgi to perform searches. Run admin.cgi to approve submissions, add money to user accounts, and more. If you want to accept credit card deposits with ClickBank: Signup and then provide the necessary info in vars.cgi for it to work. Don't forget to upload ccpay.cgi and to change your "thank you" page URL at ClickBank to the URL of ccpay.cgi. Test it out with zero dollars (and Clickbank will let you provide fake credit card info) and a test account to make sure it works. If you want to accept credit card deposits with 2checkout: Signup, specify your 2checkout ID number in vars.cgi, and change your "return URL" to the URL of ccpay_2checkout.cgi on your site. You will find the "return URL" form by logging in at 2checkout.com, click on "Shopping Cart" at the top, then on "Cart Details", provide the URL and press "Save changes". If you are using the ClickBank or 2checkout feature: payment.html contains the html members see when they want to deposit money into their account. The tag [cc_form] will be replaced with the form to make a deposit. payment_complete.html contains the HTML members see after depositing money. The tag [amount] will be replaced with the dollar amount they deposited, the tag [order_number] will be replaced by the person's unique order number, and the tag [username] is again replaced by their username. If you are also using PayPal for deposits, the [paypal_form] tag in payment_complete.html will be replaced by the form to make a deposit using Paypal. If you use the affiliate program feature, affiliates.html contains all the info your members need about it, including the HTML to put on their sites. In that HTML file, The tag [username] will be replaced with their username (which is required in the search form they put on their site). The HTML for an example form is in that file, just make sure the URL points to your smartsearch.cgi file on your site. If you want to include bidded listings on your site somewhere, use the following SSI tag: <!--#include virtual="/path/to/cgi/include.cgi?keywords=your_keyword&show=show_number" --> Replace your_keyword with the keyword you want to show listings for. Replace show_number with the number of listings you want to display (default is 5). That will only display the title (with link), if you want to also display the description, URL, or cost of bid, you can add the following: <!--#include virtual="/path/to/cgi/include.cgi?keywords=your_keyword&desc=1&url=1&cost=1" --> If you want to use a Javascript tag instead of SSI, just add "&java=1" to the end and put it in a tag like the following: <script src="http://www.mysite.com/include.cgi?keywords=your_keyword&java=1"></script> If you want to display the top keywords searched for this month, put the following tag. Replace pop_number with the number of keywords you want to display. SSI: <!--#include virtual="/path/to/cgi/include.cgi?pop=pop_number" --> Java: <script src="http://www.mysite.com/include.cgi?pop=pop_number&java=1"></script> All information displayed with the include.cgi file can be used by your affiliates too (and they will get credit). For example: SSI: <!--#include virtual="/path/to/cgi/include.cgi?keywords=your_keyword&username=my_username" --> Java: <script src="http://www.mysite.com/include.cgi?keywords=your_keyword&username=my_username&java=1"></script> You can provide affiliates with a database style print out of your search results if you want. This can be used by programmers who want to include your search results in their search engine script. The search listings will be printed out one per line, in tab delimited format (data is seperated by tab spaces). Just tell them to use the following URL: http://www.yourdomain.com/cgi-bin/include.cgi?keywords=your_keywords&username=my_username&db=1 If you want your keywords to be in organized in categories, put something like the following inside the directories.txt file: tech/hardware/computers/computer accessories/monitors tech/hardware/computers/computer accessories/printers tech/hardware/computers/computer accessories/scanners tech/hardware/computers/ibm tech/hardware/computers/compaq tech/hardware/computers/mac tech/hardware/laptops tech/hardware/keyboards tech/software Now I'll explain... You can put as many directories as you want (although a plain text Perl file can't hold more than 5000 lines). You don't have to list the main directories, just the deepest sub-directory. In the example above I don't need to put: tech tech/hardware tech/hardware/computers tech/hardware/computers/computer accessories tech/hardware/computers/computer accessories/monitors I only need to put: tech/hardware/computers/computer accessories/monitors The CGI can figure out by itself the directories above that one. Also, DO NOT repeat any directories in another group, the CGI will just match the keyword to the first one it finds. For example, if you have: software/downloads music/news music/mp3/downloads The "downloads" is repeated, that's not good. What you should put is something like this: software/software downloads music/news music/mp3/mp3 downloads You wouldn't get an error message if you didn't do this, but the CGI would simply take the first directory it finds. In the above example (the red one), if someone searched for "downloads", the CGI would tell them they are in the "software/downloads" category. If this was too confusing, you will figure it out as you test the directories out :) If you want to let your visitors pick which external search site's results should be used, you can give them a form like this: Dmoz.org MSN.com SearchFeed.com AltaVista.com None The HTML for this is: <form method="POST" action="smartsearch.cgi"> <div align="left"><p><input type="text" name="keywords" size="10"><select name="crawlsite" size="1"> <option selected value="1">Dmoz.org</option> <option value="2">MSN.com</option> <option value="3">SearchFeed.com</option> <option value="4">AltaVista.com</option> <option value="0">None</option> </select><input type="submit" value="Search" name="submit"></p> </div> </form> This is done by passing on the variable "crawlsite" with the appropriate number. 1 is Dmoz.org, 2 is MSN, etc. and 0 (zero) is none (no external search results). If you don't use this type of form, the default one will be used (as set in vars.cgi). If you want to allow people to upload Microsoft Excel Spreadsheets to submit search listings, you will need to install the Spreadsheet::ParseExcel perl module on your server. Ask your web host to install it if you don't know how. Important note: this module requires the OLE::Storage_Lite module to work. And THAT module requires the following modules: IO::Handle (included in IO), IO::File (included in IO), and IO::Scalar. I know that's a lot of modules, and I hesitated adding the Excel feature to Smart Search because of all the modules required, but I figured you might still want this great feature. So it's up to you if you can and want to install the required modules. You can find perl modules here, and module installation instructions here. Good luck!   Note: Generally this CGI and it's data files should not use up too much space on your server, except for the click logs which might add up if you have a heavily used site. For most people 5 MB would be more than enough for this CGI.   Upgrade Instructions Replace all CGI files. Upload the new ccpay_2checkout.cgi, paypal.cgi, and excel.cgi CGI files as well, change their permissions to CHMOD 755. Upload the new ccpay_2checkout.temp and paypal.data files as well (in the same directory as the CGI files). Set the permissions of these 2 files to CHMOD 777. Create a sub-directory called "data" and change its permissions to CHMOD 777. Nothing needs to be uploaded into it. The payment.html template file has a new tag: [paypal_form] will be replaced by the form to deposit funds using Paypal. So you might want to add that tag to it. Results grabbed from Google.com are no longer available (various reasons), instead MSN.com was added. "Approve All Submissions" button in admin has been removed due to problems with large amounts of submissions. You can approve/deny maximum 100 submissions at once now.   If you experience any problems with the results pulled from any of the other search engines (LWP module feature), e-mail [e-mail]   Special Notice to Resellers: You can use this script on any site of yours, but if you sell one of these sites, you are required to FIRST purchase a new copy for the new owner. If you don't, it's considered copyright infringement and we will prosecute any offenders. WE MONITOR EBAY.COM AUCTIONS, SO BEWARE. If you want to work out any reseller deals with us, contact [e-mail]   Support: Technical support is not provided, but if you have small problems, send questions to [e-mail] Check out http://www.smartcgis.com for updates to the CGI. Send suggestions for future versions to [e-mail]