How to install and configure the Perlfect Search script and integrate it into your website.
The way the Perlfect search engine works is to create an "index" of all the files you want to be searchable. A search engine's indexer "crawls" through each file and creates a database of keywords, so that when someone searches your site, the search engine knows which files contain the words used in the search
Perlfect search offers two different methods for indexing a site, as well as several other configuration options. The below sections will go into more detail describing your options and the results each one will bear. However, please note that indexing times vary greatly, depending on the number and different types of files to be indexed in your account. Please be patient when creating your index, as it may take several minutes for the indexing of your site to conclude. If you stop the browser during the indexing process, your site will not be indexed and attempts to search your site will fail.
The first thing you need to do to get the perlfect search engine up and running is to install the scripts into your account. To install:
1) Connect to your account control panel at: http://www.example.com/admin
2) Click the 'Website Tools' tab at the top of the page
3) Click the 'Site Search Engine' item for the menu on the left side of the page.
4) Choose the domain name(s) that you want to install the search for, and click the 'Update Search(es)' submit button. This will install the scripts into your account under the domain(s) selected. Now you can configure the search.
5) Click the 'Configure search' link for the domain you want to configure/index. On the configure page, you will be presented with the following options:
Web based indexing - Web-based indexing starts with your site's home page and then crawls to every available link from your home page, as long as that link is within your site. For example, if you have a menu bar on your home page that goes to an "about" section, a "friends" section, a "links" section, and a "contact" section, web-based indexing will index your home page, your about page, your friends page, your links page and your contact page. However, any links you may have to outside URLs on your links page (e.g. http://www.datarealm.com) will not get indexed. Web-based indexing is the preferred method if you use dynamically-generated pages (e.g. php) on your site. The main reason being that, if you use the file system method of indexing to index a site with dynamically-generated pages, anyone could view the source code of your pages by clicking on the "highlight matches" link provided on the perlfect search results page(s).
File System Indexing - File system indexing begins in the home directory of your site and crawls through every single file in that directory and each sub-directory below your home directory. So, even if a file exists in your directory and you have no link to it on your site, the file will be indexed. Furthermore, if someone performs a successful search for a term (or terms) that exists in that file, it will be returned on the search results page (even though no direct link to the file exists on your site). File system indexing is the preferred method if you have a group of non-dynamic pages, and you are OK with displaying pages from within your account on the search results page that may not have direct a link from within your site. File Types to Index - Perlfect allows you to choose the types of files you wish to index. So, for example, if you want to index every Microsoft Word doc and every HTML file in your account, but you do not want to index any plain-text files or Adobe PDF files, you can specify so before you index your site. To select a file-type to index, simply place a check mark in the box next to its extension name on the configuration page. HTML, HTM and TXT files are selected by default, though you can always deselect them if you wish.
PLEASE NOTE: There are TWO places to choose file types! Make sure you choose the file types within your preferred method of indexing!
Directory to index - If you index your site using the web-based method, it will always begin with your home page. However, if you choose file system indexing, you can actually specify the directory in which you would like the indexing to begin. If you would like to index your entire site, you can leave the 'Directory to index' field blank (perlfect defaults to your home directory for file system indexing). If you would like to only index a portion of your account, you can specify the directory to index by clicking on the 'browse' button and choosing the directory you would like to index.
6) Once you've chosen the options for your search, click the 'Create Index For...' submit button, and the indexing process will begin. Indexing times vary greatly, depending on the number and different types of files to be indexed in your account. Please be patient, as it may take several minutes for the indexing of your site to conclude. If you stop the browser during the indexing process, your site will not be indexed and attempts to search your site will fail.
Once you have indexed your site, go back to the main site search engine page. You should now see a 'Test search' link next to the domain you have just indexed. If you click on this link, a search page should open up, allowing you to search for anything on your site. Try typing in a word or two and clicking on the 'Search' button. If you are taken to a results page (even if no results were found), then your site was successfully indexed.
The 'Test search' page, in addition to testing your newly-created site index, also contains information on incorporating a search box into your own web pages. Simply copy and paste the code displayed on the 'Test search' page to place a search box on any of your account's web pages. Please note that each test page is configured specifically for its particular domain; so the HTML code on the test page for one domain will be slightly different than the code on another domain's test page. If you have more than one domain in your account, please make sure you are using the code for the correct search index.
At any point, if you would like to completely remove the perlfect search tool from your account, you can do so. Simply go to the main Site Search Engine page of your /admin and place a check mark in 'Delete search tool' under the domain from which you would like to remove perlfect search. Click on the blue 'Update search(es)' button at the bottom of the page, and perlfect will be removed from your specified domain.