Webnet77 Christian web host



Hosting Packages


Up to 40 GB storage!
Up to 200GB Traffic!

 

Christian
web hosting

Customizing Bible Search on your site

 

The *Bible Search directory and download

Create the directory bible_search on your website in the public_html directory like so:

public_html/bible_search/

NOTES:

  • the directory name must be all lower case

  • must have an underscore (not a dash) between bible and search

  • must be in the public_html/ directory.

  • Failing to adhere to the above exactly, will cause the templates on your site to fail.

  • download the templates HERE
     

HOW IT WORKS

Advanced Bible Search is now highly customizable. You can change the way the program behaves on your website limited only by your imagination and web development skills.

When the script is called from your site, it will first look in the *Bible Search directory on your site for the HTML files it needs. If it finds them, it uses the files on your site. If not, it uses the default templates.

In order to use your own templates with this software you need to do the following. These instructions need to be followed to the letter or the software will not be able to locate your template files:

  1. Create the Bible Search Directory on your site.

    The directory must be called bible_search (all lower case with un underscore between the two words.

    The directory must be located in your public_html/ directory like so:
    public_html/bible_search/
     
  2. Download and unzip the template files to your local PC. Click HERE to download.
     
  3. Customize the template files - see text below.
     
  4. Upload HTML files to public_html/bible_search/ on your website.
     
  5. Go to www.YourDomain.com/cgi-sys/bible.cgi OR www.YourDomain.com/ABS/ to test your Customized Templates.

    NOTE: If at any time you get weird results, it's most likely because you messed up one or more of the HTML tags in one or more of the template files. If this happens, you can either:
    • Delete the files in the template directory and start over.
    • Replace one file at a time with the one's you downloaded above until the problem goes away. Once you have identified which template(s) you messed up, you will at least know where to start looking.
    • If all else fails, remove the template directory and the script will use the defaults.

 

Please note that there is NO email support for this software. If you get stuck and need help, we have started a thread on the Message Board here where you can post your questions and advanced users can also share their experience and code with others.

Please do participate

If you do not have an account on the Message Board, you can get one here
If you have lost your password, you can get it emailed to you here.

 

The Header and Footer FILES

The two most important files you would probably want to customize are. Both are pretty self explanatory.
  • header.html
  • footer.html

Variables used in header.html and footer.html are duplicated in search.html. See text below for details.

What is important to remember is that these files DO NOT have opening or closing tags. Please take note of this. Neither have <html>, </html>, <head>, </head>, <body> or </body> tags. This information is kept in the search.html file.

NOTE: If you enter opening and closing HTML tags in the header and footer files, Bible Search will display multiple Copyright notices on the page and your pages will look all weird.

To customize the header and footer files simply edit them and upload to the *Bible Search directory on your site.

TIP: If you add images in the header/footer files, the image tag must be an absolute link. In other words the tag must link to http://YourDomian.com/ImageLocation/ImageName.gif and NOT ImageLocation/ImageName.gif
 

The Search.html File

This is the 'main' file and is the 'container' for the other two files above. If you examine the HTML of this file, you will see it has two variable in it called $header and $footer. This is where the software inserts the entire contents of header.html and footer.html. If you do not want a header or footer, simply remove the corresponding variable.

Upon further examination of the HTML you will see several more variables that begin with "$". Some you can edit, some you must not disturb or you will break the script and it won't work. For example, The variables that determine background color, font color, text color, text size etc, you can safely change but you cannot remove $result or the software will return zero results!

SCRIPT VARIABLES IN DETAIL AND WHAT THEY DO

Variable Name

Can Change?

What it does

 

NOTE: Items marked with ** are for advanced users only that really understand HTML and CGI coding.

ALL VARIABLES ARE CASE SENSITIVE

 

$charset YES**/NO Ensures the correct Character set is used. Example: Greek font for Greek Bible. Only change if only one Character set and or language is used because font size is changed dynamically by the software depending on language. Example: Thai, Greek and Hebrew.
$TITLE_BIB YES The page Title. Remove and enter your own value if you like.
$header YES The contents of header.html. Remove and enter your own value if you like.
$FORE_COLOR YES The foreground color. Remove and enter your own value if you like.
$T_BIB YES The text: "CHOOSE A BIBLE". Remove and enter your own value if you like.
$T_BOOK YES The Text: "BOOK or RANGE". Remove and enter your own value if you like.
$T_CHAP YES**/NO This text changed depending on whether a search is being done or not. Can be hard-coded to only one or the other option.
$bible YES** This is the Bible drop down menu. You can hard code it with only the Bibles you want provided you keep the name of the field as BIBLE. (Returned text is filtered by the server so it must match exactly. Case also).
$book YES** The drop-down for the books of the Bible. If you only want to display books in a specific language, you can change this. Remember the field name is BOOK. (Returned text is filtered by the server so it must match exactly. Case also).
$CHAP NO The drop-down for the chapters. This changes form book to book.
$T_SEARCH YES The text: "Type your text here". Remove and enter your own value if you like.
$search NO This is the box searches are typed into. (Text sent back in this field is filtered by the server depending on current charset)
$s_font NO The search and codepage font is not always the same as the page font and codepage.
$CASE YES** Ignore case Checkbox. You could hard code this as a hidden field if you wanted to get rid of it entirely. (Returned text is filtered by the server so it must match exactly. Case also).
$T_CASE YES The text: "Ignore Case". Remove and enter your own value if you like.
$hilite YES** The Highlight Checkbox. You could hard code this as a hidden field if you wanted to get rid of it entirely. (Returned text is filtered by the server so it must match exactly. Case also).
$T_HILITE YES The text: "Highlight Results". Remove and enter your own value if you like.
$T_RAD_READ YES The text on the "submit" button. Remove and enter your own value if you like.
$T_RAD YES The text: "Search Criteria". Remove and enter your own value if you like.
$rad0, $rad1, $rad2 YES** The radio buttons for "Exact Phrase", "Ignore Word", "Order Any Words". You could hard code this as a hidden field if you wanted to get rid of it entirely. (Returned text is filtered by the server so it must match exactly. Case also).
$first YES** Determines if the software displays the default "Easy Instructions" page when first called. (Returned text is filtered by the server so it must match exactly. Case also).
$FONTNAME YES**/NO The font name. Only change if only one Character set and or language is used.
$FONTSIZE YES**/NO The default font size. Only change if only one Character set and or language is used because font size is changed dynamically by the software depending on language. Example: Thai, Greek and Hebrew.
$FORE_COLOR YES The text color. NOTE: This and two above, appear more than once in the code. Remove and enter your own value if you like.
$font_style YES**/NO The font name. Example: Verdana. The only time it changes is to "Symbol" for one or two of the Greek Bibles.
$TABLE_BG YES Table background color. Remove and enter your own value if you like.
$hdr_text YES The test that says something like "(ISO-8859-1) King James Version, New Testament: jesus king lord" when a search is done. Probably not a good idea to remove it.
$rtl YES** Used only for right to left languages like Hebrew.
$results NO!! This is where the results of a search are inserted. (Don't remove it!)
$returned YES The summary at the end of $results. Example: "7 verses found."
$new_window YES Set by the user in a cookie in prefs.cgi. Contains the text "Target='_blank'". Use it if you want to allow your users to open new pages in new windows.
$sidebar YES** The sidebar showing all the other Bibles. Be careful here. The HTML is not as expected! Remove and enter your own hard coded value if you like.
$footer YES The contents of footer.html
prefs.cgi link YES Remove link if you don't want your users to be able to change it. Note: you must remove the link if you hard-code any of the items marked with ** since you will be over riding the software defaults. If you do not, expect a lot of "the preferences on your Bible Search don't work!" emails from your users.
getitcgi YES This link appears only in footer.html. However you may use it anywhere to link to your sites free version which your users may use or you may hard code the URL.


 

NOTES:
  • Images, Table background images etc must be absolute references.
  • The names.cgi, dictionary.cgi and preferences.cgi templates are currently hard coded. We will add them shortly.
  • The prefrences.html file will currently not be used even if you customize it. This will be rectified soon.
By manipulating the above variables, you can get the software to display just about anyway you like. If you do something special, please contact us and let us know. We will showcase your customizations!


Copyright 2002- Webnet77.com. All Rights reserved.
TOS::AUP::Privacy