Installation

Install the module using Joomla module installer in the admin backend.

Publish the module.

Remember that the database is not created during installation. It will create the database when it receives the first hit (hit literally means when someone browses the page the module is published at).

For this reason your first hit will not be registered. (this will be sorted out in the next release)

How does the module work?

The module looks at the IP address of the person viewing the page. It then tries to translate the IP address to a physical city. It will write this information to the db if is able to translate the IP address to a city.

What is really been displayed?

The markers on the map shows recent visitors to your website (or the page where the module was published). You can limit the number of markers to be shown via the admin backend.

How do I show the map only on certain pages?

Go to module admin backend. On the right hand of the screen you will find a list of menu item links. Select only the menu items where you want to show the map.

My page/site is slow after installing this module.

You might try limiting the number of markers been displayed. Also you might want to limit the sections where the map is shown as described above.

Some of the columns in the jos_geo_visitors table is not updating

Yes, at this moment the module is not using all of the table columns. The only column that is been used right now is “geoLocation”. The other columns are for future use.

What’s the cookie timeout parameter in the admin backend?

It’s used to minimize load on the module. By setting a cookie on the end users PC, the module will know that this is a recent visitor and there is no point in processing his details.

My location is not been plotted

Not all cities are known by the reference database that is been used. IP addresses which cannot be resolved to a city are been ignored. I am hoping to switch to Google’s Geocoding to see if there database is more accurate.