  ReadMe for Google Maps Multipage 1.0.3 component, consisting of sub-components:
  Main Map, Search Map, iFrame Map, Fullscreen Map, Module Map and Digitizer Map.

  Get it going in twelve easy steps:

  1. Install via the Joomla! installer

          com_google_maps
          mod_google_maps_module (optional)
          mod_google_maps_navigator (optional)
          bot_google_maps (optional)
          plug_geocoder (Community Builder only)

          Hint: In the following the term "com_google_maps[suffix]" stands for
          "com_google_maps_insight" if no other suffix was defined.

  2. Configure the plugin

          Components > Google Maps > Configuration
          Modules > Site Modules > Map Navigator
          Modules > Site Modules > Google Maps

          The Map Navigator (Sidebar) works only if the main map component is displayed
          on the same page, but not if the map is embedded within an iframe or wrapper.

          Get a Google API-Key from: http://maps.google.com/apis/maps/signup.html

          Note: Double-clicking the API-Key field sets this form field's value to the
          content of "$mosConfig_google_maps_api_key" if defined in "configuration.php".

          Note: "Google Maps Interface", "Reset Configuration" and "Copy Plugin" are only
          visible when logged in as Super Administrator.

  3. Create menu items

          On main menu add a menu "Link - URL" item: index.php?option=com_google_maps[suffix][&map=mars|moon|sky]
          On user menu add a menu "Link - URL" item: index.php?option=com_google_maps[suffix]&task=new

          Non-logged in users are not allowed to submit. For further details see the "URL" tab
          in Google Maps Configuration.

  4. Browsers should not run in "Quirks Mode" e.g. Internet Explorer

          <?xml version="1.0" encoding="iso-8859-1"?>
          <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

          A full list about doctype switching can be found at: http://hsivonen.iki.fi/doctype/

          The namespace declaration xmlns:v="urn:schemas-microsoft-com:vml" for polyline
          support in Internet Explorer is added automatically within the script.

  5. Constructing polylines and polygons

          a) Select "Polyline" or "Polygon" from the drop down menu.

          b) List the coordinates in the coordinates field in order that you want the line
          to be made up of in "latitude,longitude" format. If there are 3 or more points the line
          will follow the path of the points in the order they are listed. The first and the last
          pair of coordinates of a polygon should always refer to the same point.

          This will draw a line from Fairbanks, Alaska to Miami, Florida.

          64.831568,-147.726974
          25.780108,-80.200194

          This will draw a line in shape of a pentagon in top of the Pentagon.

          38.872960,-77.054672
          38.870636,-77.053208
          38.868812,-77.055600
          38.870048,-77.058538
          38.872604,-77.057958
          38.872960,-77.054672

          c) Select the color and the lines pixel width in the corresponding fields.

  6. XML file

          The component loads an external XML file with the data from the database. This lowers
          the number of hits to the database and takes some load off of the server. The XML file
          is updated each time you add a marker to the database.

          This updatedes the XML file manually: index.php?option=com_google_maps[suffix]&task=xml

  7. Custom icons for category

          To use this feature simply put a number in the description field of the category that
          corresponds to the base icon in the gicons.js file. By default you can use numbers 0-11.
          0 = Standard icon, large. 1 = Second color icon, large (active marker in search map).
          2-11 = Small icons, various colors. To add your own icons just edit the gicons file
          appropriately.

          In order to add custom icons (number 12 and above) rather than replacing predefined icons,
          put your custom-shadow.png and custom-icon.png in the markers directory (replace "custom"
          with a name of your choice). Amend the following lines to gicons.js:


// custom marker icons - address, shadow, marker(s)
var iconSet7 = new Array(mosConfig_live_site + '/components/' + option + '/markers/custom-','shadow','icon');

// base icon for custom icons
var customIcon1 = new GIcon();
customIcon1.iconSize = new GSize(31,27);
customIcon1.shadowSize = new GSize(31,27);
customIcon1.iconAnchor = new GPoint(8,27);
customIcon1.infoWindowAnchor = new GPoint(5,1);

// add custom icon(s)
customIcon1.shadow = iconSet7[0] + iconSet7[1] + '.png';
for (var i = 2, n = baseIcon.length; i < iconSet7.length; i++, n++) {
    baseIcon[n] = new GIcon(customIcon1);
    baseIcon[n].image = iconSet7[0] + iconSet7[i] + '.png';
}


          You have to adjust the icon size, shadow size and anchor points to fit the size of your icon.
          This new icon can be displayed on the map by putting the number 12 in the according category
          description field. If the first line is changed to

