Installation of Moxie Maps 2.5.2

There are 4 parts of the installation process:
	Installing and Configuring of the Moxie Zip Search Field Type into Mosets Tree
	Installing and Configuring of the Moxie Zip Search Module
	Installing the MoxieMaps template for Mosets Tree
	Installing the Savant2 plugins for Mosets Tree

Before installing any of the Moxie Maps 2.5.1 package, please verify that you have obtained a Google Maps API Key (http://code.google.com/apis/maps/signup.html),
and entered it into your Mosets Tree configuration on the Features tab. In addition, please set Show Map to Yes on the Features tab. 
You'll then need to use the "Locate Listings in Map" link in Mosets Tree (bottom left) to Geocode your listings based on their address information.
Once you have done this and verified that the maps show properly on a listing detail page, proceed with the installation of Moxie Maps 2.5.

STEP 1:

	Log into the backend of your Joomla site i.e., http://yoursite.com/administrator.
	Select Mosets Tree from the Components menu.
	Click the Custom Fields link in the bottom left corner of the page.
	Click the "Manage field types" link above the custom fields list.
	Click the "Add" button in the top right corner.
	Using the "Upload Package File" process, click the Browse button.
	Navigate to the "mFieldType_MoxieZipSearch-2.5.xml" file on your computer and select it.
	Click the "Upload File & Install/Update" button.
	
	You should see a "Field type installation successful." message.
	
	Now, click the "Back to custom fields" link.
	Click the "Moxie Zip Search" link at the bottom of the list.
	Set "Published" to "Yes"
	Set "Show in details view" to "No"
	Set "Show in summary view" to "Yes"
	Set "Advanced Searchable" to "Yes"
	Set "Hidden Field" to "Yes"

	Select the Parameters in the right column to your choosing.
	These parameters affect how the search fields are presented on the Advanced Search page:
		Search Type
			Nearest Listings - This option will not restrict the search by a user specified radius. It will return all listings sorted by distance from the searched Zip/Post code.
			
			Radius Search - This option presents the user with a Radius select box where they can choose a maximum distance from the center of the searched Zip/Post code to search within.
			
		Distance Unit - Select whether to use Miles or Kilometers in the Radius select box
		
		Radius Values - Enter the values for the Radius Select box. Separate values by a comma.
		
		Show Country List - Determines if a country list is shown to the user. When selecting a country, the Zip/Post code geocoding is influenced by the country selected.
		
		Default Country - Enter a country code i.e., US to use for the default country to use when searching.
		
	Be sure to click the Save button when done.
	
	
STEP 2:

	While in the Mosets Tree component, click the "Templates" link in the bottom left corner.
	Click the "New" button in the top right corner.
	Click the "Browse" button and navigate to the "MoxieMapsTemplate.zip" file on your computer.
	Click the "Upload File & Install/Update" button.
	
	You should see a "Template installation successful." message.
	
	Select the radio button next to the "Moxie" template.
	Click the "Default" button in the top right to make this template the default template.
	

STEP 3:
	
	Install the mod_moxie_zipsearch module using the Joomla Install/Uninstall function in the Extensions menu.
	Configure the module in the Module Manager.
	Many of the options are the same as set previously but only affect the Module when set here.
	Make sure to Publish the module.

STEP 4:

	You'll need to add the Savant2_Plugin_ahrefprintmoxie.php file to the "components/com_mtree/Savant2" directory.
	You'll need to add the Savant2_Plugin_moxiedistance.php file to the "components/com_mtree/Savant2" directory.
	You'll need to add the Savant2_Plugin_moxiemaps.php file to the "components/com_mtree/Savant2" directory.
	You can not use the Joomla installer to do this but must use a FTP client or some other means i.e., ssh, file manager, joomla based file manager, etc.
	

NEW OPTIONS:
	Version 2.5.1 includes new options configurable within the templates that determine how the map and markers will be shown:

	The map can be added to any Mosets Tree template that shows one or more listings with the following code format:
	$this->plugin("moxiemaps", $this, 'width', 'height', 'show', floatMap, cluster);
	
	The parameters included in this line are detailed below:
	
	moxiemaps - name of the plugin, don't change
	$this - passes listings to the plugin, don't change
	width - width of the map. You can use either values as percentages '100%' or in pixels i.e., '400px'
	height - height of the map. You can use either values as percentages '100%' or in pixels i.e., '400px'
	show - You can now choose to show:
		'page' - Listings on Page - this is the default. If you are showing 10 listings per page, you'll have 10 listings on the map
		'all' - All Listings in the directory
		'category' - All Listings in this category. Only works in the sub_listings.tpl.php template file.
		'featuredincategory' - All Featured Listings in this category. Only works in the sub_listings.tpl.php template file.
		'featured' - All Featured Listings in the directory
	floatMap - true/false - indicates if the map should float or scroll as the page scrolls
	cluster - true/false - turn the cluster function on/off for the markers
	
	Sample code:
		echo $this->plugin("moxiemaps", $this, '100%', '500px', 'all', false, true);
		Map would be 100% wide, 500px tall, showing all listings in the director, not floated, and using the cluster feature


This completes the installation and configuration of Moxie Maps 2.5.