Knowledge Base - Getting Started Guide

Plugins configuration

In this section we want to speak about the 'basic' plugins, that are included in the Geocode Factory package :

  • Geocode Factory Article
  • Community Builder profile
  • Jomsocial profile

There is also others plugin that are more specifics, and not included in this package. Please refer you to their related detailled documentation chapters bellow :

  • Sobipro Map Search
  • Community Builder Map search

Introduction to plugins

For the most part, Geocode Factory doesn't store any data itself and requires third party components to create it. Geocode factory is a mapping extension that gives you a new way to display data....it doesn't create data itself. Sometimes these third party components do not have internal Geo-coordinates, or don't allow the extension to geocode data on it's own. This is the reason we provide some specific plugins. Depending your environment and your goal, you may or may not need to install additional plugins.

All plugins are installed at once with the Geocode Factory package.

plugin-comp-explanation

Directory components

If you are using one or more of the following components to manage entries, ads, events, on your site.

Sobi2

There is nothing to install. Since Sobi2 2.9.0 the coordinates fields are installed by default within Sobi2. If you have deleted the fields, you need to create 2 custom fields named field_latitude and field_longitude (custom names are supported). To Geocode the entries, you have 2 choices :

  • create your own geocode script (see here)
  • use the Geolocalise plugin for Sobi2 (Sobi2 plugin), that offers many features like auto-geocode during Sobi2 entry creation, picking a point on a map, geocoding from gallery image, batch geocode...

Sobipro

Field plugin

There is nothing to install as the component has internal coordinates fields. To geocode the entries, you can use the Geocode Factory batch geocode function. You can already buy the SP-Geomap field (club members only). Geocode Factory is 100% compatible with this application, and if SP-Geo Field is not installed, we create these fields. See here how Geocode Factory works with Sobipro for more details.

Search plugin

We also have a search plugin that can filter the internal search function of Sobipro results that will allow you to display those results on a map! Of course the plugin is also compatible with our Sobipro Radius Search Application. This is a commercial plugin and information can be found in the Sobipro map Search chapter. Use the Joomla! installer to install this plugin.

Mosets Tree

There is nothing to install, the component has internal coordinates fields. The events, are geocoded automatically during the creation. You can also use the Geocode Factory batch geocode function.

Adsmanager

There is nothing to install, the component has internal coordinates fields. To geocode the ads, you can use the Geocode Factory batch geocode function or install the Adsmanager’s Geomap plugin provided by Joomprod. It allows to geocode the ads during the creation process. This plugin is 100% compatible but not required.

Profile components

If you are using one of the following components to manage your users profiles, Geocode Factory will allow you to display users on a map.

Community Builder

Profile plugin

Community Builder doesn't have any coordinates field, and doesn't support geo-locating of members. To resolve this situation, we have created a plugin to display a map on the user’s profile, and geocode the user’s position. To get the user's coordinates, multiples methods are available :

  • geocode before or after profile creation
  • pick a point
  • browser’s position

It uses the Google maps v3 API, and shows Geocode Factory maps or Static image maps to display the user’s position and supports up to 3 addresses per user. The plugins will install the 2 fields for latitude and longitude, but the usage of custom fields for latitude and longitude is supported too.

This plugin is included into the Geocode Factory package file and is installed automaticaly at same time as component.

Search plugin

We also provide a search plugin that can filter the internal search function of Community Builder results. This is a commercial plugin and can be found here 'CB Map Search'. Install it through the Community Builder plugin interface.

Jomsocial

Jomsocial use internal latitude and longitude fields to store the user’s position. Since Jomsocial 2.0, the user’s position is geocoded by Jomsocial itself. We have create a plugin to display a map on the user’s profile, and (useful for Jomsocial before 2.0) geocode user’s position.

This plugin is included into the Geocode Factory package and is installed automaticaly.

Calendar component

Jomsocial Events

There is nothing to install, the component have internal coordinates fields. The events, are geocoded automatically during the creation process.

Jevents

There is nothing to install, the component have internal coordinates fields. To geocode the events, you can use the Geocode Factory batch geocode function or install the Geolocation component provided by the Jevents editor.

Content component

Joomla articles

Geocode Factory allows you to place a map in Joomla content articles. The data is saved into a separate table and are Geocoded by our plugin. Please see article describing this implementation process in the documentation. This plugin is located into the Geocode Factory package and is installed at same time like as component.

Applies To

Geocode Factory 3