JOOMLA! 6 JOOMLA! 5
FREE PRO

2 Click OpenStreetMap - Joomla! Plugin - Logo Name: 2 Click OpenStreetMap (2COSM)
Version: 6.1.0.0 (PRO/FREE - Joomla! 6) / 5.0.2.1-PRO (Joomla! 5)
Type: Plugin
License: GPLv3
Description: With this plugin, you can add OpenStreetMap easily and privacy-friendly into your Joomla articles using a simple syntax!
Download: 2COSM - 2 Click OpenStreetMap Downloads

Privacy-friendly integration of maps provided by OpenStreetMap in Joomla! articles

With this plugin, you can add OpenStreetMap easily and privacy-friendly into your Joomla articles using a simple syntax!

Maps are replaced by a preview image with a play button and loaded once the user has clicked on the button. No data is transferred to OpenStreetMap without the consent of the user.

Features

  • Adds maps from OpenStreetMap privacy-friendly and easily in Joomla! articles
  • Protects the privacy of your visitors - data is only transferred after a click
  • Improves loading performance - content is only loaded after a click
  • Easy to use syntax - {map}URL{/map}
  • You may set a custom preview image of the map directly in the syntax

Installation

Install 2 Click OpenStreetMap with the help of the Installer component as usual. Then activate the plugin in System -> Plugins -> Content - 2 Click OpenStreetMap.

The syntax {map}IFRAME-LINK{/map} triggers the plugin execution in articles. The ID is the link of the embed iframe (src attribute).

Where to find the link of the map iframe?

Select your map detail on openstreetmap.org, select the "Share" button, then the tab "HTML", copy the entire iframe code and extract the content of the src attribute (starts with https://www.openstreetmap.org/export/embed.html?bbox=x - x contains the required coordinates and layer information).

Use the entire embed URL with the {map} syntax where you want to add the map. You can also use the syntax in an HTML module if the "Prepare content" option is enabled.

You may set four additional options directly in the syntax for the specified map source. The first option is the map iframe src attribute, the second is a custom image, the third is the width, the fourth is the height of the map, and the fifth is a title used as a title tag to improve accessibility.

Examples of how you can use the plugin in the content component:

{map}https://www.openstreetmap.org/export/embed.html?bbox=x{/map}
{map}https://www.openstreetmap.org/export/embed.html?bbox=x|images/custom-image.jpg{/map}
{map}https://www.openstreetmap.org/export/embed.html?bbox=x|images/custom-image.jpg|600|400{/map}
{map}https://www.openstreetmap.org/export/embed.html?bbox=x||800|600{/map}
{map}https://www.openstreetmap.org/export/embed.html?bbox=x||||Title of the map{/map}

2 Click OpenStreetMap - Preview image

2 Click OpenStreetMap - Preview image

Changelog

+ = Added - ! = Removed - ^ = Changed - # = Fixed

Latest release

Version 6.1.0.0-PRO - 2026-07-22

  • + Added the first official Free edition of 2 Click OpenStreetMap for Joomla! 6. Version 6.1.0.0 is released simultaneously as Pro and Free edition. The Free edition provides a fully functional privacy-friendly OpenStreetMap solution with a carefully selected feature set.
  • + Added seamless upgrades from Free to Pro. The Pro package can be installed directly over an existing Free installation without uninstalling it first. Existing plugin settings are preserved automatically.
  • + Added locked previews for Pro-only options in the Free edition. Advanced privacy, design and convenience features remain visible directly in the configuration.
  • + Added the following functionality to both Free and Pro:
    • Privacy-friendly click-to-load OpenStreetMap embeds.
    • Plugin syntax with individual settings for each map.
    • Custom preview images and bundled default preview image.
    • Responsive maps with configurable width and height.
    • Optional privacy notice before loading OpenStreetMap.
    • Unlimited maps per page.
    • Lightweight vanilla JavaScript frontend without jQuery.
  • + Pro additionally includes the complete advanced 2 Click OpenStreetMap feature set:
    • Remember user consent for future visits.
    • Automatically load all maps after consent.
    • Custom privacy notice with HTML support.
    • Custom button labels and button colours.
    • Custom CSS classes for wrapper and iframe.
    • Direct “Open in OpenStreetMap” links.
  • ^ Introduced the new shared Pro and Free architecture. Pro remains the complete edition, while the Free package is generated from the same codebase so that both editions can evolve together.
  • ^ Updated the version to 6.1.0.0 to mark the introduction of the new Free and Pro edition structure. All existing Pro functionality from version 6.0.0.1-PRO remains available without breaking changes.
  • ^ Modernized the frontend implementation. The JavaScript frontend has been migrated completely to vanilla JavaScript and no longer depends on jQuery.
  • ^ Improved edition-specific configuration and feature handling. The Free edition focuses on privacy-friendly click-to-load functionality, while advanced consent handling, customization and convenience features remain exclusive to the Pro edition.

Download

Overview of all downloads of the extension: 2COSM - 2 Click OpenStreetMap Downloads