Knowledge Base - Getting Started Guide

Basic Markerset configuration

Introduction

In this chapter we will explain how to populate your Geocode Factory maps. Geocode Factory uses markersets. A markerset is a kind of filter that retrieves information from a data source. A basic markerset will return all markers from a component and as you add additional configuration settings you can finely control what is displayed. In other words, a markerset is used to create the rules to load the markers on the map.

A markerset will generate markers, and each marker represents one user’s profile, one directory’s entry or one event. You can load multiples markersets on one map. Even if the source of the markerset is the same extension. For example you can create 2 markersets from your Community : one for women with a pink icon, and a second for men, with a blue icon (of course you need to have this information contained in the user's profile).

To learn more advanced features, please go to the the Geocode Factory Concepts chapters of the documentation.

Markerset Manager lists

By clicking the markerset icon in the Geocode Factory control panel, you will be taken a list that contains all available markersets. You can filter this list by extension, map and name. To create a new markerset, simply click the add button corresponding the desired extensions (the button depends the Joomla version, in the capture below is the green icons).

markerset list filters

 

You can easily edit, duplicate or delete a markerset, by clicking the corresponding button in the Edit tools column. You will see the icon you have assigned to the markerset into the Marker icon column, and if you use the user avatar as icon you will see here a generic avatar. This is the same for the category icon, you will see a category logo.

 

tuto_markerset

The creation of a markerset is very similar between the different supported extensions (Jomsocial, Sobipro, Adsmanager, …). The most important difference is between a Profile markerset and a directory markerset. Here are the common settings for all of them :

  • Set name : Name of the set, used in frontend for the different lists
  • Map : Sets the map on which the markersets are displayed.
  • Marker Accuracy : Applies to the marker position during the display. You can reduce the accuracy if you don't want to display exact locations. The coordinates in the source profile will not be altered.
  • - High : the marker keep coordinates as is when displayed on the map
  • - Medium : the marker is randomly moved with a distance of about 100m
  • - Low : the marker is randomly moved with a distance of about 500m
  • Menu itemid : joomla menu item id that defines the context to see the detailed view linked from the bubble. See here how to use menu itemid.
  • Bubble width : define bubble width, see width of the bubble.
  • Field for title : Select the text shown on the marker tooltip and the [TITLE] placeholder
  • Marker image : The image must be in images/stories, ideally in png (IE dont understand gif on maps). See the marker images article.
  • Avatar size factor : Apply a custom size to marker icon
  • HTML code snippet for the bubble : this is the template of the bubble. You can use HTML tags, CSS styles, and js code mixed with the placeholders variables. The available variables are listed on the google maps bubble templating article. You see that many of the fields of the used component (CB/JS/SOBI) are supported. The [field_city] will be replaced by the current profile city. Example: London. In addition to these fields, you find some others special placeholders like [LINK], [ONLINE_STATUS], ... theses are component dependent and are replaced by the profile value.
  • Placeholders texts : Click the insert button to copy the variable into the template box above
  • Filters : This allow you to filter the markers by filters with logical conditions. Like field_age > 18, or such. Depending the component you are using you will be able to create simple to elaborate filters. There is an FAQ article that provide examples : see the filters creation chapter.
  • Radius : You can enter here a value (in kilometers or miles) to search profiles (Community Builder / Jomsocial / Sobipro, etc) in a radius around the logged user or from a fixed point. See How radius search works
  • Users to Allow : Joomla user groups you give access right to see the markers (users that have access)
  • Sales area radius : select the field where you have stored the sales radius distance of each entry. This field need to contains a numeric value. Please read the radius article to learn more about this feature.

Markerset for profile components

  • Show only logged in members : the markerset searches only the currently online members
  • Online / offline template : replacement code snippet that contain a text that shows 'Online' or 'Offline', you can customize this value by adding some style (green/red color, ...) or including a logo. See the bubble templating article under user online status.
  • Groups to include : Joomla user groups to include in the field (users that are displayed)

Markerset for directory components

  • Categories : you can select the categories to include here. See the working with category article.
  • Section (sobipro only) : Sobipro allows to create different fields, entry forms, detail depending the section. Before the fields are displayed in listboxes, please select a section, and save the markerset. The remainder of the options will then be available.
  • Draw lines : draw a line between the entry marker and the marker of that entry's owner.
  • Autocategories : if you publish the map through the Geocode Factory module, and this module is published on a directory component you will see only the entry of the current category. See the working with category article.

Applies To

Geocode Factory 3