Knowledge Base - Getting Started Guide

Plugin : Sobipro search

Introduction

tuto_illustr_searchplugin004

This plugin is an optional commercial add-on for Geocode Factory and is designed to display the Sobipro search results on a Geocode Factory map.

To display maps from Geocode Factory on Sobipro pages, you need to have the Geocode Factory’s module installed and published on the Sobipro directory pages where you want the map to display. It MUST, however, be published on the search page to show the search results..

Find the Geocode Factory's Sobipro search results plugin here.

Follow this guide to install and configure your Sobipro Search result map.

Installation

You also need to install the free Geocode Factory module which is included and installed with Geocode Factory component. This is what displays the Geocode Factory map in a module position. If you do not already have it installed you can install it in the same way as any other Joomla! module and it can be installed over the old version.

Now it’s time to install your new plugin. This plugin integrates with with SobiPro, but is a Joomla! plugin. So use the Joomla! installer to install it. Ensure it is enabled in the Joomla! Plugin Manager. There are no parameters to set as, all settings are in Geocode Factory component. You need just to publish the plugin.

Configuration

To use this plugin to generate a map displaying Sobipro search results you need two things:

  • Geocoded Sobipro entries
  • Map defined for this purpose
  • A marker set in Geocode Factory that is set up for Sobipro

It is configured in the map and marker set. To do this open the Geocode Factory component. Create a map with at least [map] defined with the template tuto_map_settings

Make sure that the cache option is set to “no cache” on the “Display Options” tab of the map settings.

tuto_cache-settings

In Geocode Factory, create a Sobipro markerset that shows all Sobipro entries and assign the markerset to the specified map.

tuto_markerset

Notes :

  • Instead creating new maps and markersets, you can use an existing map and Sobipro's markerset.
  • You will find how to create a map and marker sets in our documentation.
  • You can add more than one markerset (like user’s profiles markers) to the map and only the Sobipro data (markerset) will be filtered in the search results due to this Sobipro search plugin.
  • You can also configure additional filters in the markerset settings if desired.

Now you can display the map. Go to the module configuration for the Geocode Factory module. Edit the module and publish it in the desired module position on at least on the Sobipro search page. Make sure to select the map you configured for this purpose.

tuto_map_select

We can select the Sobipro functions that you do not want applied to this module. For the purpose of mapping Sobipro search results, we want to exclude the detailed Sobipro view by setting the 'Tasks To Hide' settings' to : pid=?. This is set by default so you should not have to change this.

Note : Another cool feature is that the module can already filter the Sobipro entries depending on the current Sobipro displayed category. For this edit the markerset that show the Sobipro entries, and set the ‘Auto-categories’ option to Yes.

FAQ

Do I need to create a dedicated link for the Sobipro search results?
No, the module just needs to be visible on the desired position. Of course you can publish it to a dedicated Sobipro Search menu link if desired, but it is not necessary you can use the built in Sobipro links.

Known issues

The plugin does not work with the Geocode Factory Component cache enabled. Use the No cache option in the map manager as described in the configuration above.

As Sobipro, the support of cookies is mandatory.

 

Applies To

Geocode Factory 3