Knowledge Base - Main documentation

 

Tutorial Step 3 - How to create a new markerset

From the GF control panel click on "Create a New Markerset" or you can go to "Markersets Manager" and click on "New" to create a new markerset.

On the “Basic Markerset Settings” tab:

  • Markerset name: Enter the name of the markerset
  • Map selector: Click to select the map you want this markerset to be displayed on. In other words, choose a map that you have created previously in the “Map manager”  for ex: “My Map”.

On the “Template ” tab:

Here you can determine the contents of the bubble template of the markers on the map and also the sidelist template (if you choose to use them). In other words you can define where and what you want to display in each case.

How bubble work

When a user clicks on a marker a bubble is loaded. This bubble is loaded dynamically when it's clicked, and is not included into the page HTML code. The content of this bubble is defined in each markerset for all markers loaded by this markerset.

The set of parameters and how they are displayed is called a "bubble template" or "side template" for sidelist. You can edit this template on the markerset editor page.

Placeholders concept

In Geocode Factory, markers are linked to entries, events or profiles. Bubbles can contain HTML code, and placeholders. Geocode Factory offer the opportunity to use placeholders to represent the corresponding value from that data source. Placeholders are always between brackets { }. Placeholders are based on supported fields that are available and vary depending on the current component the makerset is using as the data source.

To see the current list of place holders, click the “select” button to bring up the placeholders generator tab. You can click on the elements you want to add in each case and you can include html. You will find some sample templates under the tabs “Sample template” and “Sample tabbed template” that you can use.

This mean that if you write <h1>{title}</h1> into your template, the result will be the entry title (or profile name) into a title 1 style (of your joomla! template) like "Entry title". 

 There is a lot of placeholder, each depending the current gateway (pattern), you will see each time a little help how to use it.

On the “Markerset type ” tab:

Select the markerset type from the dropdown. The selection depends on which 3rd party items you wish to display with this markerset (joomla content, community builder, sobipro, etc).

Other optional settings:

You may want to configure the various optional markerset settings available as well. For each of these options, placing your mouse cursor on the item name will reveal a pop-up explanation of what the field is and/or how to use it.

Marker icons

There are many different options by which to define the marker icons :

  • Google: This is the standard default google icon.
  • Uploaded image: Here you can use any kind of image you have uploaded in the joomla image folder. The image should be a transparent png.
  • Mapicon: A selection of the mapicon from mapicons.com
  • Avatar/entry: This will use the current marker’s source image. For profile-based markersets it will be the user’s avatar, and for directory-based ones, the entry logo. You can also set a custom size to have the same icon size for all icons. A background icon (half circle) is used to define the center point of the avatar icon.
  • Folder icon: For directory-based markersets, the image/logo of the category the entry is located in will be used (if the entry is in multiple categories the first one will be used by default).

You can define a fixed size for the marker icons, there is 2 methods:

  • Fixed size: You need to enter a with and height, integer values in px. All images will have the same size. Sample: [16] and [16], aéé images will have this size.
  • Factor size: You need to enter a integer values in % into the first inputbox (you see the % unit). This factor will be applied to all images. Sample: [33] -> a 60*90 image will be displayed as 20*30
The specific settings tab

This tab is generated depending on the currently selected pattern. The settings are different for a profile component based pattern versus a directory based component one.
Here you can generate the fields based on your choice of filter for the current markerset (like field_color=’red’). Again, the filter here depends on each third party application you are currently editing in the markerset section. If you use the filter generator (where you select the field, the operator and the tested value), a little contextual explanation is displayed in each case, with a little sample as well.
The use of this feature is the most common source of errors that result in no markerset displaying! Remember that here you are adding a clause/condition affecting the mysql database query. Each wrong or missing charter/quote will cause an error. Handle with care!

Applies To

Geocode Factory 5