.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ========================== Simple Google Maps Element ========================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Ernst Went :Changed: 2009-03-26T16:20:25.590000000 :Author: Philipp Lutz :Email: plutz@zellwerk.com :Info 3: :Info 4: |img-1| |img-2| Simple Google Maps Element ­ .. _Simple-Google-Maps-Element: Simple Google Maps Element ========================== Extension Key: **zw\_gmap** Copyright 2000-2009, Philipp Lutz, 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: My Extension 1 <#1.EXT:%20My%20Extension|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`Users manual 4 <#1.2.Users%20manual|outline>`_** `FAQ 4 <#1.2.1.FAQ|outline>`_ **`Administration 5 <#1.3.Administration|outline>`_** `FAQ 5 <#1.3.1.FAQ|outline>`_ **`Configuration 6 <#1.4.Configuration|outline>`_** `FAQ 6 <#1.4.1.FAQ|outline>`_ `Reference 6 <#1.4.2.Reference|outline>`_ **`Tutorial 7 <#1.5.Tutorial|outline>`_** **`Known problems 8 <#1.6.Known%20problems|outline>`_** **`To-Do list 9 <#1.7.To-Do%20list|outline>`_** **`ChangeLog 10 <#1.8.ChangeLog|outline>`_** `Important guidelines 11 <#2.Important%20guidelines|outline>`_ **`Issues with Open Office documentation for TYPO3 12 <#2.1.Issues%20w ith%20Open%20Office%20documentation%20for%20TYPO3|outline>`_** `Inserting images 12 <#2.1.1.Inserting%20images|outline>`_ `Paragraph styles 12 <#2.1.2.Paragraph%20styles|outline>`_ `Linking 13 <#2.1.3.Linking|outline>`_ `Meta data and updates 13 <#2.1.4.Meta%20data%20and%20updates|outline>`_ `Help by documentation.openoffice.org 13 <#2.1.5.Help%20by%20documentation.openoffice.org|outline>`_ .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - This extension is a simple way to display a Google-Map as a content element. It is designed to show exactly one address using a customizable map marker with popped-up help bubble. The description text in the bubble help can be edited using a Rich-Text-Inputfield (RTE). - Links to open an input field to get driving directions ('from here','to here') are displayed. - Multiple API-Keys for multiple VirtualHostNames are configurable .. _What-does-it-not-do: What does it not do? ^^^^^^^^^^^^^^^^^^^^ - No fancy sidebar - No multiple markers .. _Screenshots: Screenshots ^^^^^^^^^^^ - Backend view: |img-3| - Frontend View: |img-4| .. _Users-manual: Users manual ------------ How to install: - Go to `http://code.google.com/apis/maps/signup.html `_ to get a Google Maps API key for your domain(s). - Install the extension - On your Web Page: Add a content-element of the type 'Insert plugin' - Set the Plugin-Type to 'Simple Google Maps' - Enter the following data into the fields of the plugin: - Address - Using single or double quotes in the address may break the plugin. (Sorry, but the text goes through many PHP-, HTML- and JavaScript-conversions. Escaping the quotes is not an option.) - If Google Maps has problems identifying your address, you can also enter the world-coordinates you get from Google Earth and add a display address in the “Display Address” field, which will be used when displaying directions. - Google Maps API-Key(s) - Enter the API key you got from Google - if your site uses several domain-names for the same content, you can enter them in the following format one per line: `www.mydomainname.com `_ =ABAAAWAAAetcetc... - Width and height of the Google Maps Applet in px - default is 400px - A formatted version of the address to be displayed in the map marker bubble. - Save the content element and view the page. .. _FAQ: FAQ ^^^ - Q: Can you add ...xxx... as a function ? - A: Please use *rggooglemap* `http://www.rggooglemap.com/ `_ for anything more complicated than a simple map with one marker. .. _Troubleshooting: Troubleshooting ^^^^^^^^^^^^^^^ - If no map appears on your web page, please check the following: Are there JavaScript errors ? - Try a different display address / popup description – non-standard characters may break the JavaScript. - Try removing the typo3temp/gmap\*.js files or add no\_cache=1 to URL params - Try clearing the FE-cache and reloading – the gmap\*.js file may need to be regenerated. - The map appears, but it is not centered on the entered address - use `http://www.google.com/maps `_ to find an address that will be recognized immediately. - use `http://www.google.com/maps `_ to find the corresponding coordinates and enter these as an address. Use 'display address' to nice it up. .. _Administration: Administration -------------- Installation should be straightforward. No configuration by the administrator is necessary. .. _Configuration: Configuration ------------- - This extension uses and includes a slightly modified version of Monte Ohrt's GoogleMapAPI php-class `http://www.phpinsider.com/php/code/GoogleMapAPI/ `_ - I had to add an invisible dummy sidebar to allow the popup bubble to be displayed immediately after loading. - A global Google Maps API-Key can be defined in a TypoScript-template in plugin.tx\_zwgmap\_pi1.apikey .. _Known-problems: Known problems -------------- - The extension creates files of the pattern 'gmap\_xxxx.js' in the typo3temp-directory. The xxxx-part is a checksum across the data of the content element. This means that if you change anything on the source code level (including locallang.xml) these file will probably have to be deleted manually to reflect your source code changes. Adding a no\_cache=1 parameter to the pages URL will create this file again. - Only one map per typo3-page is possible. - No JavaScript, no Google Maps .. _To-Do-list: To-Do list ---------- - Improve handling of quotes. - Improve handling of temporary \*.js files. - Allow multiple instances of the content element on the same page. .. _ChangeLog: ChangeLog --------- - 0.1.0beta: Initial release to TER - 0.1.1beta: global default apikey added - 0.2.0: - Temporary js-file is renewed with no\_cache-parameter - customizable marker icon - customizable initial zoomlevel of map 10 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 23 .. :id: Grafik2 .. :name: Grafik2 .. :width: 86 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 629 .. :id: Grafik1 .. :name: Grafik1 .. :width: 464 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 302 .. :id: Grafik3 .. :name: Grafik3 .. :width: 453