root/qPloneGoogleMaps/trunk/README.txt

Revision 534 (checked in by piv, 3 years ago)

added tests, used adapter and browser in maps_topic_view, DEPENDENCY.txt, version.txt, HISTORY.txt and README.txt,

  • Property svn:eol-style set to native
Line 
1 Plone Google Maps
2
3   Plone Google Maps (qPloneGoogleMaps) is a Google Maps view product
4   for the Plone content management system which enables integration
5   of Google Maps into Plone sites.
6
7 Plone Google Maps Features
8
9    1. Due to qPloneGoogleMaps you can set up the latitude and longitude
10       of your site objects and have their maps exhibited on your site.
11    2. Any object with the latitude-longitude has an additional map
12       portlet displaying this object. This portlet, in turn, has a
13       template "Large screen". If you click on the large screen below
14       the portlet, you will be able to see the full-size map of the
15       page with its description.
16    3. The folders containing objects with the latitude-longitude
17       parameters have an additional display view - "maps view",
18       which gives an opportunity to see the full-size map with all
19       these objects.
20    4. There is a new content type "Map" which can have other content
21       types - "overlays". It enables the positioning of different
22       objects on one map showing them with the markers of different
23       colours.
24
25 Plone Google Maps Installation
26
27     * Install qPloneGoogleMaps and geolocation as Zope products
28     * Install these two products in your Plone instance with Quick
29       Installer (Plone Control Panel ->Add/remove Products)
30
31 How To Use qPloneGoogleMaps
32
33  Use Case 1
34
35     Let's assume you need to show two objects (Plone pages) situated in
36     one folder on one map.
37
38       * Suppose you have a folder "School"
39       * Create two pages for this folder ("School 1", "School 2")
40       * Go to the page "School 1" and click on the tab "geolocation"
41       * You will see a page with the latitude, longitude,zoom, type
42         fields and an empty Google map. Fill in the fields which determine
43         map displaying properties and then click on map for choosing
44         marker position and then click the "Save" button
45       * Do the same steps for the page "School 2"
46       * Go to the folder "School"
47       * Choose "maps view" from the "display" drop-down menu. You will
48         see the map with both of these objects ("School 1", "School 2")
49         marked with the markers. If you click on one of these markers
50         you will see its name and description appear beside it (after
51         the click on this name you will be taken to the page the marker
52         displays)
53
54  Use Case 2
55
56     Let's assume, you need to show many objects situated in different
57     folders on one map.
58
59       * Suppose, you have a folder "Nigeria".
60       * Go to this folder and add "map" item from the "add item" drop-down
61         menu.
62       * If you go to the "map" you've created, you will notice that it
63         can have an additional content type "overlay":
64       * Choose "overlay" from "add item" drop-down menu
65       * Enter Short Name and title of a new overlay
66       * Click "browse" button for the "Markers Source" pop-up window to appear
67       * Now choose the folder containing the object with the latitude-
68         longitude parameters you want your marker to be tied to and click
69         "insert"
70       * Return to the "Edit Overlay" page to select the marker's color
71         which will be shown on the map
72       * Click the "Save" button
73       * Complete the same steps for creating overlays for other objects of
74         the folder "Nigeria"
75       * Go to this folder and choose the map
76
77 Authors
78
79   * Myroslav Opyr,   quintagroup.com
80
81   * Vitaliy Podoba,  quintagroup.com
Note: See TracBrowser for help on using the browser.