rkTwoClickMaps - Joomla Module

 

Description and features

A simple two-click Google Maps module to comply with the 2018 EU GDPR Laws.

  • for Joomla 3.x and Joomla 4.x
  • multi language
  • compatible with PHP 8
  • Setup for frontend and backend
  • use two-click or show map directly
  • comply with the 2018 EU GDPR Laws
  • Responsive design
  • optimized for mobile devices
  • Google Api included
  • You can create your own place card
  • Selection of different map layouts
  • Google Maps are not loaded until the user accepts the privacy policy
  • you can choose and show a placeholder map / image instead
  • custom css-class

 

Version

Current: 1.0

 

Change Log

v1.0

  • added placecard
  • added languagefiles (de-DE and en-GB)
  • bug fixing


v0.9

  • new design


v0.8

  • implemented google Maps JS API
  • configuration options added
  • addresses are being resolved using google geocoder

 

Screens

 

Backend settings

 

Placeholder image - no Google Map is loaded.

 

After the user accepted to show the map

 

Documentation

A simple two-click Google Maps module to comply with the 2018 GDPR Laws.
Services like Google Maps require saving certain user data. Since 2018 this requires explicit consent of the user.
This Module prevents the Service from loading (and thus from saving user data) until the user approves.

A short text informs the user about this. At this point reference to the Privacy Policy is made.

The corresponding texts are located in the language files under /"Joomla root"/languages/ and can be edited if needed.
Further a link to your Pricacy Policy must be given and pointed out. The linktype and -destination of your Pricacy Policy must be given under "Privacy Policy Link".

An Google API key is needed for displaying the Map. You can generate one on https://console.developers.google.com:
Create a new Project for your Website and navigate to "APIs & Services". Choose "Credentials" and click "Create Credentials" and select "API key".
You will be shown your API key of containing upper- and lowercase letters aswell as special characters. Copy this code.
Navigate to "API Library". To guarantee the correct functionality it is required to activate "Maps JavaScript API" aswell as "Geocoding API" for your key.
Now enter your code in the field "Your API key" in the settings of this module. 

 

Settings explained

Use 'two click'

This lets you choose between normally showing the map and hiding it behind a confirmation button.

Width of the Map

Choose the width of the map. You should provide a unit like pixels or percentage.

Height of the Map

Choose the height of the map. You should provide a unit like pixels or percentage.

Height on mobile devices

Choose the height of the map on mobile devices. You should provide a unit like pixels or percentage.

Custom CSS Class

You can add custom css classes to the objects for styling. These classes will be added to the container, the button, the text and the link.

Privacy Policy type

Choose how your privacy policy should be linked. Choosing 'Joomla' you can provide a menu entry, choosing 'External' you can provide any URL.

Privacy Policy Site / Privacy Policy Link

See Privacy Policy above.

Background image

Pick what image should be used as background before showing the map. The image must be available in the Joomla! media manager.

Your API Key

An Google API key is needed for displaying the Map. You can generate one on https://console.developers.google.com:
Create a new Project for your Website and navigate to "APIs & Services". Choose "Credentials" and click "Create Credentials" and select "API key".
You will be shown your API key of containing upper- and lowercase letters aswell as special characters. Copy this code.
Navigate to "API Library". To guarantee the correct functionality it is required to activate "Maps JavaScript API" aswell as "Geocoding API" for your key.

Address for the Marker

The address to center the map to and place a red marker.

Map Zoom

Adjust this value if you want to zoom in or out on the map.

Map Type

Pick the style of the map. You can choose between 'Road Map', 'Satellite image', 'Terrain map' and a hybrid between road- and satellite-map.

Display a Place Card

Choose whether to show a place card. The place card shows certain information like a name and an address. It also shows buttons to view directions and a larger map.

Name of Location

The Name of the Location to be shown on the place card.

 

Use of custom css-class

p.rk-testclass {
  background-color: red !important;
}

a.rk-testclass {
  color: #fff !important;
}

button.rk-testclass {
  color: red !important;
}

 

Setup your own texts

How to setup Language Overrides in Joomla go to https://docs.joomla.org/J3.x:Language_Overrides_in_Joomla 

Placeholder texts for the frontend:

  • MOD_TWOCLICKMAP_BTN
  • MOD_TWOCLICKMAP_INFO
  • MOD_TWOCLICKMAP_LINK 

 

 

Download

Size: 188 KB

 

Price

3.90 €uro

Buy Now
 
 
All payments are handled securely by PayPal