Knowledge Base - Gateway for Seblod

What is it

SEBLOD is arguably the leading Content Construction Kit (CCK) and application builder component for Joomla!... and is free!

Using Geocode Factory's gateway plugin you can associate one or more sets of coordinates to each of your Seblod content. In this way, you can display the locations of your Seblod articles, users, categories, custom form submissions, ...  as markers on a map.


Seblod Preparation

Overview

To geocode your Seblod content using the Geocode Factory Seblod gateway plugin you will need to use Seblod custom fields. Geocoding simply means to assign the proper coordinates for their location. To Geocode your Seblod content you simply need 2 main set of fields:

1
Address fields

Several location field like street, city, postcode... more you define, more accurate will be the position.

2
Coordinate fields

Two text fields that will receive the latitude and longitude of each content after the geocode (these must be created separately but can be hidden).

Please note that Seblod provide a free field type that allow you to geocode any content during the saving process this 'Address to coordinates' plugin is free. Parameters include the choice of location fields and two text inputs for designating your latitude and longitude field as Geocode Factory, all is compatible!

Create theses fields in each content you want to put on a map before configuring the Seblod gateway plugin.


Installation

Overview

Note: In order to use Geocode Factory's Seblod gateway plugin, you need to have the last version of the Geocode Factory 5 free component already installed.

The gateway plugin for Seblod is not included in your Geocode Factory 5 package by default. This file is an optional extra:

  • plg_geofactory_gw_sbl.zip: Seblod gateway plugin

Access, Download and Installation

The Seblod Gateway plugin file "plg_geofactory_gw_sbl.zip" is installed using the standard Joomla installer and can be updated until your subscription expire.

Please read the Download, install and update manual for more information.


Gateway Plugin configuration

Inside the joomla “Plugin Manager” you will find the Gateway plugin you installed. To locate it more easily, you can use the filter by adding the text “geocode” for example, like in the following image.

 seblod-gateway-plugin

Geocode Factory - Seblod Gateway plugin

Configuring the Seblod Gateway plugin you have only the following option:

SEBLOD-plugin-settings

Default avatar image: Optionally, you can select a default avatar image here for profiles without an image. If left empty the default Google pin will be used in this case.

If you do not use this specialised feature, then you do not need to configure anything in this plugin.


Pattern manager and Seblod

When you enter the pattern manager you will see that each SEBLOD build articles, users, forms, ...  have a default available pattern. These pattern was created automatically when you installed the plugin.

SEBLOD-patterns-def

Please note that this screen depends your configuraiton.

Click on any "Default - Seblod - xxx" pattern and go to the third tab "Assign fields to the values".

Location data assignment from your Seblod fields

As we mentioned before, in order to geocode your Adsmanager (free) articles using the Geocode Factory Adsmanager gateway plugin you need:

1-) Address fields to fetch the coordinates: You can choose which fields you wish to assign for your needs. Not all fields apearing here need to have a selection. In other words, you can choose not to use some field assignments. In such a case, for the unused address fields the default option "Select" has to be selected.

2-) Coordinate fields to store the fetched data in: The coordinate fields need to be text types for them to show up as an option in the associated dropdowns of the latitude and longitutde fields. Please note that these fields will be used to store the coordinates fetched from the address fields above.

The coordinates field can of course be hidden fields! 


Markerset

The specific settings tab

The options on this tab are generated based on the currently selected pattern. In this tab you can select various different filters for the current markerset allowing you to further customize your data pool. You may also select some other options which are not filter-related.

Because Seblod can be related from any content type (user, articles, forms, ...), there is some option that can only be used for user's based markerset and that are not usable in other type of Seblod items.

 SEBLOD-specific

Filter Generator: Here you can introduce SQL queries to filter out your results. The Geocode Factory query will be build with your optional filter. Simply select the value and operation to test and the query is build. You can use mutiple tests.

Warning: The use of this feature is the most common source of errors that result in no markerset being displayed! 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!

Select title field: If you select a field here, it will be used as tooltip on the makers, and in the bubble for the {title} placeholder

Select avatar field: If you select a field here, it will be used as marker icon if you select the avatar as marker icon option in the previous tab

Select sales area field: Here you can select the CB field that will be used to calculate the "Sales Area". It has to be a numeric value/field. See the Geocode Factory advanced features article to better understand this functionality

Entries to load: Choose the status of the item to display, ex: published.

Profiles to load: Choose the status of the profiles to display, ex: online.

Online / Offline template: Will reprensent a code snippet that shows the user's status

Lines owners entries-events: Select if you wish to Draw Lines between the markers of the owners (authors) of the Seblod content.

Enable Auto-Category: With the auto-category feature enabled, the markers that will be displayed will be articles belonging to the categories you are currently browsing only (and child categories as well). This option is used to get a functionality typically seen in directories.

Applies To

Geocode Factory 5