var iconSet7 = new Array(mosConfig_live_site + '/components/' + option + '/markers/custom-','shadow','black','white','red');

          and there are three icons named custom-black.png, custom-white.png, custom-red.png (and actually
          colored this way) in the markers directory, the number 12 will display a black icon, 13 a white
          icon and 14 a red icon all same size and same shadow. To add more than one icon shape, repeat
          the above lines and change iconSet7 to iconSet8 and customIcon1 to customIcon2.

          Google Earth icons are not affected by this modifications.
          During icon testing "Dynamic XML Creation" should be set to "Yes".

  8. Component in iframe and fullscreen mode

          This line on any page will load the map within an iframe:

          <iframe height="250" width="250" src="index2.php?option=com_google_maps[suffix]&
           name=The Great Pyramid" frameborder="0"></iframe>

          This line on any page will load the map within an iframe if the Mambot is installed:

          { left 250 250 GMapFrame[suffix]&name=The Great Pyramid }

          The iframe settings "width" and "height" will change the width and height of the iframe
          dynamically so you can have a different width and height from the main map page. The map
          inside an iframe is always set to 100% height and width. The dimensions of the main map
          can be set in the CSS template (will be overridden by "Aspect Ratio" if set), except for
          the minimap. Basically the fullscreen map is an iframe without a frame, vice-versa an
          iframe is just a fullscreen map within a frame.

          You can use all the URL parameters (category and marker filtering) available to the
          component in iframe and fullscreen mode as well as some other URL parameters.

  9. Backing up the data

          To backup the marker and category data save the XML file before uninstalling the Google
          Maps plugin. Note: The data.xml and data.zip download buttons are not available when the
          website is set to "Offline" in "Global Configuration". For further instructions see the
          info tips in the "XML" tab of the configuration.

  10. XML formats and marker types

          0 = Fixed Marker, 1 = Draggable Marker, 2 = Polygon, 3 = Polyline, 4 = Community Builder Marker

          XML offset (extended marker data and KML-feed only) adds an offset value to all category
          and marker ID's in that XML file. To address a marker ID via "&center=" this offset has to
          be added to the base ID. This applies also to feed ID's addressed via the "&category="
          parameter in the URL.

          ID offset:

              <xml offset="10000" />

          Format for categories:

              <category id="32" title="News" name="News" icon="4" />

          Format for markers:

              <info type="0" id="1" category="7" lat="38.871022" lng="-77.055961" place="US"
               author="Admin" userid="62" created="2007-07-07 00:00:00" modified="2007-07-07 07:00:00" sidebar="1">
                  <name>Name</name>
                  <address>Address</address>
                  <city>City</city>
                  <state>State</state>
                  <zipcode>Zip Code</zipcode>
                  <country>Country</country>
                  <misc>Misc</misc>
                  <avatar>Avatar</avatar> (Community Builder only)
              </info>

          Format for polylines and polygons:

              <info type="2" id="2" category="7" lat="38.872960" lng="-77.054672" place="US"
               author="Joomla!" userid="63" created="2007-07-07 00:00:00" modified="2007-07-07 07:00:00">
                  <name>Name</name>
                  <address>Address</address>
                  <city>City</city>
                  <state>State</state>
                  <zipcode>Zip Code</zipcode>
                  <country>Country</country>
                  <misc polycolor1="#FFFFFF" polycolor2="#000000" polyline="3">
                      <point lat="38.872960" lng="-77.054672" />
                      <point lat="38.870636" lng="-77.053208" />
                      <point lat="38.868812" lng="-77.055600" />
                      <point lat="38.870048" lng="-77.058538" />
                      <point lat="38.872604" lng="-77.057958" />
                      <point lat="38.872960" lng="-77.054672" />
                  </misc>
              </info>

          This line will display a virtual marker (URL created marker) on the map:
          option=com_google_maps&lat=57.27974&lng=-4.47822&zoomLevel=12&virtual=Loch Ness, UK|Where is the dinosaur?

          The center point priority of the main map is as follows (from low to high):
          Backend settings, CB marker (if set), center read from fullscreen map (if present),
          last user created (cookie) marker (not in index2), address line parameters "lat/lng"
          and "address".

          This plugin can make a copy of itself. Hence a single Joomla! installation can run as many
          independent Google Maps plugins as space on the servers hard drive permits. On each map the
          number of markers should be kept below 400 in order to avoid a noticeable slowdown of the
          map (this depends also on the client browsers capabilities).

          New in version 1.0.3: Setting the map center via geocode.
          This centers the map on Kishiwada City: option=com_google_maps&address=kishiwada city
          This centers the map on Munich: option=com_google_maps&address=münchen,lindenstraße 6
          See also "The Lorem Mapsum Demo Page" at mapdemo.110mb.com/content/view/1/10/.

          Note: Changing the "Access Level" in "Category Manager" has no effect on the map.

  11. Troubleshooting

          If the markers unexpectedly disappear then look out for bad XHTML in your XML file(s).
          XHTML is a more strict form of HTML. All tags must be closed properly. <br> is bad XHTML.
          Use <br /> instead. Also empty your cache and restart Internet Explorer. This is a known
          Internet Explorer annoyance.

          If you just get "Loading the Map..." but the map never loads or if something just does not
          work as expected then open the "Error Console" under "Tools" in Firefox. It may display an
          error message that will lead you to the base of your problem.

  12. Programming references

          http://code.google.com/apis/kml/documentation/docIndex.html
          http://code.google.com/apis/maps/documentation/reference.html
          http://code.google.com/p/gmaps-api-issues/wiki/JavascriptMapsAPIChangelog

  Notes:

      This component is tested with Joomla! 1.0.12 to 1.0.15 and Joomla! 1.5.8 in legacy mode under
      PHP 5.2.0 with MySql 4.1.18 and PHP 5.1.6 with MySql 5.0.27 and Google Maps API Version 2.100.

      Photos provided with this plugin are either in public domain, or under Creative Commons
      licenses (CC) and/or under the GNU Free Documentation license (GFDL).

      Hint: Some style features on the mapdemo website are features of the websites templates and
      therefore not included in this plugin.

      The development status of this plugin is considered as "Production/Stable", but nevertheless
      this plugin is not guaranteed to be absolutely free of any errors.

  Known issues:

      a) In Joomla! 1.5.8 Internet Explorer 6 and 7 will crash (Operation aborted) while displaying
      Google Maps Configuration. This is a Mootool related bug.

      b) In some templates these lines are added to fix png images in Internet Explorer 6:

      <!--[if lte IE 6]>
      <style type="text/css">
      img { behavior: URL( [...] iepngfix.htc); }
      </style>
      <![endif]-->

      This fix will crash Internet Explorer 6 while displaying the map (Stack overflow at line: 0).

      c) The map will not work properly in index2.php (print, fullscreen, iframe) if both settings,
      "Search Engine Friendly URLs" and "Add suffix to URLs" in Joomla! 1.5.8 "Global Configuration"
      are set to "Yes".

      d) Due to a bug in the Netscape rendering engine an iframe within an info window does not work
      well with Netscape (and derivative) browsers. See Area 51 demo marker.

      e) When drawing a polygon sometimes a point does not plot on the map as expected. This seems to
      be a bug in the Google Maps API. Workaround: Draw the polygon as polyline first, when finished
      change it to polygon type.

  Changelog 1.0.3:

      1. Bug fix: GGeoXmlFeed[i] is undefined.
      2. Bug fix: minor issue with url encoding.
      3. Bug fix: cross-domain scripting problem with some browsers.
      4. Added function: map center can be set via address (geocode) parameter in URL.
      5. Added function: username in CB info window links to users profile (if logged-in).
      6. Changed behaviour: lat/lng in fullscreen URL overrides center read from opener map.

  Changelog 1.0.2:

      1. Bug fix: setCenter() for index2 map not always working correctly.
      2. Bug fix: category and marker filter not fully working in dynamic XML mode.
      3. Added function: openPrintMap() for opening the print window from any page.
      4. Changed behaviour: hideShow() now also hides GGeoXML markers.
      5. Changed behaviour: newMarker() no longer opens automatically in index2 map.

  Changelog 1.0.1:

      1. Bug fix: last marker in XML file does not open with selectMarker().
      2. Changed behaviour: selectMarker() is now case insensitive.
      3. Changed behaviour: newCenterMarker() now ignores missing lat and lng boxes.