modules/geomap/README.txt

********************************************************************
D R U P A L    M O D U L E
********************************************************************
Name: Geomap 
Initial Author: Peter Brownell
Sponsors: Code Positive [www.codepositive.com] 
          and school of everything [www.schoolofeverything.com]
Drupal: 5.0.x
********************************************************************
DESCRIPTION:

  The Geomap module will render a Google map in a block.
  
  The locations placed on the google map are obtained by 
  analysing the current page for GEO microformat informaton.
  When this info exists, a map will be rendered, when there 
  is no location information, no map will appear. 
  
  This module has been disigned to work with the geonames_cck
  module, which outputs it's data in the correct format. 
  
  More information on GEO Microformats: 
    http://microformats.org/wiki/geo 
    
  There have been a few updates to the GEO microformat since
  this was originally written, so not every form of the microformat
  is currently supported.
  
  Example data: 
  <div class="geo" title="Canterbury">
    Canterbury, United Kingdom
    <span class="latitude" title="51.2667"/>
    <span class="longitude" title="1.08333"/>
  </div> 
  

********************************************************************
INSTALLATION:

  Note: It is assumed that you have Drupal up and running.  Be sure to
    check the Drupal web site if you need assistance.  If you run into
    problems, you should always read the INSTALL.txt that comes with the
    Drupal package and read the online documentation.

  1. Place the module directory in to Drupal
        modules/directory.

  2. Enable the module by navigating to:

     Administer > Site building > Modules

  Click the 'Save configuration' button at the bottom to commit your
    changes.
    

********************************************************************
CONFIGURATION

  1. Go to Administer > Settings > Geomap 
      
      Set your google map key. 
      You can obtain this key (for free) from 
        http://code.google.com/apis/maps/signup.html
  
  2. Go to Administer > Site Building > Blocks
       Assign the "Geo Microformat Googlemap" to a region
       
  3. Add some geo microformats to your pages. 
     The best way to do this is to use the geonames_cck module, 
     and add a location field to a node. 
     
      
********************************************************************
ACKNOWLEDGEMENTS

Javascrpt code: 
  Based on jQuery googleMap by Dylan Verheul <dylan@dyve.net>
1	********************************************************************
2	D R U P A L M O D U L E
3	********************************************************************
4	Name: Geomap
5	Initial Author: Peter Brownell
6	Sponsors: Code Positive [www.codepositive.com]
7	and school of everything [www.schoolofeverything.com]
8	Drupal: 5.0.x
9	********************************************************************
10	DESCRIPTION:
11
12	The Geomap module will render a Google map in a block.
13
14	The locations placed on the google map are obtained by
15	analysing the current page for GEO microformat informaton.
16	When this info exists, a map will be rendered, when there
17	is no location information, no map will appear.
18
19	This module has been disigned to work with the geonames_cck
20	module, which outputs it's data in the correct format.
21
22	More information on GEO Microformats:
23	http://microformats.org/wiki/geo
24
25	There have been a few updates to the GEO microformat since
26	this was originally written, so not every form of the microformat
27	is currently supported.
28
29	Example data:
30	<div class="geo" title="Canterbury">
31	Canterbury, United Kingdom
32	<span class="latitude" title="51.2667"/>
33	<span class="longitude" title="1.08333"/>
34	</div>
35
36
37	********************************************************************
38	INSTALLATION:
39
40	Note: It is assumed that you have Drupal up and running. Be sure to
41	check the Drupal web site if you need assistance. If you run into
42	problems, you should always read the INSTALL.txt that comes with the
43	Drupal package and read the online documentation.
44
45	1. Place the module directory in to Drupal
46	modules/directory.
47
48	2. Enable the module by navigating to:
49
50	Administer > Site building > Modules
51
52	Click the 'Save configuration' button at the bottom to commit your
53	changes.
54
55
56
57	********************************************************************
58	CONFIGURATION
59
60	1. Go to Administer > Settings > Geomap
61
62	Set your google map key.
63	You can obtain this key (for free) from
64	http://code.google.com/apis/maps/signup.html
65
66	2. Go to Administer > Site Building > Blocks
67	Assign the "Geo Microformat Googlemap" to a region
68
69	3. Add some geo microformats to your pages.
70	The best way to do this is to use the geonames_cck module,
71	and add a location field to a node.
72
73
74	********************************************************************
75	ACKNOWLEDGEMENTS
76
77	Javascrpt code:
78	Based on jQuery googleMap by Dylan Verheul <dylan@dyve.net>