.. You may want to use the usual include line. Uncomment and adjust the path.
.. include:: ../Includes.txt
============
EXT: WEC Map
============
:Author:
Kasper Skårhøj
:Created:
2002-11-01T00:32:00
:Changed:
2017-01-06T00:05:13.960000000
:Author:
Jan Bartels
:Email:
j.bartels@arcor.de
:Info 3:
:Info 4:
EXT: WEC Map
Extension Key: **wec\_map**
Copyright 2009-2010, Christian Technology Ministries International
Inc. `http://www.CTMIinc.org `_
Author: Web Empowered Church Team, < `map@webempoweredchurch.org
`_ > (2009-2010)
Jan Bartels, (2011-2015)
Support: http://forge.typo3.org/projects/extension-wec\_map
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
.. _generated:
((generated))
=============
.. _Table-of-Contents:
Table of Contents
-----------------
**`Introduction <#__RefHeading__12808_1279719766>`_ `3
<#__RefHeading__12808_1279719766>`_**
**`A. Welcome <#__RefHeading__12810_1279719766>`_ `3
<#__RefHeading__12810_1279719766>`_**
`What is the Web-Empowered Church? <#__RefHeading__12812_1279719766>`_
`3 <#__RefHeading__12812_1279719766>`_
**`B. About this Manual <#__RefHeading__12814_1279719766>`_ `3
<#__RefHeading__12814_1279719766>`_**
**`C. How to Use this Manual <#__RefHeading__12816_1279719766>`_ `3
<#__RefHeading__12816_1279719766>`_**
**`Overview <#__RefHeading__12818_1279719766>`_ `4
<#__RefHeading__12818_1279719766>`_**
**`A. What does it do? <#__RefHeading__12820_1279719766>`_ `4
<#__RefHeading__12820_1279719766>`_**
**`B. Screenshots <#__RefHeading__12822_1279719766>`_ `4
<#__RefHeading__12822_1279719766>`_**
**`Installation <#__RefHeading__12824_1279719766>`_ `5
<#__RefHeading__12824_1279719766>`_**
**`Step 1: Import and Install the wec\_map Extension
<#__RefHeading__12826_1279719766>`_ `6
<#__RefHeading__12826_1279719766>`_**
**`Step 2: Add the WEC Map Static Templates
<#__RefHeading__12828_1279719766>`_ `6
<#__RefHeading__12828_1279719766>`_**
**`Step 3: Add the WEC Map Plugin to a Page
<#__RefHeading__12830_1279719766>`_ `8
<#__RefHeading__12830_1279719766>`_**
**`Upgrade Instructions <#__RefHeading__12832_1279719766>`_ `9
<#__RefHeading__12832_1279719766>`_**
**`Configuration <#__RefHeading__12846_1279719766>`_ `9
<#__RefHeading__12846_1279719766>`_**
**`Configuring the WEC Simple Map Plugin
<#__RefHeading__12848_1279719766>`_ `9
<#__RefHeading__12848_1279719766>`_**
**`Configuring the WEC Frontend User Map Plugin
<#__RefHeading__12850_1279719766>`_ `13
<#__RefHeading__12850_1279719766>`_**
**`Configuring the WEC Table Map Plugin
<#__RefHeading__12852_1279719766>`_ `15
<#__RefHeading__12852_1279719766>`_**
**`Advanced Configuration with TypoScript
<#__RefHeading__12854_1279719766>`_ `17
<#__RefHeading__12854_1279719766>`_**
`Simple Map TypoScript Reference <#__RefHeading__12856_1279719766>`_
`19 <#__RefHeading__12856_1279719766>`_
`FE User Map TypoScript Reference <#__RefHeading__12858_1279719766>`_
`21 <#__RefHeading__12858_1279719766>`_
`Table Map TypoScript Reference <#__RefHeading__12860_1279719766>`_
`23 <#__RefHeading__12860_1279719766>`_
**`Customizing the info bubble <#__RefHeading__12862_1279719766>`_ `26
<#__RefHeading__12862_1279719766>`_**
**`Customizing a Table map <#__RefHeading__4984_1827206915>`_ `27
<#__RefHeading__4984_1827206915>`_**
**`Customizing a PDF-view <#__RefHeading__12864_1279719766>`_ `28
<#__RefHeading__12864_1279719766>`_**
**`Troubleshooting <#__RefHeading__12866_1279719766>`_ `29
<#__RefHeading__12866_1279719766>`_**
**`Administration <#__RefHeading__12868_1279719766>`_ `29
<#__RefHeading__12868_1279719766>`_**
`WEC Map Admin Module <#__RefHeading__12870_1279719766>`_ `30
<#__RefHeading__12870_1279719766>`_
`FE User Map Module <#__RefHeading__12872_1279719766>`_ `30
<#__RefHeading__12872_1279719766>`_
**`Using the WEC Map API <#__RefHeading__12874_1279719766>`_ `32
<#__RefHeading__12874_1279719766>`_**
**`Create the Map Object <#__RefHeading__12876_1279719766>`_ `32
<#__RefHeading__12876_1279719766>`_**
**`Map Object Reference <#__RefHeading__12878_1279719766>`_ `32
<#__RefHeading__12878_1279719766>`_**
**`Marker Object Reference <#__RefHeading__12880_1279719766>`_ `33
<#__RefHeading__12880_1279719766>`_**
**`Create Markers <#__RefHeading__12882_1279719766>`_ `34
<#__RefHeading__12882_1279719766>`_**
`Available methods <#__RefHeading__12884_1279719766>`_ `34
<#__RefHeading__12884_1279719766>`_
`Marker Manager <#__RefHeading__12886_1279719766>`_ `40
<#__RefHeading__12886_1279719766>`_
**`Hooks <#__RefHeading__12888_1279719766>`_ `40
<#__RefHeading__12888_1279719766>`_**
`WEC Table Map Marker Hook <#__RefHeading__12890_1279719766>`_ `40
<#__RefHeading__12890_1279719766>`_
`WEC Map API Center and Zoom Hook <#__RefHeading__12892_1279719766>`_
`41 <#__RefHeading__12892_1279719766>`_
**`Drawing the Map <#__RefHeading__12894_1279719766>`_ `41
<#__RefHeading__12894_1279719766>`_**
**`Change Log <#__RefHeading__12896_1279719766>`_ `41
<#__RefHeading__12896_1279719766>`_**
.. _Introduction:
Introduction
============
.. _A-Welcome:
A. Welcome
----------
Welcome to the adventure of doing ministry through technology!
This manual is written for those who are interested in using Web-
Empowered Church (WEC) technology and enhancing their website through
the use of the WEC Map extension. The WEC Maps extension has been
designed to provide churches and ministries an opportunity to display
maps on their website...maps to the church, maps to events, even maps
that show how many members live in the surrounding towns.
.. _What-is-the-Web-Empowered-Church:
What is the Web-Empowered Church?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The Web-Empowered Church (WEC) is a ministry of Christian Technology
Ministries International (www.CTMIinc.org). The mission of WEC is to
innovatively apply WEB technology to EMPOWER the worldwide CHURCH for
ministry.
WEC helps churches around the world expand evangelism, discipleship,
and care through the innovative application of internet technology.
WEC web-based tools and training will help make church ministries more
efficient and effective, and will extend ministry impact to a world in
need of Jesus ( `www.webempoweredchurch.org/Jesus
`_ ). We want to fuel a
worldwide movement using the internet to point the world to Jesus
Christ, to grow disciples, and to care for those in need. Our desire
is to use the web to empower the Church to become a truly twenty-four
hours a day, seven days a week ministry that is not constrained by
walls or distance or time.
If you would like to find out more about WEC or our tools, or support
us in any way, please go to our websites:
for users: `www.webempoweredchurch.com
`_
for developers: `www.webempoweredchurch.org
`_ .
.. _B-About-this-Manual:
B. About this Manual
--------------------
This guide is organized into four main sections:
**Overview:** What the WEC Map extension does, how it works, and what
you can expect from the rest of the manual.
**Installation:** How to install the WEC Map extension and how to get
it running on your website.
**Configuration:** How to configure the WEC Map extension and plugins
for maximum impact on your website.
**Advanced:** How to modify the extension through TypoScript and other
advanced functions.
Please note: not all screenshots have been updated yet.
.. _C-How-to-Use-this-Manual:
C. How to Use this Manual
-------------------------
✔ To help make sense of the material on the following pages, we’ve
used a few icons in the margin to highlight certain information.
**T |img-1| ip** : Tips are bits of information that are good to know.
They may offer shortcuts to save you time or even make your website
better.
**N |img-2| ote** : These notes are similar to tips, but usually
contain information you should pay attention to. It might be details
about a step that a whole operation hinges on or it may highlight an
essential sequence of tasks.
**C |img-3| aution** : These notes draw your attention to things that
can interrupt your service or website if not done correctly. Some
actions can be difficult to undo.
**T |img-4| echnical Stuff** : These notes will explain how stuff
works. If you want to know why certain steps are necessary or are just
looking for a fuller explanation, these notes should help answer your
questions.
**I |img-5| nternet Link** : These links will guide you to a website
page that will demonstrate How-To do something or link you to more
advanced information on the `http://webempoweredchurch.com
`_ or `http://typo3.org
`_ websites.
.. _Overview:
Overview
========
.. _A-What-does-it-do:
A. What does it do?
-------------------
The Web-Empowered Church Map Extension provides an interface for
placing maps from Google on a TYPO3-based website. There are two
actual plugins provided with the WEC Map extension.
**The Simple Map Plugin** allows you to show a single address, such as
your church address, on a Google map. See Illustration 1. However, by
adding TypoScript to configure the WEC Map extension, you can add
multiple addresses and multiple markers (see `Marker Manager
<#7.3.2.Marker%20Manager|outline>`_ ).
**The Frontend Users Map Plugin** allows you to show multiple
locations on a map. These locations are drawn from a list of Frontend
Users and can be limited to a particular Frontend Users Group. See
Illustration 2. This provides you with the opportunity to map the
location of off-site small groups, multiple site campuses, or even
member addresses. A security option is available so that names and
addresses can be hidden if desired. When the security option is
enabled, only the city, state, and country for each user is located on
the map to hide the specific locations of Frontend User addresses.
.. _B-Screenshots:
B. Screenshots
--------------
|img-6| **Illustration 1: Simple Map**
|img-7| **Illustration 2: Frontend Users Map**
|img-8| **Illustration 3: Table Map**
.. _Installation:
Installation
============
There are four steps necessary to install the WEC Map extension and
plugin onto your website. These steps include:
Importing and installing the WEC Map extension.
Adding the WEC Map Static Templates to your page template.
Adding the WEC Map plugin to a web page.
.. _Step-1-Import-and-Install-the-wec-map-Extension:
Step 1: Import and Install the wec\_map Extension
-------------------------------------------------
To import and install the WEC Map extension, you must be logged in to
your website's TYPO3 Backend and have administrative privileges.
Full instructions for uploading and installing extensions can be found
in the How-To located on the Web-Empowered Church website:
`http://webempoweredchurch.com/support/howtos/
`_ . (Use **wec\_map**
in your repository search).
|img-9| **wec\_map** uses additional JavaScript-libraries that cannot
be included because of license reasons. If you want to host these
files on your own server, you can download them optionally. Go to the
**WEC Map Admin** -module, select “Download JS-Files” and click on
“Download”.
|img-10| Go to the Extension Manager, select **wec\_map** . Activate
“Use downloaded JS-files from Google...”.
If you don't use this option, the files are includes from their
original source.
.. _Step-2-Add-the-WEC-Map-Static-Templates:
Step 2: Add the WEC Map Static Templates
----------------------------------------
I
|img-11| **Illustration 4: Adding the WEC Map Static Template 1**
n order for the WEC Map extension to display, the WEC Map Static Template should be added to the page template where the Map extension is installed. For most websites, this will mean adding the Static Template to the Root Page; however, if you have created a unique page template for the map page, you may need to add the Static Template there instead. Refer to Illustration 8. Using the **Template Module** ( **1** ),
click on the page where the page template is located--typically, the
**Root** page ( **2** ). In the far right drop-down box, select
**Info/Modify** ( **3** ). Click the **Click here to edit the whole
template record** link ( **4** ).
R
|img-12| **Illustration 5: Choose the Static Template/s**
efer to Illustration 9. Click on the **Includes** tab ( **5** ). In the **Include Static** field, scroll down the **Items** list and select any or all of the Map's Static Templates: **WEC Table Map, WEC Frontend User Map,** and/or **WEC Simple Map** ( **6** ) *depending on the plugin(s) you intend to use.* Save and close the form.
.. _Step-3-Add-the-WEC-Map-Plugin-to-a-Page:
Step 3: Add the WEC Map Plugin to a Page
----------------------------------------
The WEC Map extension can be added to any page as a standard
**Content Element** . However, at this time there can only be one
instance of the Map plugin on any single page. If you need to show
multiple maps we suggest adding additional pages with one map per
page.
To add the WEC Map plugin to a page:
Refer to Illustration 10. Using the **Page Module** ( **1** ), select
the page from the **page tree** where you'd like to place the map (
|img-13| **Illustration 6: Adding the WEC Map Plugin to a Page**
**2** ). Add a **Content Element** in the Content Container of your choice (
**3** ).
**Tip:** You can add the WEC Map plugin, or any Content Element to a
Content Container by selecting the Create New Element icon These icons
will appear wherever you are allowed to add content such as images,
text, or additional plugins. |img-1| |img-14|
|img-15| **Illustration 7: Selecting the WEC Map Plugin**
Refer to Illustration 11. Scroll down the content form and select
which of the three WEC Map plugins you'd like to use ( **4** ).
This will complete the installation of the WEC Map plugin on your
page. The WEC Map FlexForm that will appear corresponds to either the
`WEC Simple Map Configuration
<#4.1.Configuring%20the%20Simple%20Map%20Plugin|outline>`_ or the `WEC
Frontend User Map Configuration
<#4.2.Configuring%20the%20Frontend%20User%20Map%20Plugin|outline>`_ .
.. _Upgrade-Instructions:
Upgrade Instructions
====================
wec\_map V3 supports the Google Maps API V3 that differs in many
details from the API V2. wec\_map tries to hide these changes as much
as possible. Most TypoScript, PHP- and JavaScript-code of other
extensions like cal is running without any changes.
Nevertheless, if you are upgrading wec\_map from V2.x to V3.x you have
to follow some additional steps:
Optionally download additional JavaScript libraries using the WEC Map
Admin-module.
Check constants in the extension manager.
Exclude JavaScript-Files from being compressed if you are using a
script-compressor.
Test wec\_map.
.. _Configuration:
Configuration
=============
Once you've installed one of the plugins on your page, you will need
to configure the plugin so that it will display the map of your
choice. Skip to the instructions that correspond to the WEC Map plugin
installed on your page.
.. _Configuring-the-WEC-Simple-Map-Plugin:
Configuring the WEC Simple Map Plugin
-------------------------------------
The WEC Simple Map plugin is used to display a single location on the
map such as your church or ministry address. To configure the plugin,
use the **Page Module** and select the page where you've installed
the plugin. Then click the Edit Icon (the pencil) associated with the
WEC Simple Map plugin. This will open the plugin's FlexForm.
**T |img-1| ip:** When working with a plugin, the **General Tab**
contains a number of generic fields. it is generally helpful to write
the plugin's name or some other descriptive title in the **Header**
field ( **1** ). This makes it easier to select which plugin you want
to edit when a page contains multiple **Plugin Content Elements** . To
prevent the header from displaying on the page, change the **Header
Type** to **Hidden** ( **2** ).
Refer to Illustration 12. Note that there are three Tabs in the
Flexform. The first tab, labeled Address prompts you for a description
of the address to be mapped, as well as the address
|img-16| **Illustration 8: Configuring the Plugin's General Tab**
itself. It will also show the status of finding the coordinates for the address entered (geocoding) at the end.
R
|img-17| **Illustration 9: The Simple Map Display Tab**
efer to Illustration 13. The second tab, labeled “Map Details,” requests display information about the map, such as the height and width.One of the enhanced features of the Map extension is that if you enable the **Show Directions Tab** , Frontend users will have the option to be given directions to and from the location shown on the map. In addition, if they are a registered Frontend user and have logged in, if you have enabled the **Prefill Address from User Info** , their address will be automatically applied to the directions fields and the user can immediately click for Directions To or From the mapped location.
**Caution:** In order for the marker balloon information to be
visible, avoid setting the height value at less than 400 pixels.
|img-3|
|img-18| **Illustration 10: The Simple Map Controls Tab**
Refer to Illustration 14. The third tab, labeled “Map Controls,”
allows you to specify which map controls should be shown on the map.
Options include the size of the map controls (pan and zoom) if any,
whether an overview map is desired, whether a scale should be
included, and the map type selection control (satellite, political, or
a hybrid of the two). See Illustration 15 for a visual description of
these controls.
After saving this form and viewing its
|img-19| **Illustration 11: Map Controls**
page in the Frontend, a map will be generated similar to `Illustration 1 <#Simple%20Map%20Screenshot|graphic>`_ , depending on the Map Controls you have chosen to display.
Configuring the WEC Frontend User Map Plugin
--------------------------------------------
The WEC Frontend User Map plugin is used to display a map of all users
or all users belonging to one or more Frontend Users Groups. To open
the plugin, use the **Page Module** and select the page where you've
installed the plugin. Then click the Edit Icon (the pencil) associated
with the WEC Frontend User Map plugin. This will open the plugin's
FlexForm.
**T |img-1| ip:** When working with a plugin, it is generally helpful
to write the plugin's name or a descriptive title in the **Header**
field (under the **General** tab). This makes it easier to select
which plugin you want to edit when a page contains multiple **Plugin
Content Elements** . To prevent the header from displaying on the
page, change the **Header Type** to **Hidden** .
Refer to Illustration 16.
|img-20| **Illustration 12: The Frontend User Map Details Tab**
Note that there are two tabs The first tab, labeled “Map Details” prompts you for the following:
**Width and Height:** The default size of the Frontend map is 500px by
500px. You can change the map size to suit the look and feel of your
website here. In order for the marker balloon information to be
visible in the Frontend, avoid setting the height value below 400
pixels.
-
- **S**
**|img-21| **Illustration 13: Frontend Users Map With and Without
Sensitive Geocoding****
ensitive geocode (no address): Checking this box prevents the map markers from displaying at the precise location of the user address and hides the detailed address information. Instead, Frontend users are shown by city, state, and country; and multiple users in the same city are totaled. (See Illustration 17 for examples of each.)
- **Initial Map Type:** Specifies which map type to show initially.
“Normal” will show the street map (default), Satellite will show
satellite images, and Hybrid will show satellite images with streets
overlayed.
- **Show Written Directions:** Displays an addition tab in the marker
popup with two forms to get direction from or to the current location
via maps.google.com. Directions are disabled if “Sensitive geocode” is
enabled above, no matter the setting here.
- **Show Radius Search:** Displays a Search form that, when completed,
will display all markers within a specified radius (10–250 miles) of a
user-supplied address. The appropriate markers are listed in the
sidebar. When clicked in the list, they open the marker.
- **Show Marker Sidebar:** Displays the usernames as links to the
markers of those in the FE user groups that you've selected.
- **Prefill Address from User Info:** If directions are enabled, this
will automatically fill in a logged in FE user's address information
into the directions form.
- **Filter by FE user group:** This is the key component to the Frontend
Users Map plugin. Select the Frontend User Group(s) you would like to
include on your map. You may create custom Users and User Groups as
necessary to display the locations of a multi-site campus, locations
of local churches, small groups, etc. (For information on how to add
Frontend Users, see `www.webempoweredchurch.com/support/howtos/
`_ ).
- **Startingpoint:** Select the pages/folders where FE user groups are
stored. Typically, this would be the site's main Storage Folder, but
you choose different or additional folders as desired.
**Map Controls Tab.** R
|img-22| **Illustration 14: Frontend User Map Controls Tab**
efer to Illustration 18. The third tab, labeled “Map Controls,” allows you to specify which map controls should be shown on the map. Options include the size of the map controls (pan and zoom) if any, whether an overview map is desired, whether a scale should be included, and the map type selection control (satellite, political, or a hybrid of the two). See `Illustration 15 <#Map%20Controls|graphic>`_ for a visual description of these controls.
After saving this form and viewing its page in the Frontend, a map
will be generated in a similar to `Illustration 2, depending on the
Map Controls you have chosen to display.
<#Frontend%20Users%20Map%20Screenshot|graphic>`_
.. _Configuring-the-WEC-Table-Map-Plugin:
Configuring the WEC Table Map Plugin
------------------------------------
The WEC Table Map plugin is used to display a map of all users or all
users or locations associated with specified tables such as the
Calendar Base locations table, etc. To open the plugin, use the
**Page Module** and select the page where you've installed the plugin.
Then click the Edit Icon (the pencil) associated with the WEC Table
map plugin. This will open the plugin's FlexForm.
**Tip:** When wo |img-1| rking with a plugin, it is generally helpful
to write the plugin's name or a descriptive title in the **Header**
field (under the **General** tab). This makes it easier to select
which plugin you want to edit when a page contains multiple **Plugin
Content Elements** . To prevent the header from displaying on the
page, change the **Header Type** to **Hidden** .
|img-23| **Illustration 15: Configuring the Table Map's Address Tab**
Refer to Illustration 19. Note that there are three tabs The first
tab, labeled “Address” prompts you for the following:
- **Tables to map data from:** The items in this list are auto-generated
from any extension that has the WEC Map extension enabled. Click on a
table to highlight (select) it. Hold down the Control (Mac=Apple) key
to make multiple table selections.
- **KML to overlay:** You can include KML files to customize markers.
For an introduction to KML files, see Google's tutorial at
`http://code.google.com/apis/kml/documentation/kml\_tut.html
`_ . Add
your own KML files by uploading them using the Filelist module and
then adding a WEC Map External Resource record to the Map page or a
Storage Folder page using the List module and pointing the resource to
the uploaded KML's url (fileadmin/images/myKMLfile.kml).
- **Startingpoint:** Select pages that contain the tables you want
mapped by clicking on the file folder icon. For instance, if you want
your calendar's location table to be included, select the page that
contains the calendar's location records.
- **Recursive:** Select how many subpage-leves you want mapped.
Se
|img-24| **Illustration 16: Configuring the Table Map Details Tab**
e Illustration 20.
**Width and Height:** The default size of the Frontend map is 500px by
500px. You can change the map size to suit the look and feel of your
website here. In order for the marker balloon information to be
visible in the Frontend, avoid setting the height value below 400
pixels.
- **Initial Map Type:** Specifies which map type to show initially.
“Normal” will show the street map (default), Satellite will show
satellite images, and Hybrid will show satellite images with streets
overlayed.
- **Show Written Directions:** Displays an addition tab in the marker
popup with two forms to get direction from or to the current location
via maps.google.com. Directions are disabled if “Sensitive geocode” is
enabled above, no matter the setting here.
- **Show Radius Search:** Displays a Search form that, when completed,
will display all markers within a specified radius (10–250 miles) of a
user-supplied address.
- **Show Marker Sidebar:** Displays the usernames as links to the
markers of those in the FE user groups that you've selected.
- **Prefill Address from User Info:** If directions are enabled, this
will automatically fill in a logged in FE user's address information
into the directions form.
**Map Controls Tab.** Refer to Illustration 18. The third tab, labeled
“Map Controls,” allows you to specify which map controls should be
shown on the map. Options include the size of the map controls (pan
and zoom) if any, whether an overview map is desired, whether a scale
should be included, and the map type selection control (satellite,
political, or a hybrid of the two). See `Illustration 15
<#Map%20Controls|graphic>`_ for a visual description of these
controls.
After saving this form and viewing its page in the Frontend, a map
will be generated in a similar to `Illustration 3, depending on the
Map Controls you have chosen to display.
<#Screenshot%20Table%20Map|graphic>`_
.. _Advanced-Configuration-with-TypoScript:
Advanced Configuration with TypoScript
--------------------------------------
The WEC Map extension can be configured using standard TypoScript and
FlexForms. Example TypoScript is provided below for both plugins *.*
Note that for the WEC Simple Map, which is referred to as
“tx\_wecmap\_pi1” in the TypoScript, you can either specify the
address in parts or as one string. By using TypoScript to configure
this plugin you can also set more than one marker to appear on the
map. The WEC Frontend User Map extension is referred to as
“tx\_wecmap\_pi2.”
::
plugin.tx_wecmap_pi1 {
height = 500
width = 500
showDirections = 1
prefillAddress = 0
initialMapType = G_SATELLITE_MAP
controls.mapControlSize = small
controls.showOverviewMap = 1
controls.showMapType = 1
controls.showScale = 1
markers.1 {
title = TS title
description = TS desc
street = 1234 Happy Place
city = Happy City
zip = 12345
state = HS
country = Happy Country
}
markers.2 {
title = Another title
description = Another description
address = 1234 Another Happy Ave, Happy City, HS 12347, Happy Country
}
markers.3 {
#add another marker here
}
}
plugin.tx_wecmap_pi2 {
height = 500
width = 500
showDirections = 1
prefillAddress = 0
initialMapType = G_HYBRID_MAP
controls.mapControlSize = large
controls.showOverviewMap = 1
controls.showMapType = 1
controls.showScale = 1
userGroups = 2,3,5
pid = 2,3,5
}
.. _Simple-Map-TypoScript-Reference:
Simple Map TypoScript Reference
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. ### BEGIN~OF~TABLE ###
.. _height:
height
""""""
.. container:: table-row
Property
height
Data Type
integer
/stdWrap
Description
The height of the map in pixels. Avoid values of less than 400.
Default
500
.. _width:
width
"""""
.. container:: table-row
Property
width
Data Type
integer
/stdWrap
Description
The width of the map in pixels
Default
500
.. _showDirections:
showDirections
""""""""""""""
.. container:: table-row
Property
showDirections
Data Type
boolean
/stdWrap
Description
Toggle whether a directions tab should be shown for map markers. If
set to 1, the user can get directions from and to the current marker
via maps.google.com directions.
Default
0
.. _prefillAddress:
prefillAddress
""""""""""""""
.. container:: table-row
Property
prefillAddress
Data Type
boolean
/stdWrap
Description
If enabled and a FE user is currently logged in, his or her address
will automatically be filled into the directions form.
Default
0
.. _initialMapType:
initialMapType
""""""""""""""
.. container:: table-row
Property
initialMapType
Data Type
String
/stdWrap
Description
Specifies whether to show the street map, satellite images, or hybrid
view initially. Possible values are the constants defined by Google:
G\_NORMAL\_MAP for the normal street map, G\_SATELLITE\_MAP for Google
Earth satellite images, G\_HYBRID\_MAP for the hybrid view,
G\_OSM\_MAP for the OpenStreetMap view, and G\_OCM\_MAP for the
OpenCycleMap view.
Default
.. _controls-mapControlSize:
controls.mapControlSize
"""""""""""""""""""""""
.. container:: table-row
Property
controls.mapControlSize
Data Type
String
/stdWrap
Description
Defines the map controls in the top left corner of the map. Possible
values are “small”, “large”, or “zoomonly.” “Small” will only show the
pan controls with a + and – zoom, “large” will show the pan controls
with a zoom scale, and “zoomonly” will only show + and – zoom buttons.
Default
.. _controls-showOverviewMap:
controls.showOverviewMap
""""""""""""""""""""""""
.. container:: table-row
Property
controls.showOverviewMap
Data Type
boolean
/stdWrap
Description
Toggles the little mini map in the bottom right corner
Default
0
.. _controls-showMapType:
controls.showMapType
""""""""""""""""""""
.. container:: table-row
Property
controls.showMapType
Data Type
boolean
/stdWrap
Description
Toggles the map type selectors (Map, Satellite and Hybrid) in the top
right corner.
Default
0
.. _controls-showScale:
controls.showScale
""""""""""""""""""
.. container:: table-row
Property
controls.showScale
Data Type
boolean
/stdWrap
Description
Toggles the scale shown in the bottom left.
Default
0
.. _controls-showGoogleEarth:
controls.showGoogleEarth
""""""""""""""""""""""""
.. container:: table-row
Property
controls.showGoogleEarth
Data Type
boolean
/stdWrap
Description
Toggle the Google Earth map type button. Requires special browser
plugin.
Default
0
.. _markers-title:
markers.\*.title
""""""""""""""""
.. container:: table-row
Property
markers.\*.title
Data Type
String
/cObj
Description
Sets the title for a marker. \* is a number starting at 1, which makes
it possible to define as many markers as desired.
Default
.. _markers-description:
markers.\*.description
""""""""""""""""""""""
.. container:: table-row
Property
markers.\*.description
Data Type
String
/cObj
Description
Sets the description for the marker.
Default
.. _markers-street:
markers.\*.street
"""""""""""""""""
.. container:: table-row
Property
markers.\*.street
Data Type
String
/stdWrap
Description
The street name for the marker, i.e. 1234 Happy Lane
Default
.. _markers-zip:
markers.\*.zip
""""""""""""""
.. container:: table-row
Property
markers.\*.zip
Data Type
String
/stdWrap
Description
The ZIP code for the marker, i.e. 43234
Default
.. _markers-city:
markers.\*.city
"""""""""""""""
.. container:: table-row
Property
markers.\*.city
Data Type
String
/stdWrap
Description
The city for the marker, i.e. Some City
Default
.. _markers-state:
markers.\*.state
""""""""""""""""
.. container:: table-row
Property
markers.\*.state
Data Type
String
/stdWrap
Description
The state for the marker, i.e. Montana
Default
.. _markers-country:
markers.\*.country
""""""""""""""""""
.. container:: table-row
Property
markers.\*.country
Data Type
String
/stdWrap
Description
The country for the markers, i.e. USA
Default
.. _markers-address:
markers.\*.address
""""""""""""""""""
.. container:: table-row
Property
markers.\*.address
Data Type
String
/stdWrap
Description
A whole address string. This canbe used instead of the above 5
properties to define the address in one single string, i.e. 1234 Happy
Lane, Some City, Montana 43234, USA
Default
.. _markers-long:
markers.\*.long
"""""""""""""""
.. container:: table-row
Property
markers.\*.long
Data Type
float
/stdWrap
Description
Specify longitude of the marker.
This and the next property can be used instead of “address” above or
the fine grained options further up.
Default
.. _markers-lat:
markers.\*.lat
""""""""""""""
.. container:: table-row
Property
markers.\*.lat
Data Type
float
/stdWrap
Description
Specify latitude of the marker.
Default
.. _markers-iconID:
markers.\*.iconID
"""""""""""""""""
.. container:: table-row
Property
markers.\*.iconID
Data Type
string
/stdWrap
Description
Use the icon with the given id on this marker. This must be the same
iconID that was specified for the icon.
Default
.. _zoomLevel:
zoomLevel
"""""""""
.. container:: table-row
Property
zoomLevel
Data Type
int
/stdWrap
Description
Sets the initial zoom level for the map. Values range from 0 (zoomed
out all the way) to 17 (zoomed in all the way)
Default
.. _maxAutoZoom:
maxAutoZoom
"""""""""""
.. container:: table-row
Property
maxAutoZoom
Data Type
int
/stdWrap
Description
Sets the max auto zoom level
Default
.. _enableOverlappingMarkerManager:
enableOverlappingMarkerManager
""""""""""""""""""""""""""""""
.. container:: table-row
Property
enableOverlappingMarkerManager
Data Type
boolean
/stdWrap
Description
Enables a spiderfier if there are overlapping markers
Default
.. _overlappingMarkerLatDev:
overlappingMarkerLatDev
"""""""""""""""""""""""
.. container:: table-row
Property
overlappingMarkerLatDev
Data Type
float
/stdWrap
Description
Overlapping markers are moved vertically by this amount
Default
0
.. _overlappingMarkerLongDev:
overlappingMarkerLongDev
""""""""""""""""""""""""
.. container:: table-row
Property
overlappingMarkerLongDev
Data Type
float
/stdWrap
Description
Overlapping markers are moved horizontally by this amount
Default
0
.. _icons-iconID:
icons.\*.iconID
"""""""""""""""
.. container:: table-row
Property
icons.\*.iconID
Data Type
String
/stdWrap
Description
Unique id of the icon. Can be any unique, arbitrary string
Default
.. _icons-imagepath:
icons.\*.imagepath
""""""""""""""""""
.. container:: table-row
Property
icons.\*.imagepath
Data Type
String
/stdWrap
Description
path to the marker image, relative to the TYPO3 root
Default
.. _icons-shadowpath:
icons.\*.shadowpath
"""""""""""""""""""
.. container:: table-row
Property
icons.\*.shadowpath
Data Type
String
/stdWrap
Description
path to the shadow image, relative to the TYPO3 root
Default
.. _icons-width:
icons.\*.width
""""""""""""""
.. container:: table-row
Property
icons.\*.width
Data Type
int
/stdWrap
Description
icon width in pixels
Default
.. _icons-height:
icons.\*.height
"""""""""""""""
.. container:: table-row
Property
icons.\*.height
Data Type
int
/stdWrap
Description
icon height in pixels
Default
.. _icons-shadowWidth:
icons.\*.shadowWidth
""""""""""""""""""""
.. container:: table-row
Property
icons.\*.shadowWidth
Data Type
int
/stdWrap
Description
shadow width in pixels
Default
.. _icons-shadowHeight:
icons.\*.shadowHeight
"""""""""""""""""""""
.. container:: table-row
Property
icons.\*.shadowHeight
Data Type
int
/stdWrap
Description
shadow height in pixels
Default
.. _icons-anchorX:
icons.\*.anchorX
""""""""""""""""
.. container:: table-row
Property
icons.\*.anchorX
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which this icon is anchored to the map.
Default
.. _icons-anchorY:
icons.\*.anchorY
""""""""""""""""
.. container:: table-row
Property
icons.\*.anchorY
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which this icon is anchored to the map.
Default
.. _icons-infoAnchorX:
icons.\*.infoAnchorX
""""""""""""""""""""
.. container:: table-row
Property
icons.\*.infoAnchorX
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which the info window is anchored to this icon.
Default
.. _icons-infoAnchorY:
icons.\*.infoAnchorY
""""""""""""""""""""
.. container:: table-row
Property
icons.\*.infoAnchorY
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which the info window is anchored to this icon.
Default
.. _centerLat:
centerLat
"""""""""
.. container:: table-row
Property
centerLat
Data Type
float
/stdWrap
Description
Set the latitude for the initial center of the map
Default
.. _centerLong:
centerLong
""""""""""
.. container:: table-row
Property
centerLong
Data Type
float
/stdWrap
Description
Set the longitude for the initial center of the map
Default
.. _mapName:
mapName
"""""""
.. container:: table-row
Property
mapName
Data Type
String
/stdWrap
Description
Identifies the map uniquely on a page by setting it as the id of the
div containing the map. It's also appended to all the javascript
variables and functions so as not to conflict with more than one map
on a page. Only necessary in special cases, usually the defaults work
well enough.
Default
mapXXX, where XXX is the content element's uid or, if not available, a
random number.
.. _marker-title:
marker.title
""""""""""""
.. container:: table-row
Property
marker.title
Data Type
cObj
Description
cObj for the title of the marker bubble
Default
COA
.. _marker-description:
marker.description
""""""""""""""""""
.. container:: table-row
Property
marker.description
Data Type
cObj
Description
cObj for the description of the marker
Default
COA
.. _marker-address:
marker.address
""""""""""""""
.. container:: table-row
Property
marker.address
Data Type
cObj
Description
cObj for the address formatting in the marker bubble
Default
COA
.. _marker-iconID:
marker.iconID
"""""""""""""
.. container:: table-row
Property
marker.iconID
Data Type
String
/stdWrap
Description
Name of the icon defined in icons.\*
Default
.. _showSidebar:
showSidebar
"""""""""""
.. container:: table-row
Property
showSidebar
Data Type
boolean
/stdWrap
Description
Turns the marker sidebar on or off
Default
0
.. _static-enabled:
static.enabled
""""""""""""""
.. container:: table-row
Property
static.enabled
Data Type
boolean
/stdWrap
Description
Enables static maps with the options below at their default
Default
0
.. _static-mode:
static.mode
"""""""""""
.. container:: table-row
Property
static.mode
Data Type
String
/stdWrap
Description
Either “automatic” or “force”. Automatic will show the normal map with
JS enabled and a static map without JS. Force will always show the
static map even if JS is available.
Default
automatic
.. _static-extent:
static.extent
"""""""""""""
.. container:: table-row
Property
static.extent
Data Type
String
/stdWrap
Description
Either “all” or “each”. All will show all markers that would be
visible on the JS map on the static map. Each will show a separate map
for each marker found, centered and zoomed on that one marker. Be
careful to adjust the limit (see below) for maps that have a large
amount of markers.
Default
all
.. _static-urlParam:
static.urlParam
"""""""""""""""
.. container:: table-row
Property
static.urlParam
Data Type
boolean
/stdWrap
Description
Enables listening for the URL parameter &tx\_wecmap\_api[static]=1 to
show the static map if in automatic mode and JS is available, but not
desired by the user.
Default
0
.. _static-limit:
static.limit
""""""""""""
.. container:: table-row
Property
static.limit
Data Type
int
/stdWrap
Description
The limit for the # or markers or single maps. If extent is “all”, the
limit is 50 and set by Google. A smaller number can be chosen. If the
extent is “each”, there is no upper limit. Default is 50 as well.
Default
50
.. ###### END~OF~TABLE ######
[tsref:plugin.tx\_wecmap\_pi1]
.. _FE-User-Map-TypoScript-Reference:
FE User Map TypoScript Reference
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. ### BEGIN~OF~TABLE ###
.. _height:
height
""""""
.. container:: table-row
Property
height
Data Type
integer
/stdWrap
Description
The height of the map in pixels
Default
500
.. _width:
width
"""""
.. container:: table-row
Property
width
Data Type
integer
/stdWrap
Description
The width of the map in pixels
Default
500
.. _showDirections:
showDirections
""""""""""""""
.. container:: table-row
Property
showDirections
Data Type
boolean
/stdWrap
Description
Toggle whether a directions tab should be shown for map markers. If
set to 1, the user can get directions from and to the current marker
via maps.google.com directions.
Default
0
.. _prefillAddress:
prefillAddress
""""""""""""""
.. container:: table-row
Property
prefillAddress
Data Type
boolean
/stdWrap
Description
If enabled and a FE user is currently logged in, his or her address
will automatically be filled into the directions form.
Default
0
.. _controls-mapControlSize:
controls.mapControlSize
"""""""""""""""""""""""
.. container:: table-row
Property
controls.mapControlSize
Data Type
String
/stdWrap
Description
Defines the map controls in the top left corner of the map. Possible
values are “small”, “large”, or “zoomonly.” “Small” will only show the
pan controls with a + and – zoom, “large” will show the pan controls
with a zoom scale, and “zoomonly” will only show + and – zoom buttons.
Default
.. _controls-showOverviewMap:
controls.showOverviewMap
""""""""""""""""""""""""
.. container:: table-row
Property
controls.showOverviewMap
Data Type
boolean
/stdWrap
Description
Toggles the little mini map in the bottom right corner
Default
0
.. _controls-showMapType:
controls.showMapType
""""""""""""""""""""
.. container:: table-row
Property
controls.showMapType
Data Type
boolean
/stdWrap
Description
Toggles the map type selectors (Map, Satellite and Hybrid) in the top
right corner.
Default
0
.. _controls-showScale:
controls.showScale
""""""""""""""""""
.. container:: table-row
Property
controls.showScale
Data Type
boolean
/stdWrap
Description
Toggles the scale shown in the bottom left.
Default
0
.. _controls-showGoogleEarth:
controls.showGoogleEarth
""""""""""""""""""""""""
.. container:: table-row
Property
controls.showGoogleEarth
Data Type
boolean
/stdWrap
Description
Toggle the Google Earth map type button. Requires special browser
plugin.
Default
0
.. _userGroups:
userGroups
""""""""""
.. container:: table-row
Property
userGroups
Data Type
integer list
/stdWrap
Description
A comma separated list of FE user group ids. If you would like to
restrict the markers shown to users from certain FE user groups, add
their ids here. I.e., to only show users from FE user groups with ids
3 and 4, enter “3,4.”
Default
.. _pid:
pid
"""
.. container:: table-row
Property
pid
Data Type
integer list
/stdWrap
Description
A comma separated list of storage folder ids. If you would like to
restrict the markers shown to users from only certain storage folders,
add their ids here. I.e., to only show users from storage folders with
pids 5 and 8, enter “5,8.”
Default
.. _zoomLevel:
zoomLevel
"""""""""
.. container:: table-row
Property
zoomLevel
Data Type
int
/stdWrap
Description
Sets the initial zoom level for the map. Values range from 0 (zoomed
out all the way) to 17 (zoomed in all the way)
Default
.. _maxAutoZoom:
maxAutoZoom
"""""""""""
.. container:: table-row
Property
maxAutoZoom
Data Type
int
/stdWrap
Description
Sets the max auto zoom level
Default
.. _enableOverlappingMarkerManager:
enableOverlappingMarkerManager
""""""""""""""""""""""""""""""
.. container:: table-row
Property
enableOverlappingMarkerManager
Data Type
boolean
/stdWrap
Description
Enables a spiderfier if there are overlapping markers
Default
.. _overlappingMarkerLatDev:
overlappingMarkerLatDev
"""""""""""""""""""""""
.. container:: table-row
Property
overlappingMarkerLatDev
Data Type
float
/stdWrap
Description
Overlapping markers are moved vertically by this amount
Default
0
.. _overlappingMarkerLongDev:
overlappingMarkerLongDev
""""""""""""""""""""""""
.. container:: table-row
Property
overlappingMarkerLongDev
Data Type
float
/stdWrap
Description
Overlapping markers are moved horizontally by this amount
Default
0
.. _centerLat:
centerLat
"""""""""
.. container:: table-row
Property
centerLat
Data Type
float
/stdWrap
Description
Set the latitude for the initial center of the map
Default
.. _centerLong:
centerLong
""""""""""
.. container:: table-row
Property
centerLong
Data Type
float
/stdWrap
Description
Set the longitude for the initial center of the map
Default
.. _mapName:
mapName
"""""""
.. container:: table-row
Property
mapName
Data Type
String
/stdWrap
Description
Identifies the map uniquely on a page by setting it as the id of the
div containing the map. It's also appended to all the javascript
variables and functions so as not to conflict with more than one map
on a page. Only necessary in special cases, usually the defaults work
well enough.
Default
mapXXX, where XXX is the content element's uid or, if not available, a
random number.
.. _showRadiusSearch:
showRadiusSearch
""""""""""""""""
.. container:: table-row
Property
showRadiusSearch
Data Type
boolean
/stdWrap
Description
Toggles the display of the radius search form
Default
0
.. _groups:
groups.\*
"""""""""
.. container:: table-row
Property
groups.\*
Data Type
string
Description
possible groups are “country”, “city”, and “single”
Default
.. _groups-zoom-min:
groups.\*.zoom.min
""""""""""""""""""
.. container:: table-row
Property
groups.\*.zoom.min
Data Type
int
/stdWrap
Description
minimum zoom level for this group.
Default
.. _groups-zoom-max:
groups.\*.zoom.max
""""""""""""""""""
.. container:: table-row
Property
groups.\*.zoom.max
Data Type
int
/stdWrap
Description
maximum zoom level for this group
Default
.. _groups-icon-iconID:
groups.\*.icon.iconID
"""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.iconID
Data Type
String
/stdWrap
Description
Unique id of the icon. Can be any unique, arbitrary string
Default
.. _groups-icon-imagepath:
groups.\*.icon.imagepath
""""""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.imagepath
Data Type
String
/stdWrap
Description
path to the marker image, relative to the TYPO3 root
Default
.. _groups-icon-shadowpath:
groups.\*.icon.shadowpath
"""""""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.shadowpath
Data Type
String
/stdWrap
Description
path to the shadow image, relative to the TYPO3 root
Default
.. _groups-icon-width:
groups.\*.icon.width
""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.width
Data Type
int
/stdWrap
Description
icon width in pixels
Default
.. _groups-icon-height:
groups.\*.icon.height
"""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.height
Data Type
int
/stdWrap
Description
icon height in pixels
Default
.. _groups-icon-shadowwidth:
groups.\*.icon.shadowwidth
""""""""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.shadowwidth
Data Type
int
/stdWrap
Description
shadow width in pixels
Default
.. _groups-icon-shadowheight:
groups.\*.icon.shadowheight
"""""""""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.shadowheight
Data Type
int
/stdWrap
Description
shadow height in pixels
Default
.. _groups-icon-anchorX:
groups.\*.icon.anchorX
""""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.anchorX
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which this icon is anchored to the map.
Default
.. _groups-icon-anchorY:
groups.\*.icon.anchorY
""""""""""""""""""""""
.. container:: table-row
Property
groups.\*.icon.anchorY
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which this icon is anchored to the map.
Default
.. _table-additionalWhere:
table.additionalWhere
"""""""""""""""""""""
.. container:: table-row
Property
table.additionalWhere
Data Type
string /stdWrap
Description
An additional SQL WHERE clause that is appended by AND. Can be used to
further define which records of the table are mapped.
Default
.. _table-orderBy:
table.orderBy
"""""""""""""
.. container:: table-row
Property
table.orderBy
Data Type
string /stdWrap
Description
An optional ORDERBY clause. This will be passed on verbatim to the
query.
Default
.. _table-limit:
table.limit
"""""""""""
.. container:: table-row
Property
table.limit
Data Type
string /stdWrap
Description
An optional LIMIT clause. This will be passed on verbatim to the
query.
Default
.. _marker-title:
marker.title
""""""""""""
.. container:: table-row
Property
marker.title
Data Type
cObj
Description
cObj for the title of the marker bubble
Default
TEXT
.. _marker-description:
marker.description
""""""""""""""""""
.. container:: table-row
Property
marker.description
Data Type
cObj
Description
cObj for the description of the marker
Default
COA
.. _kml:
kml
"""
.. container:: table-row
Property
kml
Data Type
int
/stdWrap
Description
comma separated list of WEC Map External records, used to overlay any
KML data onto the map
Default
.. _static-enabled:
static.enabled
""""""""""""""
.. container:: table-row
Property
static.enabled
Data Type
boolean
/stdWrap
Description
Enables static maps with the options below at their default
Default
0
.. _static-mode:
static.mode
"""""""""""
.. container:: table-row
Property
static.mode
Data Type
String
/stdWrap
Description
Either “automatic” or “force”. Automatic will show the normal map with
JS enabled and a static map without JS. Force will always show the
static map even if JS is available.
Default
automatic
.. _static-extent:
static.extent
"""""""""""""
.. container:: table-row
Property
static.extent
Data Type
String
/stdWrap
Description
Either “all” or “each”. All will show all markers that would be
visible on the JS map on the static map. Each will show a separate map
for each marker found, centered and zoomed on that one marker. Be
careful to adjust the limit (see below) for maps that have a large
amount of markers.
Default
all
.. _static-urlParam:
static.urlParam
"""""""""""""""
.. container:: table-row
Property
static.urlParam
Data Type
boolean
/stdWrap
Description
Enables listening for the URL parameter &tx\_wecmap\_api[static]=1 to
show the static map if in automatic mode and JS is available, but not
desired by the user.
Default
0
.. _static-limit:
static.limit
""""""""""""
.. container:: table-row
Property
static.limit
Data Type
int
/stdWrap
Description
The limit for the # or markers or single maps. If extent is “all”, the
limit is 50 and set by Google. A smaller number can be chosen. If the
extent is “each”, there is no upper limit. Default is 50 as well.
Default
50
.. ###### END~OF~TABLE ######
[tsref:plugin.tx\_wecmap\_pi2]
.. _Table-Map-TypoScript-Reference:
Table Map TypoScript Reference
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. ### BEGIN~OF~TABLE ###
.. _height:
height
""""""
.. container:: table-row
Property
height
Data Type
integer /stdWrap
Description
The height of the map in pixels
Default
500
.. _width:
width
"""""
.. container:: table-row
Property
width
Data Type
integer
/stdWrap
Description
The width of the map in pixels
Default
500
.. _showDirections:
showDirections
""""""""""""""
.. container:: table-row
Property
showDirections
Data Type
boolean
/stdWrap
Description
Toggle whether a directions tab should be shown for map markers. If
set to 1, the user can get directions from and to the current marker
via maps.google.com directions.
Default
0
.. _prefillAddress:
prefillAddress
""""""""""""""
.. container:: table-row
Property
prefillAddress
Data Type
boolean
/stdWrap
Description
If enabled and a FE user is currently logged in, his or her address
will automatically be filled into the directions form.
Default
0
.. _controls-mapControlSize:
controls.mapControlSize
"""""""""""""""""""""""
.. container:: table-row
Property
controls.mapControlSize
Data Type
String
/stdWrap
Description
Defines the map controls in the top left corner of the map. Possible
values are “small”, “large”, or “zoomonly.” “Small” will only show the
pan controls with a + and – zoom, “large” will show the pan controls
with a zoom scale, and “zoomonly” will only show + and – zoom buttons.
Default
.. _controls-showOverviewMap:
controls.showOverviewMap
""""""""""""""""""""""""
.. container:: table-row
Property
controls.showOverviewMap
Data Type
boolean
/stdWrap
Description
Toggles the little mini map in the bottom right corner
Default
0
.. _controls-showMapType:
controls.showMapType
""""""""""""""""""""
.. container:: table-row
Property
controls.showMapType
Data Type
boolean
/stdWrap
Description
Toggles the map type selectors (Map, Satellite and Hybrid) in the top
right corner.
Default
0
.. _controls-showScale:
controls.showScale
""""""""""""""""""
.. container:: table-row
Property
controls.showScale
Data Type
boolean
/stdWrap
Description
Toggles the scale shown in the bottom left.
Default
0
.. _controls-showGoogleEarth:
controls.showGoogleEarth
""""""""""""""""""""""""
.. container:: table-row
Property
controls.showGoogleEarth
Data Type
boolean
/stdWrap
Description
Toggle the Google Earth map type button. Requires special browser
plugin.
Default
0
.. _pid:
pid
"""
.. container:: table-row
Property
pid
Data Type
integer list
/stdWrap
Description
A comma separated list of storage folder ids. If you would like to
restrict the markers shown to users from only certain storage folders,
add their ids here. I.e., to only show users from storage folders with
pids 5 and 8, enter “5,8.”
Default
.. _recursive:
recursive
"""""""""
.. container:: table-row
Property
recursive
Data Type
int
/stdWrap
Description
number of subpage -levels for storage folders
Default
0
.. _zoomLevel:
zoomLevel
"""""""""
.. container:: table-row
Property
zoomLevel
Data Type
int
/stdWrap
Description
Sets the initial zoom level for the map. Values range from 0 (zoomed
out all the way) to 17 (zoomed in all the way)
Default
.. _maxAutoZoom:
maxAutoZoom
"""""""""""
.. container:: table-row
Property
maxAutoZoom
Data Type
int
/stdWrap
Description
Sets the max auto zoom level
Default
.. _enableOverlappingMarkerManager:
enableOverlappingMarkerManager
""""""""""""""""""""""""""""""
.. container:: table-row
Property
enableOverlappingMarkerManager
Data Type
boolean
/stdWrap
Description
Enables a spiderfier if there are overlapping markers
Default
.. _overlappingMarkerLatDev:
overlappingMarkerLatDev
"""""""""""""""""""""""
.. container:: table-row
Property
overlappingMarkerLatDev
Data Type
float
/stdWrap
Description
Overlapping markers are moved vertically by this amount
Default
0
.. _overlappingMarkerLongDev:
overlappingMarkerLongDev
""""""""""""""""""""""""
.. container:: table-row
Property
overlappingMarkerLongDev
Data Type
float
/stdWrap
Description
Overlapping markers are moved horizontally by this amount
Default
0
.. _centerLat:
centerLat
"""""""""
.. container:: table-row
Property
centerLat
Data Type
float
/stdWrap
Description
Set the latitude for the initial center of the map
Default
.. _centerLong:
centerLong
""""""""""
.. container:: table-row
Property
centerLong
Data Type
float
/stdWrap
Description
Set the longitude for the initial center of the map
Default
.. _mapName:
mapName
"""""""
.. container:: table-row
Property
mapName
Data Type
String
/stdWrap
Description
Identifies the map uniquely on a page by setting it as the id of the
div containing the map. It's also appended to all the javascript
variables and functions so as not to conflict with more than one map
on a page. Only necessary in special cases, usually the defaults work
well enough.
Default
mapXXX, where XXX is the content element's uid or, if not available, a
random number.
.. _showRadiusSearch:
showRadiusSearch
""""""""""""""""
.. container:: table-row
Property
showRadiusSearch
Data Type
boolean
/stdWrap
Description
Toggles the display of the radius search form
Default
0
.. _tables:
tables.\*
"""""""""
.. container:: table-row
Property
tables.\*
Data Type
int
Description
configuration of the tables whose records will be mapped. The \* is a
placeholder for any integer, similar to a COA, i.e. tables.10,
tables.20, etc.
Default
.. _tables-table:
tables.\*.table
"""""""""""""""
.. container:: table-row
Property
tables.\*.table
Data Type
String
/stdWrap
Description
The table name that records are taken from
Default
.. _tables-select:
tables.\*.select
""""""""""""""""
.. container:: table-row
Property
tables.\*.select
Data Type
String
/stdWrap
Description
The SQL SELECT clause. This will be passed on verbatim to the query.
Default
.. _tables-where:
tables.\*.where
"""""""""""""""
.. container:: table-row
Property
tables.\*.where
Data Type
String
/stdWrap
Description
A SQL WHERE clause. Can be used to further define which records of the
table are mapped.
This field is passed through stdWrap so it can be modified with .wrap
and other stdWrap properties.
Default
.. _tables-join:
tables.\*.join
""""""""""""""
.. container:: table-row
Property
tables.\*.join
Data Type
String
/stdWrap
Description
A optional JOIN clause that will be appended to the query, for mm
relations. Needs to be complete, i.e. “INNER JOIN some\_table”.
Example for tt\_address: “JOIN tt\_address\_group\_mm ON
tt\_address\_group\_mm.uid\_local = tt\_address.uid AND
tt\_address\_group\_mm.uid\_foreign = 2”
Default
.. _tables-orderBy:
tables.\*.orderBy
"""""""""""""""""
.. container:: table-row
Property
tables.\*.orderBy
Data Type
String
/stdWrap
Description
An optional ORDERBY clause. This will be passed on verbatim to the
query.
Default
.. _tables-groupBy:
tables.\*.groupBy
"""""""""""""""""
.. container:: table-row
Property
tables.\*.groupBy
Data Type
String
/stdWrap
Description
An optional GROUPBY clause. This will be passed on verbatim to the
query.
Default
.. _tables-limit:
tables.\*.limit
"""""""""""""""
.. container:: table-row
Property
tables.\*.limit
Data Type
String
/stdWrap
Description
An optional LIMIT clause. This will be passed on verbatim to the
query.
Default
.. _tables-icon-iconID:
tables.\*.icon.iconID
"""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.iconID
Data Type
String
/stdWrap
Description
Unique id of the icon. Can be any unique, arbitrary string
Default
.. _tables-icon-imagepath:
tables.\*.icon.imagepath
""""""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.imagepath
Data Type
String
/stdWrap
Description
path to the marker image, relative to the TYPO3 root
Default
.. _tables-icon-shadowpath:
tables.\*.icon.shadowpath
"""""""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.shadowpath
Data Type
String
/stdWrap
Description
path to the shadow image, relative to the TYPO3 root
Default
.. _tables-icon-width:
tables.\*.icon.width
""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.width
Data Type
int
/stdWrap
Description
icon width in pixels
Default
.. _tables-icon-height:
tables.\*.icon.height
"""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.height
Data Type
int
/stdWrap
Description
icon height in pixels
Default
.. _tables-icon-shadowwidth:
tables.\*.icon.shadowwidth
""""""""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.shadowwidth
Data Type
int
/stdWrap
Description
shadow width in pixels
Default
.. _tables-icon-shadowheight:
tables.\*.icon.shadowheight
"""""""""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.shadowheight
Data Type
int
/stdWrap
Description
shadow height in pixels
Default
.. _tables-icon-anchorX:
tables.\*.icon.anchorX
""""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.anchorX
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which this icon is anchored to the map.
Default
.. _tables-icon-anchorY:
tables.\*.icon.anchorY
""""""""""""""""""""""
.. container:: table-row
Property
tables.\*.icon.anchorY
Data Type
int
/stdWrap
Description
The pixel coordinate relative to the top left corner of the icon image
at which this icon is anchored to the map.
Default
.. _tables-title:
tables.\*.title
"""""""""""""""
.. container:: table-row
Property
tables.\*.title
Data Type
cObj
Description
cObj for the title of the marker bubble. If it isn't defined, a
default will be used. Change this to customize the title
Default
-blank-
.. _tables-description:
tables.\*.description
"""""""""""""""""""""
.. container:: table-row
Property
tables.\*.description
Data Type
cObj
Description
cObj for the description of the marker. If it isn't defined, a default
will be used. Change this to customize the description.
Default
-blank-
.. _flexformTables:
flexformTables.\*
"""""""""""""""""
.. container:: table-row
Property
flexformTables.\*
Data Type
String
Description
render-configuration of the tables whose records will be mapped and be
selected in the flexform. The \* is a placeholder for the table name,
similar to a COA, i.e. flexformTables.tt\_address,
flexFormtables.tx\_cal\_location, etc.
Default
.. _flexformTables-icon:
flexformTables.\*.icon.\*
"""""""""""""""""""""""""
.. container:: table-row
Property
flexformTables.\*.icon.\*
Data Type
Description
icon-configuration. See tables.\*.icon.\*
Default
-blank-
.. _flexformTables-title:
flexformTables.\*.title
"""""""""""""""""""""""
.. container:: table-row
Property
flexformTables.\*.title
Data Type
cObj
Description
icon-configuration. See tables.\*.title
Default
-blank-
.. _flexformTables-description:
flexformTables.\*.description
"""""""""""""""""""""""""""""
.. container:: table-row
Property
flexformTables.\*.description
Data Type
cObj
Description
icon-configuration. See tables.\*.description
Default
-blank-
.. _static-enabled:
static.enabled
""""""""""""""
.. container:: table-row
Property
static.enabled
Data Type
boolean
/stdWrap
Description
Enables static maps with the options below at their default
Default
0
.. _static-mode:
static.mode
"""""""""""
.. container:: table-row
Property
static.mode
Data Type
String
/stdWrap
Description
Either “automatic” or “force”. Automatic will show the normal map with
JS enabled and a static map without JS. Force will always show the
static map even if JS is available.
Default
automatic
.. _static-extent:
static.extent
"""""""""""""
.. container:: table-row
Property
static.extent
Data Type
String
/stdWrap
Description
Either “all” or “each”. All will show all markers that would be
visible on the JS map on the static map. Each will show a separate map
for each marker found, centered and zoomed on that one marker. Be
careful to adjust the limit (see below) for maps that have a large
amount of markers.
Default
all
.. _static-urlParam:
static.urlParam
"""""""""""""""
.. container:: table-row
Property
static.urlParam
Data Type
boolean
/stdWrap
Description
Enables listening for the URL parameter &tx\_wecmap\_api[static]=1 to
show the static map if in automatic mode and JS is available, but not
desired by the user.
Default
0
.. _static-limit:
static.limit
""""""""""""
.. container:: table-row
Property
static.limit
Data Type
int
/stdWrap
Description
The limit for the # or markers or single maps. If extent is “all”, the
limit is 50 and set by Google. A smaller number can be chosen. If the
extent is “each”, there is no upper limit. Default is 50 as well.
Default
50
.. ###### END~OF~TABLE ######
[tsref:plugin.tx\_wecmap\_pi3]
See the Installation section for more detailed information about
configuring the two plugins via FlexForms.
.. _Customizing-the-info-bubble:
Customizing the info bubble
---------------------------
Customizing the info bubble of the maps is possible by using
TypoScript. The relevant default configuration for the plugins looks
as follows:
::
plugin.tx_wecmap_pi1.marker {
title = COA
title {
10 = TEXT
10.field = name
10.wrap = |
}
description = COA
description {
10 = COA
10 {
10 = TEXT
10.field = address
10.wrap = |
20 = TEXT
20.field = city
20.wrap = |,
30 = TEXT
30.field = zone
30.wrap = |
40 = TEXT
40.field = zip
}
10.wrap = |
20 = TEXT
20.field = phone
20.wrap = |
}
}
Changing the content of the info bubble is now only a matter of
adding, removing, or changing the content objects. For example, to add
the image of a user and the web address to the info bubble of the WEC
FE User Map plugin, add the following snippet to the plugin's TS
setup:
::
plugin.tx_wecmap_pi2.marker.description.10 {
50 = IMAGE
50.file.import = uploads/tx_srfeuserregister/
50.file.import.override.field = image
60 = TEXT
60.field = www
}
.. _Customizing-a-Table-map:
Customizing a Table map
-----------------------
Configure the infobubble for your record of your DB-table tx\_myext
(DB-fields mytitle and mydesc) with TypoScript:
::
plugin.tx_wecmap_pi3.flexformTables.tx_myext {
// where = some SQL conditions
// limit = 10
icon {
iconID = myIconID
imagepath = fileadmin/myicon.png
shadowpath = fileadmin/myshadow.png
width = 16
height = 16
shadowWidth = 25
shadowHeight = 25
anchorX = 0
anchorY = 0
infoAnchorX = 5
infoAnchorY = 1
}
title = COA
title {
10 = TEXT
10.field = mytitle
10.wrap = |
}
description = COA
description.10 {
10 = TEXT
10.field = mydesc
}
}
Suppose your record for your DB-table tx\_myext contains the fields
mylat/mylong for the coordinates your $TCA to map your DB-fields looks
like this:
::
$TCA['tx_myext']['ctrl']['EXT']['wec_map'] = array (
'isMappable' => 1,
'latlongFields' => array (
'lat' => 'mylat',
'long' => 'mylong',
),
);
If you want to display a map in the DB editing tx\_myext-records you
have to setup the following lines:
::
$geocodeTCA = array (
'tx_wecmap_geocode' => array (
'exclude' => 1,
'label' => 'LLL:EXT:wec_map/locallang_db.xml:berecord_geocodelabel',
'config' => array(
'type' => 'user',
'userFunc' => 'tx_wecmap_backend->checkLatLongStatus',
'params' => array (
'latlongFields' => array(
'lat' => 'mylat',
'long' => 'mylong',
),
),
),
),
);
t3lib_extMgm::addTCAcolumns('tx_myext', $geocodeTCA, 1);
$TCA['tx_myext']['interface']['showRecordFieldList'] .= ',tx_wecmap_geocode';
t3lib_extMgm::addToAllTCAtypes('tx_myext', 'tx_wecmap_geocode', '1', 'after:mylat');
$mapTCA = array (
'tx_wecmap_map' => array (
'exclude' => 1,
'label' => 'LLL:EXT:wec_map/locallang_db.xml:berecord_maplabel',
'config' => array (
'type' => 'user',
'userFunc' => 'tx_wecmap_backend->drawLatLongMap',
'params' => array (
'latlongFields' => array(
'lat' => 'mylat',
'long' => 'mylong',
),
),
),
),
);
t3lib_extMgm::addTCAcolumns('tx_myext', $mapTCA, 1);
$TCA['tx_myext']['interface']['showRecordFieldList'] .= ',tx_wecmap_map';
t3lib_extMgm::addToAllTCAtypes('tx_myext', 'tx_wecmap_map', '1', 'after:tx_wecmap_geocode');
|img-25| **Illustration 17: Editing a BE-record**
In the BE you can either edit the coordinates by the numeric input
fields or by simply dragging the marker to the correct position.
.. _Customizing-a-PDF-view:
Customizing a PDF-view
----------------------
If you are using a PDF-view of your page the wec\_map-plugins have to
be switched to static-mode as extensions like pdf\_generator2 aren't
able to execute the JavaScripts of wec\_map. You can achieve this
automatically by using the following TypoScript:
::
# special handling for PDF-generation
[globalVar = GP:type={$extension.pdf_generator2.typeNum}]
# switch wec_map to static maps
plugin.tx_wecmap_pi1.static {
enabled = 1
mode = force
}
plugin.tx_wecmap_pi2.static < plugin.tx_wecmap_pi1.static
plugin.tx_wecmap_pi3.static < plugin.tx_wecmap_pi1.static
[global]
.. _Responsive-Design:
Responsive Design
-----------------
For a responsive web-design add the following CSS-rule to your
stylesheet:
::
.tx-wecmap-map {
width: 100% !important;
}
.. _Integration-into-EXT-cal:
Integration into EXT:cal
------------------------
The calendar cal can display wec\_map right out of the box.
Enable the use of wec\_map in cal's constant editor or set the
TypoScript constant plugin.tx\_cal\_controller.view.location.showMap =
1
Add markers ###MODULE\_\_LOCATIONLOADER### and ###LOCATION### in
yourevent\_model.tmpl, if you're using an own HTML-template.
Adapt module\_locationloader.tmpl for your needs, if you're using an
own HTML-template. ###MAP### will be replaced by the wec\_map.
To display the map in any other view than the location-view use the
following TypoScript:
::
view.{view}.{object}.showMap = 1
and all the map settings too:
view.{view}.{object}.map {
# Map configuration goes here
}
So to get it working in an event view you should copy the TS to:
::
view.event.event.showMap = 1
view.event.event.map {
# Map configuration goes here
}
.. _Troubleshooting:
Troubleshooting
---------------
In Internet Explorer 7 (IE7), when using the FE User Map plugin in the
Backend, occasionally a slow server connection will cause an error
when adding a new Frontend User in your Storage Folder.
**Internet Explorer cannot open the site
http://www.yoursite.com/typo3/alt\_mainOperation aborted.**
To work around this issue, open the **Ext Manager Module** , and
ensure you can view **Loaded extensions** . Scroll down to the **WEC
Map** extension and click on the WEC Map link (the words). Uncheck the
**Enable map in FE user records** and then click the **Update
button** .
Some users who have large numbers of Frontend User records may
discover that many of their users do not receive geocoding from
Google. This issue may be caused because of your host server's
firewall that interprets multiple geocoding requests and replies from
Google.com as a Denial of Service Attack.
To work around this issue, contact your host and ask them to
**whitelist** **google.com** for your domain.
Sometimes the **marker bubbles appear to be empty** or appear to be
missing either a title or a description. The reason for that is the
font color used for headlines and body text across the whole website.
If either is set to white font color, it will also render the
headlines and/or body text white, making the marker bubbles appear
empty. To fix it, make sure you **change the CSS style for the map
element fonts** ; it uses the class “tx-wecmap-map”, so you could add
the following to your CSS styles file:
::
.tx-wecmap-map {color: black;}
.tx-wecmap-map p {color: black;}
The Typo3-internal XHTML-cleaning messes up the generated JavaScript.
Please disable xhtml-cleaning:
config.xhtml\_cleaning= 0
If you are using a script-compressor like **scriptmerger** you must
exclude the wec\_map JavaScript-files from being merged:
plugin.tx\_scriptmerger {javascript { enable = 1 merge.ignore =
markermanager\.js,infobubble\.js,wecmap\.js}}
.. _Administration:
Administration
--------------
Nested within the Subsection Tools Directory, there are two Backend
Modules associated with the WEC Map extension.
.. _WEC-Map-Admin-Module:
WEC Map Admin Module
^^^^^^^^^^^^^^^^^^^^
|img-26| **Illustration 18: WEC Map Admin Module**
See Illustration 21. The WEC Map Admin Module ( **1** ) includes three
tools in the dropdown list ( **2** ):
**Geocode Admin:** Displays a list of cached (stored) addresses with
their longitude and latitude. Using the pencil icon, the latitude and
longitude values can be changed manually. You can also use the
Trashcan icon next to each entry to delete the entry completely. If
there is a need, it will be automatically regenerated the next time
the latitude and longitude is needed for a map. These coordinates come
from Googleor other geocoding servicesand are stored locally to
decrease the display time of the map. A search box at the top allows
the list of caches to be filtered by keyword and the record table can
now be sorted by clicking on the table headers.
**Batch Geocode:** Manually initiates processing of assigning latitude
and longitude to any records that support geocoding, including website
users.This feature is particularly helpful when there are a
significant number of users to process and the WEC Map extension was
recently installed. You do not need to run the batch geocode because
the WEC Map extension will automatically lookup any needed addresses,
but using this feature will avoid long delays in the map display
caused by many new geocode lookups. If you have over 100 addresses
that must be geocoded, then the processing could take several minutes,
but once an address is processed it will not need to be geocoded again
unless the address changes.
**Download JS-Files:** See installation section.
**API Key Settings:** (not used anymore) Allows you to insert a Google
Map API Key directly into the extension to allow global access based
on domain. This is useful if you are running a site with different
domains. Once you have set API keys for each of your domains, the
extension will automatically use the right one depending on the domain
the user is visiting or logged in from.
.. _FE-User-Map-Module:
FE User Map Module
^^^^^^^^^^^^^^^^^^
S
|img-27| **Illustration 19: FE User Map Module**
ee Illustration 22. The FE User Map Module ( **1** ) shows a detailed map of all the Frontend Users and is an example of how to use the API in backend development. It works very similar to the Frontend User Map plugin. Zooming in on a user and toggling the information bubble will display the address information for that user along with a link to edit the record directly ( **2** ).
Using the WEC Map API
=====================
.. _Create-the-Map-Object:
Create the Map Object
---------------------
The first step in using the WEC Map API is to create a map object. To
do that, include the Google Maps class in your code and create an
instance of it, passing the API key and the map's height and width as
parameters. If the API Key was set through the WEC Map Admin, the
value can be left blank.
::
include_once(t3lib_extMgm::extPath('wec_map').'map_service/google/class.tx_wecmap_map_google.php');
$className = t3lib_div::makeInstanceClassName("tx_wecmap_map_google");
$map = new $className($apiKey, $width, $height);
.. _Map-Object-Reference:
Map Object Reference
--------------------
.. ### BEGIN~OF~TABLE ###
.. _addControl:
addControl
^^^^^^^^^^
.. container:: table-row
Method
addControl
Parameters
$control
Data Type
String
Description
The name of the control. The naming of the control strings passed to
the *addControl* method coincides with Google's naming of the
control, so 'smallMap' creates Google's GSmallMapControl, 'scale'
creates Google's GScaleControl, etc.
.. _setType:
setType
^^^^^^^
.. container:: table-row
Method
setType
Parameters
$type
Data Type
String
Description
$type can be any Google Type Constants specified in the API reference
for GmapType ( `http://code.google.com/apis/maps/documentation/referen
ce.html#GMapType `_ ). The map will default to the G\_NORMAL\_MAP
type.
G\_NORMAL\_MAP, G\_PHYSICAL\_MAP, G\_SATELLITE\_MAP, G\_HYBRID\_MAP,
G\_OSM\_MAP, G\_OCM\_MAP
.. _drawMap:
drawMap
^^^^^^^
.. container:: table-row
Method
drawMap
Parameters
*none*
Data Type
Description
Returns the map markup to be output from the extension.
.. _enableDirections:
enableDirections
^^^^^^^^^^^^^^^^
.. container:: table-row
Method
enableDirections
Parameters
$prefill = false
Data Type
boolean
Description
$prefill is a boolean to toggle whether or not a logged in FE user's
address should be automatically filled in to the directions form of
the marker tab.
.. _directionsContainer-null:
$directionsContainer = null
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. container:: table-row
Method
$directionsContainer = null
Parameters
String
Data Type
$directionsContainer is a string with the id of a container element
that will hold the written out driving instructions. If left at its
default value of null, no written directions will be shown.
.. _:
::
^^
.. container:: table-row
Method
::
addMarkerIcon
Parameters
$iconData
Data Type
Array
Description
Add an extra icon that can be used as a marker icon. $iconData will
have the same format as the array generated from the TS. See below for
an example.
::
$iconData = array(
'iconID' => 'default',
'imagepath' => 'typo3conf/ext/wec_map/images/mm_20_red.png',
'shadowpath' => 'typo3conf/ext/wec_map/images/mm_20_shadow.png',
'width' => 12,
'height' => 20,
'shadowWidth' => 22,
'shadowHeight' => 20,
'anchorX' => 6,
'anchorY' => 20,
'infoAnchorX' => 5,
'infoAnchorY' => 1
);
.. _cObj-null:
$cObj=null
^^^^^^^^^^
.. container:: table-row
Method
$cObj=null
Parameters
CObj
Data Type
optional CObj for interpreting stdWrap of $iconData
.. _:
::
^^
.. container:: table-row
Method
::
addKML
Parameters
$url
Data Type
String
Description
Add any custom KML overlay to the map. $url is a standard URL pointing
to the kml file, e.g. 'http://somewebsite.com/somekmlfile.kml'
.. _:
::
^^
.. container:: table-row
Method
::
setRadius
Parameters
$radius
Data Type
float
Description
The radius beyond which no markers are added to the map.
.. _kilometers-false:
$kilometers = false
^^^^^^^^^^^^^^^^^^^
.. container:: table-row
Method
$kilometers = false
Parameters
boolean
Data Type
Sets kilometers or miles as unit.
.. _:
::
^^
.. container:: table-row
Method
::
setCenter
Parameters
$lat
Data Type
float
Description
Latitude of the map center
.. _long:
$long
^^^^^
.. container:: table-row
Method
$long
Parameters
float
Data Type
Longitude of the map center
.. _:
::
^^
.. container:: table-row
Method
::
setCenterByAddress
Parameters
$street
Data Type
String
Description
Street
.. _city:
$city
^^^^^
.. container:: table-row
Method
$city
Parameters
String
Data Type
City
.. _state:
$state
^^^^^^
.. container:: table-row
Method
$state
Parameters
String
Data Type
State
.. _zip:
$zip
^^^^
.. container:: table-row
Method
$zip
Parameters
String
Data Type
Zip
.. _country-null:
$country = null
^^^^^^^^^^^^^^^
.. container:: table-row
Method
$country = null
Parameters
String
Data Type
Country
.. _:
::
^^
.. container:: table-row
Method
::
showInfoOnLoad
Parameters
*none*
Data Type
Description
Shows the first info bubble on load. Recommended for maps with one
marker only.
.. _:
::
^^
.. container:: table-row
Method
::
setMaxAutoZoom
Parameters
*$newZoom = null*
Data Type
integer
Description
Sets the maximum auto zoom, defaults to 15.
.. _:
::
^^
.. container:: table-row
Method
::
enableStatic
Parameters
*$mode = “automatic”*
Data Type
String
Description
Sets mode of map, either automatic fallback (automatic) or forced
static map (force)
.. _extent-all:
*$extent = “all”*
^^^^^^^^^^^^^^^^^
.. container:: table-row
Method
*$extent = “all”*
Parameters
String
Data Type
Shows either one map with all markers, up to 50 (all) or one map per
marker, zoomed and centered on that marker (each)
.. _urlParam-false:
*$urlParam = false*
^^^^^^^^^^^^^^^^^^^
.. container:: table-row
Method
*$urlParam = false*
Parameters
boolean
Data Type
If $mode is automatic, this enables listening for the URL parameter
&tx\_wecmap\_api[static]=1 to let the user select the static map even
if JS is available.
.. _limit-50:
*$limit = 50*
^^^^^^^^^^^^^
.. container:: table-row
Method
*$limit = 50*
Parameters
integer
Data Type
Sets the limit of markers per map in “all” mode, up to 50, which is
the Google limit. In “each” mode, it can be set higher but defaults to
50 as well.
.. ###### END~OF~TABLE ######
.. _Marker-Object-Reference:
Marker Object Reference
-----------------------
.. ### BEGIN~OF~TABLE ###
.. _setTitle:
setTitle
^^^^^^^^
.. container:: table-row
Method
setTitle
Parameters
$title
Data Type
String
Description
Sets the title of the marker
.. _setDescription:
setDescription
^^^^^^^^^^^^^^
.. container:: table-row
Method
setDescription
Parameters
$desc
Data Type
String
Description
Set the description of the marker
.. _setMinzoom:
setMinzoom
^^^^^^^^^^
.. container:: table-row
Method
setMinzoom
Parameters
$zoom
Data Type
integer
Description
Set the minimum zoom level this marker is shown on
.. _setMaxzoom:
setMaxzoom
^^^^^^^^^^
.. container:: table-row
Method
setMaxzoom
Parameters
$zoom
Data Type
integer
Description
Set the maximum zoom level this marker is shown on
.. _addTab:
addTab
^^^^^^
.. container:: table-row
Method
addTab
Parameters
$tabLabel
Data Type
String
Description
The label of the tab
.. _title:
$title
^^^^^^
.. container:: table-row
Method
$title
Parameters
String
Data Type
The title of this tab's info window
.. _description:
$description
^^^^^^^^^^^^
.. container:: table-row
Method
$description
Parameters
String
Data Type
The description of this tab's info window
.. _getClickJS:
getClickJS
^^^^^^^^^^
.. container:: table-row
Method
getClickJS
Parameters
-
Data Type
-
Description
Returns a javascript snippet that can be used in a link to pan and
zoom to that marker and show its info bubble.
.. ###### END~OF~TABLE ######
.. _Create-Markers:
Create Markers
--------------
.. _Available-methods:
Available methods
^^^^^^^^^^^^^^^^^
There are several methods that can be used to create markers on the
map *.* This is a list of more available methods on the map object
above.
.. ### BEGIN~OF~TABLE ###
.. _addMarkerByAddress:
addMarkerByAddress
""""""""""""""""""
.. container:: table-row
Method
addMarkerByAddress
Parameters
$street
Description
The street part of the address, e.g., 1234 Memorial Lane
.. _city:
$city
"""""
.. container:: table-row
Method
$city
Parameters
The city part of the address, e.g., Oklahoma City
.. _state:
$state
""""""
.. container:: table-row
Method
$state
Parameters
The state or region, e.g., Texas
.. _zip:
$zip
""""
.. container:: table-row
Method
$zip
Parameters
The zip code, e.g., 41343
.. _country:
$country
""""""""
.. container:: table-row
Method
$country
Parameters
The name of the country
.. _title:
$title = ''
"""""""""""
.. container:: table-row
Method
$title = ''
Parameters
The title that will be displayed in the popup balloon that appears
when this marker is clicked.
**Default:** empty String
.. _description:
$description = ''
"""""""""""""""""
.. container:: table-row
Method
$description = ''
Parameters
The description that will be displayed in the popup balloon that
appears when this marker is clicked. Note that Google Maps is picky
about line breaks in the title and description. The API will
automatically replace line breaks with
, so if you need your
title and description to be processed differently, make sure to do
that in your code before you pass it on to this method.
**Default:** empty String
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. ###### END~OF~TABLE ######
.. ### BEGIN~OF~TABLE ###
.. _addMarkerByLatLong:
addMarkerByLatLong
""""""""""""""""""
.. container:: table-row
Method
addMarkerByLatLong
Parameters
$lat
Description
The latitude coordinate for the marker
.. _long:
$long
"""""
.. container:: table-row
Method
$long
Parameters
The longitude coordinate for the marker
.. _title:
$title = ''
"""""""""""
.. container:: table-row
Method
$title = ''
Parameters
The title that will be displayed in the popup balloon that appears
when this marker is clicked.
**Default:** empty String
.. _description:
$description = ''
"""""""""""""""""
.. container:: table-row
Method
$description = ''
Parameters
The description that will be displayed in the popup balloon that
appears when this marker is clicked. Note that Google Maps is picky
about line breaks in the title and description. The API will
automatically replace line breaks with
, so if you need your
title and description to be processed differently, make sure to do
that in your code before you pass it on to this method.
**Default:** empty String
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. ###### END~OF~TABLE ######
.. ### BEGIN~OF~TABLE ###
.. _addMarkerByString:
addMarkerByString
"""""""""""""""""
.. container:: table-row
Method
addMarkerByString
Parameters
$string
Description
The complete address as a single string
.. _title:
$title = ''
"""""""""""
.. container:: table-row
Method
$title = ''
Parameters
The title that will be displayed in the popup balloon that appears
when this marker is clicked.
**Default:** empty String
.. _description:
$description = ''
"""""""""""""""""
.. container:: table-row
Method
$description = ''
Parameters
The description that will be displayed in the popup balloon that
appears when this marker is clicked. Note that Google Maps is picky
about line breaks in the title and description. The API will
automatically replace line breaks with
, so if you need your
title and description to be processed differently, make sure to do
that in your code before you pass it on to this method.
**Default:** empty String
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _addMarkerByTCA:
addMarkerByTCA
""""""""""""""
.. container:: table-row
Method
addMarkerByTCA
Parameters
$table
Description
Name of the table that contains address data
.. _uid:
$uid
""""
.. container:: table-row
Method
$uid
Parameters
The uid of the record to be mapped
.. _title:
$title = ''
"""""""""""
.. container:: table-row
Method
$title = ''
Parameters
The title that will be displayed in the popup balloon that appears
when this marker is clicked.
**Default:** empty String
.. _description:
$description = ''
"""""""""""""""""
.. container:: table-row
Method
$description = ''
Parameters
The description that will be displayed in the popup balloon that
appears when this marker is clicked. Note that Google Maps is picky
about line breaks in the title and description. The API will
automatically replace line breaks with
, so if you need your
title and description to be processed differently, make sure to do
that in your code before you pass it on to this method.
**Default:** empty String
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. ###### END~OF~TABLE ######
.. ### BEGIN~OF~TABLE ###
.. _addMarkerByLatLongWithTabs:
addMarkerByLatLongWithTabs
""""""""""""""""""""""""""
.. container:: table-row
Method
addMarkerByLatLongWithTabs
Parameters
$lat
Description
The latitude coordinate for the marker
.. _long:
$long
"""""
.. container:: table-row
Method
$long
Parameters
The longitude coordinate for the marker
.. _tabLabels-null:
$tabLabels = null
"""""""""""""""""
.. container:: table-row
Method
$tabLabels = null
Parameters
An array of strings that will be used to label the tabs. $tabLabels[0]
will be the label of the first tab, etc.
**Default:** null
.. _title-null:
$title = null
"""""""""""""
.. container:: table-row
Method
$title = null
Parameters
An array of strings that will be used as titles in the different tabs.
$title[0] will be used in the first tab, $title[1] in the second, etc.
Default: null
.. _description-null:
$description = null
"""""""""""""""""""
.. container:: table-row
Method
$description = null
Parameters
An array of descriptions that will be displayed in the popup balloon
that appears when this marker is clicked. $description[0] will be the
description used in the first tab, $description[1] will be used in the
second tab, etc.
Note that Google Maps is picky about line breaks in the title and
description. The API will automatically replace line breaks with
, so if you need your title and description to be processed
differently, make sure to do that in your code before you pass it on
to this method.
**Default:** null
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. ###### END~OF~TABLE ######
.. ### BEGIN~OF~TABLE ###
.. _addMarkerByAddressWithTabs:
addMarkerByAddressWithTabs
""""""""""""""""""""""""""
.. container:: table-row
Method
addMarkerByAddressWithTabs
Parameters
$street
Description
The street part of the address, e.g., 1234 Memorial Lane
.. _city:
$city
"""""
.. container:: table-row
Method
$city
Parameters
The city part of the address, e.g., Oklahoma City
.. _state:
$state
""""""
.. container:: table-row
Method
$state
Parameters
The state or region, e.g., Texas
.. _zip:
$zip
""""
.. container:: table-row
Method
$zip
Parameters
The zip code, e.g., 41343
.. _country:
$country
""""""""
.. container:: table-row
Method
$country
Parameters
The name of the country
.. _tabLabels-null:
$tabLabels = null
"""""""""""""""""
.. container:: table-row
Method
$tabLabels = null
Parameters
An array of strings that will be used to label the tabs. $tabLabels[0]
will be the label of the first tab, etc.
**Default:** null
.. _title-null:
$title = null
"""""""""""""
.. container:: table-row
Method
$title = null
Parameters
An array of strings that will be used as titles in the different tabs.
$title[0] will be used in the first tab, $title[1] in the second, etc.
**Default:** null
.. _description-null:
$description = null
"""""""""""""""""""
.. container:: table-row
Method
$description = null
Parameters
An array of descriptions that will be displayed in the popup balloon
that appears when this marker is clicked. $description[0] will be the
description used in the first tab, $description[1] will be used in the
second tab, etc.
Note that Google Maps is picky about line breaks in the title and
description. The API will automatically replace line breaks with
, so if you need your title and description to be processed
differently, make sure to do that in your code before you pass it on
to this method.
**Default:** null
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. ###### END~OF~TABLE ######
.. ### BEGIN~OF~TABLE ###
.. _addMarkerByStringWithTabs:
addMarkerByStringWithTabs
"""""""""""""""""""""""""
.. container:: table-row
Method
addMarkerByStringWithTabs
Parameters
$string
Description
The complete address as a single string
.. _tabLabels-null:
$tabLabels = null
"""""""""""""""""
.. container:: table-row
Method
$tabLabels = null
Parameters
An array of strings that will be used to label the tabs. $tabLabels[0]
will be the label of the first tab, etc.
**Default:** null
.. _title-null:
$title = null
"""""""""""""
.. container:: table-row
Method
$title = null
Parameters
An array of strings that will be used as titles in the different tabs.
$title[0] will be used in the first tab, $title[1] in the second, etc.
**Default** : null
.. _description-null:
$description = null
"""""""""""""""""""
.. container:: table-row
Method
$description = null
Parameters
An array of descriptions that will be displayed in the popup balloon
that appears when this marker is clicked. $description[0] will be the
description used in the first tab, $description[1] will be used in the
second tab, etc.
Note that Google Maps is picky about line breaks in the title and
description. The API will automatically replace line breaks with
, so if you need your title and description to be processed
differently, make sure to do that in your code before you pass it on
to this method.
**Default:** null
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. _addMarkerByTCAWithTabs:
addMarkerByTCAWithTabs
""""""""""""""""""""""
.. container:: table-row
Method
addMarkerByTCAWithTabs
Parameters
$table
Description
.. _uid:
$uid
""""
.. container:: table-row
Method
$uid
Parameters
.. _tabLables:
$tabLables
""""""""""
.. container:: table-row
Method
$tabLables
Parameters
An array of strings that will be used to label the tabs. $tabLabels[0]
will be the label of the first tab, etc.
**Default:** null
.. _title-null:
$title = null
"""""""""""""
.. container:: table-row
Method
$title = null
Parameters
An array of strings that will be used as titles in the different tabs.
$title[0] will be used in the first tab, $title[1] in the second, etc.
**Default** : null
.. _description-null:
$description = null
"""""""""""""""""""
.. container:: table-row
Method
$description = null
Parameters
An array of descriptions that will be displayed in the popup balloon
that appears when this marker is clicked. $description[0] will be the
description used in the first tab, $description[1] will be used in the
second tab, etc.
Note that Google Maps is picky about line breaks in the title and
description. The API will automatically replace line breaks with
, so if you need your title and description to be processed
differently, make sure to do that in your code before you pass it on
to this method.
**Default:** null
.. _minzoom-0:
$minzoom = 0
""""""""""""
.. container:: table-row
Method
$minzoom = 0
Parameters
The minimum zoom level that this marker is supposed to appear on. The
default is 0, which is the most zoomed out level. See notes on the
Marker Manager below for more information on this.
**Default:** 0
.. _maxzoom-17:
$maxzoom = 17
"""""""""""""
.. container:: table-row
Method
$maxzoom = 17
Parameters
The maximum zoom level that this marker is supposed to appear on. The
default is 17, which is the most zoomed in level. See notes on the
Marker Manager below for more information on this.
**Default:** 17
.. _iconID:
$iconID = ''
""""""""""""
.. container:: table-row
Method
$iconID = ''
Parameters
The name of the icon that has been added with the addMarkerIcon
method. If no name is given, will automatically assign the name
“default.”
.. ###### END~OF~TABLE ######
.. _Marker-Manager:
Marker Manager
^^^^^^^^^^^^^^
The Marker Manager is Google's answer to displaying multiple markers
on the map at once, while at the same time keeping loading times low
and speed high. The Marker Manager ensures that only those markers
that are visible in the viewport are actually rendered. It also adds a
“padding” of markers that are not yet visible but right outside the
viewport to speed up marker rendering when the map is moved around.
The $minzoom and $maxzoom parameters can be used to specify on which
zoom levels a certain group of markers should appear. The FE User Map
plugin and the Backend module use this technique to show only a few
markers per country on zoom levels 0 through 2, only one marker per
city on zoom levels 3 through 7, and all individual markers on levels
8 through 17. See the plugin code and `Google's Map API Documentation
`_ for more details.
.. _Hooks:
Hooks
-----
.. _WEC-Table-Map-Marker-Hook:
WEC Table Map Marker Hook
^^^^^^^^^^^^^^^^^^^^^^^^^
Available at $GLOBALS['TYPO3\_CONF\_VARS']['EXTCONF']['tx\_wecmap\_pi3
']['markerHook']. It allows processing marker objects as they are
added to the map but before the map is rendered. There are two
different parameters that are passed into your user function. The
second one, the reference, is null and not available. The first is an
array of parameters, outlined here.
.. ### BEGIN~OF~TABLE ###
.. _table:
table
"""""
.. container:: table-row
a
table
b
The name of the table that the current record is taken from.
.. _data:
data
""""
.. container:: table-row
a
data
b
The whole database row of the current record.
.. _markerObj:
markerObj
"""""""""
.. container:: table-row
a
markerObj
b
A reference to the actual marker object. See the reference for a list
of available methods.
.. ###### END~OF~TABLE ######
.. _WEC-Map-API-Center-and-Zoom-Hook:
WEC Map API Center and Zoom Hook
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Available at $GLOBALS['TYPO3\_CONF\_VARS']['EXTCONF']['tx\_wecmap\_api
']['centerAndZoomHook']. It passes zoom level, latitude, and longitude
as parameters which can be modified to change the initial center and
zoom of the map.
The second parameter, $ref, is null and not available. The first is an
array of the parameters:
.. ### BEGIN~OF~TABLE ###
.. _lat:
lat
"""
.. container:: table-row
a
lat
b
latitude of initial map center
.. _long:
long
""""
.. container:: table-row
a
long
b
longitude of initial map center
.. _zoom:
zoom
""""
.. container:: table-row
a
zoom
b
initial zoom level of the map
.. ###### END~OF~TABLE ######
.. _Drawing-the-Map:
Drawing the Map
---------------
Rendering of the map is simple. Just call the *drawMap()* method on
the Map objectand it will return the HTML and Javascript necessary to
display the map within a Frontend Plugin or Backend Module:
::
$output = $map->drawMap();
.. _Change-Log:
Change Log
----------
See CHANGELOG file in the extension directory.
EXT: WEC Map |img-28| - 41Modified 02/2013
.. ######CUTTER_MARK_IMAGES######
.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 14
.. :hspace: 12
.. :id: graphics62
.. :name: graphics62
.. :width: 16
.. |img-2| image:: img-2.png
.. :align: left
.. :border: 0
.. :height: 15
.. :hspace: 12
.. :id: Note
.. :name: Note
.. :width: 15
.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 16
.. :hspace: 12
.. :id: Caution
.. :name: Caution
.. :width: 16
.. |img-4| image:: img-4.png
.. :align: left
.. :border: 0
.. :height: 15
.. :hspace: 12
.. :name: Technical Stuff
.. :width: 18
.. |img-5| image:: img-5.jpeg
.. :align: left
.. :border: 0
.. :height: 15
.. :hspace: 12
.. :name: Internet Link
.. :width: 18
.. |img-6| image:: img-6.jpeg
.. :align: left
.. :border: 0
.. :height: 277
.. :id: graphics6
.. :name: graphics6
.. :width: 452
.. |img-7| image:: img-7.jpeg
.. :align: left
.. :border: 0
.. :height: 309
.. :id: graphics15
.. :name: graphics15
.. :width: 452
.. |img-8| image:: img-8.jpeg
.. :align: left
.. :border: 0
.. :name: Screenshot Table Map
.. :width: 100%
.. |img-9| image:: img-9.png
.. :align: right
.. :border: 1
.. :height: 205
.. :id: Grafik1
.. :name: Grafik1
.. :width: 390
.. |img-10| image:: img-10.png
.. :align: right
.. :border: 1
.. :height: 381
.. :id: Grafik2
.. :name: Grafik2
.. :width: 386
.. |img-11| image:: img-11.jpeg
.. :align: left
.. :border: 0
.. :height: 154
.. :id: graphics8
.. :name: graphics8
.. :width: 428
.. |img-12| image:: img-12.jpeg
.. :align: left
.. :border: 0
.. :name: Static Template 02
.. :width: 100%
.. |img-13| image:: img-13.jpeg
.. :align: left
.. :border: 0
.. :name: Add Plugin to Page 01
.. :width: 100%
.. |img-14| image:: img-14.jpeg
.. :align: left
.. :border: 0
.. :height: 19
.. :id: graphics4
.. :name: graphics4
.. :width: 19
.. |img-15| image:: img-15.jpeg
.. :align: left
.. :border: 0
.. :height: 270
.. :id: graphics9
.. :name: graphics9
.. :width: 332
.. |img-16| image:: img-16.jpeg
.. :align: left
.. :border: 0
.. :height: 385
.. :id: graphics10
.. :name: graphics10
.. :width: 380
.. |img-17| image:: img-17.png
.. :align: left
.. :border: 0
.. :height: 444
.. :id: graphics14
.. :name: graphics14
.. :width: 325
.. |img-18| image:: img-18.jpeg
.. :align: left
.. :border: 0
.. :height: 201
.. :id: graphics7
.. :name: graphics7
.. :width: 288
.. |img-19| image:: img-19.jpeg
.. :align: left
.. :border: 0
.. :height: 382
.. :name: Map Controls
.. :width: 384
.. |img-20| image:: img-20.jpeg
.. :align: left
.. :border: 0
.. :height: 616
.. :id: graphics3
.. :name: graphics3
.. :width: 443
.. |img-21| image:: img-21.jpeg
.. :align: left
.. :border: 0
.. :id: Geocoding
.. :name: Geocoding
.. :width: 100%
.. |img-22| image:: img-22.jpeg
.. :align: left
.. :border: 0
.. :name: FEUser Map Control Tab
.. :width: 100%
.. |img-23| image:: img-23.png
.. :align: left
.. :border: 0
.. :name: Table Map Address Tab
.. :width: 100%
.. |img-24| image:: img-24.jpeg
.. :align: left
.. :border: 0
.. :name: Table Map Details Tab
.. :width: 100%
.. |img-25| image:: img-25.png
.. :align: right
.. :border: 0
.. :id: Grafik3
.. :name: Grafik3
.. :width: 100%
.. |img-26| image:: img-26.jpeg
.. :align: left
.. :border: 0
.. :height: 238
.. :id: graphics11
.. :name: graphics11
.. :width: 284
.. |img-27| image:: img-27.jpeg
.. :align: left
.. :border: 0
.. :name: FE User Map Module
.. :width: 100%
.. |img-28| image:: img-28.png
.. :align: left
.. :border: 0
.. :height: 19
.. :id: graphics5
.. :name: graphics5
.. :width: 72