.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt .. role:: underline ==================== EXT: pit\_googlemaps ==================== :Author: Christopher :Created: 2010-12-18T19:57:23 :Changed by: Björn Paulsen :Changed: 2013-07-28T13:51:28 :Classification: pit_googlemaps :Keywords: pit_googlemaps, google maps, marker :Author: Paulsen-IT (http://www.paulsen-it.de) :Email: info@paulsen-it.de :Language: en .. _img-1-img-2-EXT-pit-googlemaps: |img-1| |img-2| EXT: pit\_googlemaps ==================================== Extension Key: pit\_googlemaps Language: en Version: 1.3 Keywords: pit\_googlemaps, google maps, marker Copyright 2006-2012, Björn Paulsen, < `info@paulsen-it.de `_ >, `http://www.paulsen-it.de `_ 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.org .. _Table-of-Contents: Table of Contents ----------------- **`EXT: pit\_googlemaps 1 <#__RefHeading__5708_1738894311>`_** **`Introduction 3 <#__RefHeading__5710_1738894311>`_** `What does it do? 3 <#__RefHeading__463_413120346>`_ `Screenshots 3 <#__RefHeading__465_413120346>`_ **`Users manual 5 <#__RefHeading__467_413120346>`_** `FAQ 5 <#__RefHeading__31509_818911409>`_ **`Administration 6 <#__RefHeading__31511_818911409>`_** `FAQ 6 <#__RefHeading__31513_818911409>`_ **`Configuration 7 <#__RefHeading__31515_818911409>`_** `FAQ 7 <#__RefHeading__31517_818911409>`_ `Reference 7 <#__RefHeading__31519_818911409>`_ **`Tutorial 8 <#__RefHeading__31523_818911409>`_** **`Known problems 9 <#__RefHeading__31525_818911409>`_** **`To-Do list 10 <#__RefHeading__477_413120346>`_** **`ChangeLog 11 <#__RefHeading__31623_818911409>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - This Extension displays a Google Map. - You have the possibility to put more than one marker into the map. - All points can display an info-window, different text can shown (Template based in Backend) - Show a Sidebar (if enabled), where all Points listed in alphabetic sort .. _Screenshots: Screenshots ^^^^^^^^^^^ A live example and a german translation you can found on `http://www.paulsen-it.de/tutorials/pit\_googlemaps.html `_ |img-3| |img-4| Users manual ------------ This extension shows a google map. You have the possibility to show more than one marker. The template system in backend gives you additional the possibility to create different info-windows each marker. Also to show every marker the same informations. To create a new google map, you insert the plugin to your site. In the first field you must insert your addresses. See Picture 1: Backend (Point 1). On every line you must insert an address. The address don't need a special format. It's like the same as `maps.google.com `_ . For example: :underline:`Wallstreet 5, New York, USA` :underline:`5th Evenue 10, New York, USA` :underline:`Merlose Place 6, Beverly Hills, USA` You can insert the Geo Data manually if you add after the address the Longitude and Latitude, separated by a Pipe(\|). Here a Example: W :underline:`allstreet 5, New York, USA\|-74.0115089\|40.7076255` At the second and third field (Point 2) you say which geometry the map should have. The Point 3 you put the default zoomlevel of the map. Point 4, you can show a sidebar, where all points are listen in alphabetic sort Point 5, you can choose how the map should displayed. Example: Normal, Hybrid, Physical Point 6, thats the “Template” for all markers. If you want the same informations in all info-windows, you have to write the Text here and ignore the Point 7. Point 7, you create template markers, and gives them a value. The first line is for the first address in point 1, the second line for the second address etc. For example you write this template :underline:`Here you find our Offices. This Office is at the address: ###STREET###, ###CITY\_COUNTRY###` Than you must create two template markers ###STREET### and ###CITY\_COUNTRY###. To set them a value use “=” and use “\|” (pipe) to separate the markers from each other. All markers must be inserted at one line for one address! Also in our example the point 7 have now this value: :underline:`###STREET###=Wallstreet 5\|###CITY\_COUNTRY###=New York, USA` :underline:`###STREET###=5th Evenue 10\|###CITY\_COUNTRY###=New York, USA` :underline:`###STREET###=Merlose Place 6\|###CITY\_COUNTRY###=Beverly Hills, USA` To set a individual marker graphic insert on point 8 a graphic file. If you insert only one image, it's used for all markers. But you can set also for each address an image. The first graphic is for the first address, the second for the second address and so on. If you have 5 addresses but only 3 pictures the first three addresses get the pictures, the last two addresses gets the first Picture. .. _FAQ: FAQ ^^^ At this time none .. _Administration: Administration -------------- You only install the Extension in the Extension Manager an put the Plugin on a page. Thats all .. _FAQ: FAQ ^^^ At this time none .. _Configuration: Configuration ------------- Only one Variable is set, the Google API Key in the Constant Editor, but this is deprecated. You don't do anything. .. _FAQ: FAQ ^^^ At this time none .. _Reference: Reference ^^^^^^^^^ Possible subsections: Reference of TypoScript options. [plugin.tx\_pitgooglemaps\_pi1.googleAPIKey] .. ### BEGIN~OF~TABLE ### .. _GoogleAPIKey: GoogleAPIKey """""""""""" .. container:: table-row Property GoogleAPIKey (deprecated) Data type string Description The Google API Key is needed, to display the map Default “” .. ###### END~OF~TABLE ###### [tsref:tx\_pitgooglemaps\_pi1.googleAPIKey] .. _Tutorial: Tutorial -------- This Plugin is so easy to use, we don't need a Tutorial here. For a german translation of this manual and a live demo please visit `http://www.paulsen-it.de/tutorials/pit\_googlemaps.html `_ .. _Known-problems: Known problems -------------- The markers of the Google Maps isn't create with the “markerManager” from Google, because the markermanager is slow for some Points. It's only created and fast if hunderts of markers should display. .. _To-Do-list: To-Do list ---------- \- I want to insert that the extension automatically use the markermanager if more than 50 markers should display. .. _ChangeLog: ChangeLog --------- .. ### BEGIN~OF~TABLE ### .. _1-0-12: 1.0.12 ^^^^^^ .. container:: table-row Version 1.0.12 Changes New manual and depends added .. _1-0-11: 1.0.11 ^^^^^^ .. container:: table-row Version 1.0.11 Changes Some Bugfixes, and new Google API .. _1-0-10: 1.0.10 ^^^^^^ .. container:: table-row Version 1.0.10 Changes Insert Zoom-Level 16 and 17 .. _1-0-9: 1.0.9 ^^^^^ .. container:: table-row Version 1.0.9 Changes Upload again because TER doesn't found the Extension anymore .. _1-0-8: 1.0.8 ^^^^^ .. container:: table-row Version 1.0.8 Changes Some JavaScript errors are fixed .. _1-0-7: 1.0.7 ^^^^^ .. container:: table-row Version 1.0.7 Changes Now you can disable the Route To ... From Message in the Info Window if you want .. _1-0-6: 1.0.6 ^^^^^ .. container:: table-row Version 1.0.6 Changes Bugfixes .. _1-0-5: 1.0.5 ^^^^^ .. container:: table-row Version 1.0.5 Changes Now you can choose the default map type, like satellite or hybrid etc. .. _1-0-4: 1.0.4 ^^^^^ .. container:: table-row Version 1.0.4 Changes Bugfix - Marker was rendered in wrong order .. _1-0-3: 1.0.3 ^^^^^ .. container:: table-row Version 1.0.3 Changes \- Some Bugfixes - New Feature Sidebar - New Feature manually inserting GeoData .. _1-0-2: 1.0.2 ^^^^^ .. container:: table-row Version 1.0.2 Changes Some Changes in the manual Bug: Caching of geo data - removed .. _1-0-1: 1.0.1 ^^^^^ .. container:: table-row Version 1.0.1 Changes Some changes in the manual .. _1-0-0: 1.0.0 ^^^^^ .. container:: table-row Version 1.0.0 Changes Initial Release .. ###### END~OF~TABLE ###### .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 44 .. :id: graphics5 .. :name: graphics5 .. :vspace: 57 .. :width: 161 .. |img-2| image:: img-2.png .. :align: left .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 301 .. :id: Grafik3 .. :name: Grafik3 .. :width: 669 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 857 .. :id: Grafik1 .. :name: Grafik1 .. :width: 398