{maketoc}
|
-^__ALERT!__ This package is under development, and is in Alpha state. This package is only compatible with bitweaver version R2.^
|
!Summary
|
-This package makes including and using Google Maps on your bitweaver site a snap! It makes the creation of maps, markers, lines, and other information just a matter of pointing and clicking. It also provides a service to other packages, so that if they want to include a map they can. The service feature is also wired into other bitweaver content for easy geo locating of wiki pages, blog posts, articles, etc. 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.
|
-
|
-__A Note about the R1 Version of Gmap Package:__
|
-Google closed V1 of their API in early November 2006. At this time there is no plan to migrate the R1 version of the Gmap Package to V2 of the API. This means the R1 version of Gmap Package is currently dead and abandon.
|
+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. |
|
!Core Features:
|
!!!Gmap Map Builder
|
-Creating Custom Google Maps with Custom Markers and other features
|
+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 cms geo located content (like pages, articles, users) and viewing it on the map.
|
+A universal map interface for searching for bitweaver geo located content (like pages, articles, users) and viewing it on the map. |
|
|
-!State of Development
|
-!!!Gmap Map Builder
|
-__Map Properties Editor__
|
-Stable
|
-__Markers Editor__
|
-Stable
|
-__Marker Styles and Marker Icons Editors__
|
-Stable
|
-__Polylines Editor__
|
-Stable
|
-__Poligons Editor__
|
-Required Schema Changes are in place. Process needs complete overhaul. Editing interface is not present and GPolygon class must be added.
|
+!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__. |
|
-!!!Gmap Mapping Service
|
-Stable. The map service can be added to any content editing pages. This provides a point-and-click interface for assigning a location to your articles, wiki pages, users, etc.
|
+__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. |
|
-!!!Gmap Content Browser
|
-Stable with only minor bugs. Any geo-located content can be selected and filtered by date, content type, location, category (pigeonholes req) and displayed on a map. A table of content is automatically generated along side the map and links will pop info-windows on the map above corresponding markers. A single content id can be passed in as a variable for loading a particular content item on the map via a link.
|
+!!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. |
|
-!Special Installation 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 or test the GmapPackage.
|
|
-!!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/.
|
+!Development Roadmap |
+!!Bugs |
+* Content Browser Map - Category options list has duplicates. (NEED HELP) |
+* Content Browser Map - Content in nested categories is not found when only ancestor is selected (NEED HELP) |
+* 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. |
|
-!!Get The Code
|
-You can get the latest version of the package by getting module _bit_gmap from bitweaver CVS.
|
+!!Next Steps |
+* 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 |
+* Polygon drawing assistant basically works - could be nicer |
+* Create custom display of polys on Gmap Content Browser page |
+* 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 |
|
-!Development Roadmap
|
-!!Known Important Bugs
|
-* Content Browser Search by content type does not fine Google Map content if not logged in as admin, despite having view maps permission
|
-!!Possible Bugs
|
-* Content Browser Search UI - sometimes the same category is listed more than once.
|
-!!Goals
|
-* Overhaul Polygons editing and display
|
-!!!Minor Features
|
-* Display list of Markers when not set to plot on load
|
-!!!History
|
+!!!Custom History |
History features would be for recording changes to gmap package specific data as well as displaying liberty history data.
|
* Wire in access to Liberty History records
|
* Map History
|