| @@ -1,6 +1,4 @@ |
| {maketoc}
|
| -^__ALERT!__ GmapsPackage is in BETA!__ This package is only compatible with bitweaver version R2. There could be more schema changes in the future, but if any they will be minor. The heavy lifting it done.^
|
| -
|
| !Summary
|
| This package makes including and using Google Maps on your bitweaver site a snap! You can create maps, markers, polylines, and other information with just a little pointing and clicking - no Google Maps API knowledge required! It also provides a service to other packages, to make it easy to add location data to other content. The Gmap Package also provides a universal map for viewing any of such geo-located bitweaver content on your site, so if you tag a page or article with a location you can search for that content by location and view it on a map.
|
|
|
|
|
| @@ -9,18 +7,23 @@ |
| Creating Custom Google Maps with Custom Markers, Polylines, Polygons, and other features
|
|
|
| !!!Gmap Mapping Service
|
| -Lets other packages integrate Google Maps into their features without having to do any map development. One example use that is already integrated is Google Maps can be used for easily attaching geo location data to any bitweaver cms content. Admins can select which content types can be mapped. Permalinks to the Gmap Content Browser can also be included on content pages for easy viewing of where a content item is on a map.
|
| +Lets other packages integrate Google Maps into their features without having to do any map development. One example use that is already integrated is Google Maps can be used for easily attaching geo location data to any bitweaver cms content. Admins can select which content types can be mapped. A Small Map and Permalinks to the Gmap Content Browser can also be included on content pages for easy viewing of where a content item is on a map. |
|
|
| !!!Gmap Content Browser
|
| A universal map interface for searching for bitweaver geo located content (like pages, articles, users) and viewing it on the map.
|
|
|
|
|
| -!Special Installation Instructions
|
| +!Install Instructions |
| !!Dependencies
|
| The R2 version of the GmapPackage is dependent on the GeoPackage. All location date, lat/lng pairs, are being managed by the GeoPackage service. __You MUST also install the GeoPackage if you want to use GmapPackage__.
|
|
|
| -!!You must obtain a Google Map API Key for your site.
|
| +__For strict security enforcement in Gmap package you should also install LibertySecurePackage.__ Gmap has options for making maps and map components private. To strictly enforce those settings in all access points, particularly lists, then you will need LibertySecure. You can run Gmap without LibertySecure, but "private" content will be displayed in lists. |
| + |
| +!!Configuration |
| +You must obtain a Google Map API Key for your site. |
| To use the package you need a key from Google. You can sign up for a key [http://www.google.com/apis/maps/signup.html|here] - it is quick and painless and best of all, Free. After you install the package and have your key, you can plugin your key value for your site in the Gmap admin preferences, which you can get to by going to http://yourbitweaversite/kernel/admin/. Or if you just point your browser to the gmap/ directory, while logged in as admin, you will get prompts how to do this.
|
| + |
| +__For non-required additional configuration tips see: ((GmapPackage Configuration Tips))__ |
|
|
| !!Get The Code
|
| You can get the latest version of the package by getting module _bit_gmap from bitweaver CVS.
|
|
|
| @@ -33,17 +36,15 @@ |
| * Maptype/Tilelayer/Copyright updating after edit does not work - this is really a TODO -- you can store maptypes - just refresh the map to see the results. Basically the ajax callback does not work at the moment.
|
|
|
| !!Next Steps
|
| -Secondary Features of the package need some work. For example, although marker, polyline, and polygon styles can all be stored, there is no good way to get a list of them up to the marker,pline,and pgon set forms where they can be attached to the sets - basically getting a list of styles needs to be added into the sets editing process. __Critical ones are bolded__.
|
| -
|
| -* make marker primary attachment size a content item param.
|
| +* backside functionality to browse Marker, polyline, and polygon styles exists, need ui to display info to user while editing overlays. |
| * cache page requests - including all related data
|
| * stuff javascript
|
| -* Polyline and Polygone click handler and ajax for infowindow needs to be added - would be good to generalize the similar marker features if possible. [http://groups.google.com/group/Google-Maps-API/browse_frm/thread/2110134ae173c752/2517d6d7391192c5?lnk=gst&q=click+on+polygon&rnum=7#2517d6d7391192c5|click handler instructions]
|
| * Polygon drawing assistant basically works - could be nicer
|
| * Create custom display of polys on Gmap Content Browser page
|
| -* Create content page versions for Markers, Polylines, Polygons, that do not require loading the whole map.
|
| +* Create content page versions for Polylines, Polygons, that do not require loading the whole map. |
| * Clean Up gmap css
|
| * Integrate GxMarker and [http://www.pixeldevelopment.com/pdmarker.asp|PdMarker].
|
| + |
| * Infinity and Beyond: see history below
|
|
|
| !!!Custom History
|
|
|
| @@ -56,7 +57,7 @@ |
| * Test in various browsers
|
|
|
|
|
| -!Extended Features Descriptions
|
| +!Extended Features Description |
| Many basic Google Map features are now fully supported and editable via a AJAX UI. Also 600+ free custom icon images, as originally [http://mapki.com/index.php?title=Icon_Image_Sets|listed here] are also included with the package. Additionally, Marker infoWindow text can utilizes whatever text syntaxes your site supports. With all these features you can create great looking maps without writing a single line of javascript. And with its "Sets Model", the Gmap Package makes it easy to re-use map components, like marker styles, custom icons, polylines, etc, over and over on multiple maps, i.e. create once, use infinitely. More about the "Sets Model" is below.
|
|
|
| The features of the package are supplemented by a bleeding edge AJAX editing interface. Almost all features of the map can be updated live, without a browser refresh.
|
|
|