Knowledge Base - Gateway for Community Builder

 

Community Builder Profile plugin

Once the profile plugin is installed it should be listed in the Community Builder plugin manager. (To locate this more easily, you can use the filter by adding the text “geocode” for example, like in the following image.) There is nothing you need to configure here and this is mentioned only for informational purposes and so you can verify it was installed properly.

CB Plugin in CB Manager

The Location tab and the coordinate fields

When the profile plugin is installed it will add a "Location" tab inside your Community Builder user profiles, as well as 6 new fields in your CB field manager. As you can see in the following images, there are 3 sets (pairs) of latitude-longitude fields available for you to use. This means that you can add up to three different addresses/locations to each user profile for whatever purpose (work, home, etc).

The Location tab:

CB Profile tab

The CB field manager:

CB GF5 fields

Configuring the Location tab:

The Location tab in your Community Builder tab manager has some basic settings similar to other CB tabs that you may want to configure. Please consult your CB documentation for more details on these.

cb tab manager

cb edit tab location

 

cb edit tab location 2

Configuring the coordinate fields

The 6 new fields in your Community Builder field manager have some basic settings similar to other CB fields that you may want to configure. For example, to select whether to make them visible on the profile (and also where if desired). Please consult your CB documentation for more details on these.

cb coordinate fields

CB GF5 field configuration

Configuring the plugin itself

There is 2 different modes to configure the profile map:

  • Simple map: This will display a simple google map, with one centered marker. By default, the map is very basic. But, in addition, if (not mandatory) you select a Geocode Factory map that contains a CB markerset, the map will take the configured zoom, size, map type and bubble. This is a very quick method.
  • Geocode Factory map (advanced users): This option will allow you to place a real Geocode Factory map, where you need to configure all settings, is a little complex, but the result can be more powerful, with more features.

To configure the plugin:

  • ID map 1: This is the ID of the Geocode Factory map to display on the profile view. You will find the ID on the backend map manager of the Geocode Factory component itself. You need to select a map that has at minimum, all CB user displayed on it to ensure the current profile user will be displayed. You can configure your markerset to load just the markers in a radius near the current profile.
  • ID map 2: Same as above, but only if you are using multi addresses.
  • ID map 2: Same as above, but only if you are using multi addresses.
  • Container front: Here you can enter the tab id of your custom tab manager (if you use the default, leave this blank), then, when this html element is clicked, the map is redrawn. 
  • Conainer edit: Same as above, but for the addition of profile. Also only for custom tab.
  • How many maps: Define the number of maps to display and edit on the profile. Leave 1 if you are using only one address per profile.
  • Zoom: You can force the zoom for the designated Community Builder map or leave Auto, to use the Geocode Factory map setting as specifiied in the component itself.
  • Register map: If yes, the map is displayed in registry form. In this case you need to publish the lat and long field in registry as well, although you can hide them using CSS.
  • Patterns selectors: define what pattern is used for the address fields. To define the patterns you need to go in the pattern manager in Geocode Factory 5. You can use 3 differents pattern if you use the multi-address feature.
  • Auto-fill address: If yes, this will display a checkbox (you can select if she's checked or not by default) in the frontend, that will allow the user to automatically fill the CB profile address fields from the map (if the user use the autocomplete box or pick a point on the map). And you also have the choice the write the address like '15, Station road' or 'Station road 15'. See the above special chapter.
  • Auto-fill address text: This option allows you the select the frontend text to display near the related checkbox.
  • Auto-geocode: If yes, this will display a checkbox (you can select if she's checked or not by default) in the frontend, that will allow the user to automatically geocode its position, based on the entered address. This geocode process is send after the click on the save button.
  • Auto-geocode text: This option allows you the select the frontend text to display near the related checkbox.

Note: with regard to the CB plugin structure, is not possible to place a map selector here, only a text input for the map ID.

Applies To

Geocode Factory 5