Installation

Install the module from Extensions > Install/Uninstall
Publish the module in Module Manager.
To display the map, insert the API Key of your site in module's parameters.
If you don't have an API Key, generate a new one from Google Maps site

How to display the module

The module can be displayed within the site as any other module, selecting an existing position in Position parameter.
It could be useful to insert the module also within an article or in a category's description, as in this exemple. To reach the same result:

• create a new menu item Category list Layout for example 'cat-contentmap'
• in Position parameter of the ContentMap module write a non existing position, i.e. mappa (this is a special selectbox, in this case you you don't need to choose, but you have to write in it)
• in Category ID parameter write the ID of the category
• Go to Content > Category manager, pick your category (for example 'cat-contentmap') and insert the next code into the description-html 

How to display the articles within the map

In Parameters (Advanced) of the articles, there's a parameter called Key Reference. Insert the geo coordinates of the article separated only by a comma and without blank spaces in this field, e.g. 41.895466,12.482324 . They corrisponding to Latitude and Longitude.
To find easily the geo coordinates, use the Geo tool of Turismo.eu
After saving the article, in the map will appear a marker.
Every article containing the coordinates within the Key Reference will appear in the map.

Here are some exemples of ContentMap:

• Hotel 5 stars in Italy (Category List Layout with ContentMap module within the category description)

Module's Parameters

API Key: in this parameter insert the API Key of your site. If you don't have an API Key, generate a new one from Google Maps site

Map's width: map's width in pixel (For exemple 700)

Map's height: map's height in pixel (For exemple 400)

Count: the number of Articles to display. The default is 150 and we suggest not to overcome it.

Ordering: you can choose to display the latest articles or the recently added

Authors: this parameter apply a filter by author, you can decide to display only articles written by you, all but you or all the articles independently from the author.

Article date: show or hide the creation date of the article

Marker colour: select the colour of the markers that appear in the map

In case of SEF activated: if you have SEF activated in your site and the module is published in a page reachable from a menu item of first or second level, it's necessary to choose 'Submenu item of first level with Sef activated' or 'Submenu item of second level with Sef activated.

Front Page Articles: show/hide Articles designated for the Front Page

Section ID: writing the ID of a specific section or more sections (separated by a comma), only article of this sections will be displayed.

Category ID: writing the ID of a specific category or more categories (separated by a comma), only article of this categories will be displayed.