Skip to content
Switch branches/tags

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time



Openstreetmap Modul

Attention, this extension is not compatible with plg_fields_agosmmapwithmarker. The two extensions can be installed together. They may not be displayed on one page at the same time.



AGOSM Module

  1. Install this package via Joomla! installer. Please check after the installation if the module is correcly installed. Open the menu Extension | Modules and click the toolbar button new. In the appearing list should be the entry AGOSM Module.


  1. Create the module Click the entry AGOSM Module. In the appearing form you have to enter at least the title and the position. And you have to select in the tab menu assignment on which menu items the map should be displayed.


  1. Check your map in the front end If you set one standard pin in the tab special pin configuration your map will look like in the next image.



Routing to address - How to find us

A popular feature of this extension is 'Routing to address'.

  1. Fill the information in the tabulator 'Routing to address'.


  1. In front end you see a text field

If you enter a address in the text field in the front end and click enter you see a route to the address you entered in the back end.


  1. If you activate the option suggestions, you will see a Algolia Places autocompletion menu.


Routing with Mapbox

You will find the option to enable MapBox Routing in the backend. For this you need a key.


If you activate the option you will see a collapsed control. When you roll your mouse over the controller, it opens.


To select starting point and destination point you have several options. See following picture. Thank you for the hint with the buttons to jojo


The result after clicking on Return should look something like this.


Show markers on a map that link to an article - you can enter the coordinate in a Custom Field

Custom Field of the type text

The next picture shows what the map might look like. If the markers are too close together, they will be clustered. If the resolution of the card fits, the marker will be displayed. A click on the marker opens a popup. In this popup there is a link to the post - link text is the title of the article.


Do you want to display a marker on a map that contains a link to an article? Then create a Custom Field of the type text titled lat, lon. Be sure to write the title in the same way - the space after the comma is important. Any article with the custom field filled with a correct coordinate will be displayed on the map.

Articles  Fields   test   Administration

If you want to use different colors or icons, you can fill the custom field with the title lat, lon as follows: lat,lon,markercolor,iconcolor,icon. As color, you can choose red, darkred, orange, green, darkgreen, blue, purple, darkpurple and cardetblue. For the icon you can choose the name of the Font Awesome Icon. For more informations see

When you enter 50.150, 7.158, red, green, home you will see an icon as shown in the next picture.

Custom Marker

Custom Field agosmsmarker and agosmsaddressmarker

Instead of the text fields, there are now two special custom fields where you can choose all options more user friendly.


Create the Custom field agosmmarker


Fill the Custom Field agosmsmarker while editing an article. You can choose many options, but you need to know the correct coordinates.



The Custom Field agosmsaddressmarker calculates the coordinates for a given address. For this you need another Custom Field whitch contains the address.


Fill the Custom Field agosmsaddressmarker while editing an article. You do not need the full address. You can enter only the name of the city if you want a marker in the center of a city.


Options common to all custom fields

The next picture shows where you can activate the option in the module.

Modules  AGOSM Module   test   Administration

Maybe you do not want to show the field lat lon in the frontend. Just select the option Do not automatically display in the Custom Field options.

Beiträge  Feld bearbeiten   Administration

GPX - Fileupload

Please choose the layout upload if you want to allow a user to upload a GPX file to the server and view it on the map.

Module  AGOSM Modul Administration

AGOSM Search Module


  1. Open the component via Components | Agosms and click the toolbar button new.


  1. Create one entry. At least you have to fill the title and the coordinates in the tab Module Agosms - Marker Options


  1. Go back to the module and set the option show pins from component to yes.


  1. Adjust the map In the tab Map configuration you can set the zoom (Can be overridden by other functions - such as grouping or routing) and the coordinates that should be shown.



All parts of this extension

Module: Fields - Agosm

It is the main part of this extension.

Component - Agosms

The Component is used for showing a view for selecting the coordinates.


What is OpenStreetMap?

OpenStreetMap (OSM) is a collaborative project to create a free editable map of the world. Rather than the map itself, the data generated by the project and saved in a datase is considered its primary output.

What if the Google Map is not shown

Perhaps your key is not valid? In this case you see the Error "Google Maps JavaScript API error: InvalidKeyMapError" in the web console.

If the restrictions of your key to restricte, you see the message "Google Maps JavaScript API error: RefererNotAllowedMapError". You can change the restrictions here.

Markers are not at the correct position

If the shift does not change in relation to the map scale; it is always the same pixel value. Please check if the problem also exists with the standard template Protostar or Cassiopeia.

Google Maps JavaScript API error: RefererNotAllowedMapError



GNU General Public License v3.0

How you can help

Enjoying Gatsby Starter bonsai.css and want to help? You can:


This project follows the all-contributors specification. Contributions of any kind welcome!

Support and New Features

This Joomla! Extension is a simple feature. But it is most likely, that your requirements are already covered or require very little adaptation.

If you have more complex requirements, need new features or just need some support, I am open to doing paid custom work and support around this Joomla! Extension.

Contact me and we'll sort this out!


Joomla Module not only for showing Markers on a OpenStreetMap Map.




No packages published