Not at this time. This requires the redistribution of a GEO-IP database that must be kept regularly updated.
Joomla! 1.5, 1.6, 1.7 and 2.5 are supported. Joomla 3.0 is not supported at this time.

If you want to add, for example, a contact form that will send an email to you or your location's email address you can follow the steps below using the Locator Component alongside Fabrik, a form generator component.

This is covered in two videos:

Part 1:

Part 2:

Step 1: Install, configure Fabrik and set up your Form. You have to install the Fabrik Component and the Fabrik Joomla Content Plugin. Be sure the Fabrik Content Plugin is published, it does not publish by default.

Create your form, and use this code in the form submission plugin.

$db->setQuery('select value from #__location_fields_link where location_fields_id=10 and location_id=' . JRequest::getInt('id'));
return $db->loadResult();

Create your fields and include a special LocationID field that contains this code in the "Default" option:

return JRequest::getInt('origid');

Ensure your Elements (fields), Forms and Tables are all published in Fabrik.

Step 2: Set up your locations to include an Email and the Fabrik plugin code as shown in the video. Your description field for your location might look like:

<p>Sample Description</p>
<hr id="system-readmore" />
<p>{fabrik view=form id=2}</p>

Step 3: Set up your menu items to "Trigger Content Plugins" and also set "Display only Introtext" to "Yes". You may also optionally alter the position of the {description} tag in the "Item address format" so it appears last in the list.

That's it!


While this isn't officially supported, it's quite possible by editting the combined template.

See components/com_locator/views/directory/tmpl/combined.php This file includes both combined_item and combined_map_item to create the combined view. You'll find this block of code that outputs the results:

Move that block of code past the map output and it will appear on the right of the map as shown here:

This can happen when the TLD on your menu item is not set correctly. The TLD must be set in the back end for geocoding then also on the Menu Item Component Configuration as shown here: Searches are geocoded on demand, and the system needs to know what country the postal code is in. Also, if you incorrectly set your TLD, and perform multiple searches, those possibly incorrect search results are cached so all future searches for that postal code will continue to return incorrect results. To clear that cache, click the "Delete Geocode Cache" just above the list of geocoding results on the Geocode screen in the back end.

International charcters must be from a UTF8 encoded file to import properly.  Various versions of Excel are not the best tool to ensure UTF8 encoding.  Notepad++ is a free application that will allow you to open your .CSV file and convert it to UTF8.  Then save your file and retry your import.  

Visit for more information.

When the map doesn't show, this almost always means you have a Javascript issue *above* the Javascript the Locator inserts in your page to initialize the map.

1)  A single location may be causing your map to not display correctly.  This may be evident if one set of search results displays the map, but another search does not.  That usually indicates there is some bad data in one or more location's data fields.  The most typical culprit is "newline" characters added during the import process causing the javascript to fail.  Using the Javascript Console (Activated by F12 in Windows and  CMD+ALT J in OSX can show you exactly which location is causing the problem.  Click on the red error message displayed for details.

2)  A conflicting component or template may interrupt the map.  Joomla relys on your template to output Javascript in the correct position and we rely on that as application developers.  Some templates are better than others and may not follow Joomla's rules.  Similarly, some components may interrupt, change or remove our Javascript code output.  We can't support all templates or components but will do our best to help you identify the problem area.  Your browser's Javascript console (described above) can be indispensible in helping you identify the cause.

3) CSS may hide your map.  Similar to #2, your template's style may happen to have rules in it that hide your map.  We can't provide detailed advice on that matter here, but you may contact your template developer or investigate using your browser's built-in Element Inspector to see the CSS affecting a given element.  

If you have added a location, and it's not appearing on your locator (E.g. on the map or in the listing) there may be a few reasons why:

  • Has the location been Geocoded,(assigned a latitude and longitude) as indicated by a green checkmark in the geocoded column?
  • Is the location published as indicated by a green checkmark in the Published column?
  • Is the location appropriately tagged to correspond with your menu item settings?  
  • Do your menu item settings include a country selection?  Does the missing location have that same value in it's country field?
  • Does searching for a nearby postal code within a large radius return the location?  Was it properly geocoded?
  • Does keyword searching return the location? Was it properly geocoded?
  • Does the menu item include a tag selection?  Are you sure the location was tagged with that Tag?


This is caused by CSS in your template that adds margin to every div contained in a form.

The map and markers are assembled with DIV tags and if a margin is applied, many invisible elements get pushed around.

To address this, *remove* the CSS that adds 10px margin to your divs. We often see this as

form div{

That code is generally bad practice and should be removed.

This is not currently supported.  However, you can allow users to *add* locations from the front end.  

Page 1 of 3