How to Install

Version 1.0 – http://freethefoxes.googlecode.com/svn/trunk/latest.js

Version 2.0 – http://freethefoxes.googlecode.com/svn/trunk/latest.v2.js

Simple Install
To install, include the following scripts at the bottom of your pages. Just before the closing body tag:

<script src="http://freethefoxes.googlecode.com/svn/trunk/latest.v2.js" type="text/javascript" charset="ISO-8859-1"></script>
<script type="text/javascript" charset="ISO-8859-1"> 
	var ftf = new ftf();
	ftf.init();
</script>

Advanced Install
Below the script include create a new script tag and the following are variables that you can set to customize it.

<span id="ftf_link"></span>
<script src="http://freethefoxes.googlecode.com/svn/trunk/latest.v2.js" type="text/javascript" charset="ISO-8859-1"></script>
<script type="text/javascript" charset="ISO-8859-1"> 
	var ftf = new ftf();
 
	// This would be the actual instance name. Look at the var name above.
	ftf.instance_name 	= "ftf"; 
 
	// We currently only have three sizes. "large" = 48x48, "regular" = 32x32, "small" = 16x16. 
	// All other values will default to regular.
	ftf.icon_size 	 	= "large";
 
	// This will write the HTML to a specific object on the page. 
	ftf.output_to 	 	= "ftf_link"; 
 
	// Look for version 2.0 to include other languages. 
	// "en" is the default language. For supported languages, see below.
	ftf.lang	 	 	= "en"; //THIS FEATURE IS DEPRECIATED IN VERSION 2.0 
 
	// This feature is a Version 2.0 feature. It is the upgrade of the above localization option. 
	// This must be a valid JSON file with the appropriate language translations. You can find the English version here:
	// http://freethefoxes.googlecode.com/svn/trunk/lang/en.json
	// You must upload the language JSON file to your website for use. (ie. ftf.lang_external = "includes/cs.json";)
	// Please refer to our localization page for all the languages already translated. 
	ftf.lang_external	 	 = "";
 
	// If users browser has a 3(failed) rating.
	// Would you like the script to automatically popup onload?
	ftf.onload 			= true;
 
	// We continuously store your website users specifications (OS, Browser, Version, etc)
	// and is available for your viewing in Version 2.0.
	// You can enable or disable this feature.
	ftf.analytics 		= true;
 
	// This will only display the popup onload once and is not persistent throughout the site.
	// Requires onload to be set to true as well.
	ftf.onlyonce 		= false;
 
	// You can download our default css here: http://code.freethefoxes.com/latest.css
	ftf.css_external 		= "your_css.css";
 
	/*
	The following are the three different approval levels you may set to specific browsers:
		1 = Pass/Recommended
		2 = Pass/Acceptable
		3 = Fail
 
	The following are the default values for each browser but can be easily changed by 
	resetting the values using the following method.
	*/
	ftf.rate_firefox		= 1; // FireFox
	ftf.rate_chrome			= 1; // Chrome
	ftf.rate_safari			= 1; // Safari
	ftf.rate_opera			= 2; // Opera
	ftf.rate_ie6 			= 3; // Internet Explorer 6.0
	ftf.rate_ie7 			= 3; // Internet Explorer 7.0
	ftf.rate_ie8 			= 2; // Internet Explorer 8.0
 
	// Execute
	ftf.init();
</script>


7 Responses to “Installation”

  1. Gavan Brown says:

    the onlyonce is not working in IE6, it loads everytime… I have onload set to true aswell.

  2. Kris Khoury says:

    Gavan, Thanks for the heads up. This is fixed now.

  3. inthewayboy says:

    Like the script…two things though:

    1 – There is a typo in the “Simple Install” section where you have type=”text/javascript” repeating twice in the second

    2 – When I use that same “Simple Install” code example it works, but seems to do something to my CSS? Without it things are centered, with it it’s justified…I haven’t looked into it too much yet since it’s so damn late ;)

    Thanx for the code!!!

  4. [...] Requirements: Javascript (turned on) Website: http://www.freethefoxes.com/ Download: Free The Fox (v2.0) Installation: http://www.freethefoxes.com/install/ [...]

  5. Kris Khoury says:

    :) Thanks!

  6. Mediacom87 says:

    It is a great tool and to facilitate integration into a shop Prestashop, I developed a specific module that you can find on my site.