OpenStreetMaps Osclass Plugin 1.6.2

age (hook), you may show only particular item on map or you may choose to show also related items on map with basic settings:

• locations of related items (same city/region/country)
• category of items (same category or not)

PUBLISH MAP​

From v1.2.0 it is possible to place map into publish/edit page and let visitors to locate item from map. Map is smart and will take into consideration following:

• on edit page will show marker on item's current location
• for logged-in users will locate map to user's predefined location
• for logged-out users will use html5 geocoding (visitor must enable) to find current user location

Please keep in mind that address retrieved from map is using OpenStreetMap Nominatim API (reversed geo coding) that in some cases has not ideal hierarchy of data and results may look weird. We recommend to test this before purchase as no support is provided on this api itself and cannot be improved from plugin side.

FULLSCREEN OSCLASS MAP​

In case map is smaller, it may be hard to browse all listings on it. Fullscreen mode enable visitors to enlarge map on fullscreen and use it's full screen size to browse listings on map. Note that on some themes or positions fullscreen mode may not work correctly (parent blocks has position absolute/relative attribute). This feature can be enabled or disabled from plugin settings.

NO EXTRA TABLES​

Plugin use original osclass tables to store all the information. All coordinates you get for your items will not be removed once plugin is uninstalled or removed.

EASY INITIAL SETUP​

When plugin is installed, it's recommended to run feeding of coordinates for existing items, as it's looping openstreetmaps api, it may take a while, however should be completed in minute for websites up to 5000 listings. For websites with more listings you may need to repeat feeding for several times.

CACHING OPENSTREETMAP DATA​

As OSM is free, it has limited resources and their API has usage policy to avoid interruption of service. In order to align to these rules plugin cache/log every single query from Nominatim OpenStreetMaps API, that means plugin will never ask twice for same coordinates.

CRON TO FILL MISSING COORDINATES​

As a lot of our customers has large classifieds with thousands of listings, we've created PHP script that can be run via cron and fill all the missing coordinates for you. OSM policy restrict usage of their API to just 1 query per second, that means it is possible to get 3600 unique coordinates per hour.

On configuration tab you may find details on how to setup cron for your website.

Important​

You may add 1 and only 1 map at same page. Plugin will not work with google maps (or any plugin using google service) so these must be disabled or uninstalled before using OpenStreetMaps Osclass Plugin. Map on home page is using latest_items loop, in case your theme is not using this one (as example Veronika theme), results on map may differ to those shown in your latest items section. Map will not work on search page with live / ajax search.