DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: Map Management¶

Author:	Kasper Skårhøj
Created:	2002-11-01T00:32:00
Changed by:	Markus Friedrich
Changed:	2012-05-31T10:35:53.250000000
Author:	Markus Friedrich
Email:	markus.friedrich@dkd.de
Info 3:
Info 4:

EXT: Map Management¶

Extension Key: ml_maps

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents¶

EXT: Map Management 1

Introduction 1

What does it do? 1

Screenshots 2

Users manual 2

Backend module 2

Creating page content 6

Adminstration 7

Change log 7

Introduction¶

What does it do?¶

ml_maps is an extension which allows to display maps containing e.g. locations. The locations can easily be added to the map and can be linked to a page which provides more information. Additionally a layer can be specified that opens up upon the cursor hovers over the location.

Features:

any maps or image in gif, jpg or png format
direct positioning of the points via mouse click
two default location markers and any own markers in gif, jpeg or png format
layers with info text for every single location
locations can contain links to any other page

NOTE : The current version is still based on the old code basis, we only fixed some issues with recent TYPO3 versions and added some minor features and improvements.

Please follow these steps, if you're updating from an older version:

Update database via Extension Manager

Clear cache, to ensure that the TypoScript updates will be considered

Adapt CSS, you have to use the class "tx-mlmaps-layer" instead of "marker-layer"

Screenshots¶

Here is an example:

Users manual¶

Backend module¶

If the extension is succesfully installed you will find “Maps” as a sub module in “Web”.

This module provides all functions needed to create maps and location points. There are two main functions

“Map Management” and “Marker Management.

“Map Management”¶

The first step to create a map is to upload an image, this image can be in gif, jpeg or png format. At first you'll see a summary of the available categories, you can list the contained maps by clicking on „Show“, but you can also add a new map from this initial point and allocate it to a category.

If you choose a listed category or add a map you will see the cateogory details. Here you can edit or delete the already uploaded maps and also upload new maps. Below you see the contained maps, by unchecking the „Display thumbnails“ checkbox you can disable the thumbs and increase the loading time.

Your possibilitiies are to edit the map's properties, to create a duplicate of a map and to delete maps by using the buttons below each map.

In the editing mode you will see the map in full size and below it all applied points.

Your possibilitiies are

Edit / Deletepoints
Place new point on map
Rename map
Change map image
Change map category / New category

Place new point on map / Change point on map

The methods to create a point (Place new point on map) and to edit a point (Change point on map) look the same. First you have to enter a label for this point.

Your next option is to create a link behind this point, you can use the wizzard to do this.

The coordinates are the most important fields, without this it's not possible to place the point. You can either insert the coordinates by hand or click on the map to get the coordinates.

The drop-down field “Marker” provides the opportunity to choose the kind of marker which will mark the point. By default there is a white and a black square, you can add your own markers with the “Marker Management” discribed later in this documentation.

The RTE field called “Layer text” enables you to create a popup layer for this point. The layer is like the link not necessary.

Rename Map

Simply enter a new description for this map and click on „Rename“ to change the map's name.

Change map image

This option is used to change the main image of this map, all settings and markers won't be changed. You're allowed to upload gif, jpeg or png files.

Change map category / New category

Use this menu to move this map with all settings to another category, you can choose an existing category or create a new one by entering a new name.

“Marker Management”¶

It is posible to upload your own markers and to delete existing ones.

Available markers are listed below.

Creating page content¶

To place map you created in the map module on a page, simply create a new page content element and choose „Maps“ in the plugins list.

Then select the map you want to display.

You can style the generated content via CSS, e.g. you can design the layers via

.tx-mlmaps-layer {color: FFFFFF;background-color: FFFFFF;}

Adminstration¶

Before the extension can be installed the database needs to be updated, the database entries for the default markers have to be created. The Extension Manager will do this for you by default.

Then you can configure the extension in the Extension Manager. A change of these options isn't required, the extension will work with the default settings.

Change log¶

Version 0.1.0:

First public release.

Version 0.1.1:

revised manual
general improvements
hidden pages will not be linked

Version 0.2.0:

reversal to flexforms
removed the creation of data records via TYPO3 e.g. locations, to prevent mistakes
bugfixing

Version 0.3.11:

support for TYPO3 4.6
requires TYPO3 4.1
JS library improved
new marker types: tt_address, maps address
fixed/improved support for general storage folder
new TypoScript options (see constant editor „plugin.tx_mlmaps“)

EXT: Map Management - 7