|
|
BetaDocumentation
Documentation for the BETA version of Geo Mashup.
The stable Documentation applies to BETA versions also. This documentation covers additions and changes that apply only to the most recent BETA (1.1beta3).
Important Notice
Upgrading to this version will probably break your current map. At least some minor updates to geo mashup tags will be required to get things going again. There may be other side effects too - keep reading.
Map Frames
Maps are now rendered in their own inline frame. This has some great benefits:
- A map can be placed pretty much anywhere on your site - posts, pages, and templates.
- The map has its own stylesheet, so the many problems raised by rendering the map with your site's stylesheet should be history.
The price for this new flexibility:
- Links inside the map will load inside the map frame, unless the link target is set to the top frame. I've tried to do this automaticallly to links in HTML post excerts.
- The Info Window will not inherit any styles from your blog, so it will look fairly plain unless you provide your own custom stylesheet.
Map Stylesheet
If the file map-style.css is present in the geo-mashup plugin directory, it will be applied to maps. This file will not be overwritten by upgrades. Look at example-map-style.css for examples of CSS classes available.
New Geo Mashup Tag Formats
You can now specify parameters with tags using the new WordPress Shortcode format in any post or page content, and template tag parameter format in WordPress templates.
Shortcode Parameters
Here's an example of a new tag you might put into a post or page:
[geo_mashup_map height="200" width="400" zoom="2" add_overview_control="false" add_map_type_control="false"]
The tag is geo_mashup_map, after which any number of parameters are specified. Any parameters that are not specified will use a default value from the Geo Mashup Options.
Template Tag Parameters
To get a similar map in a template, use template tag syntax:
<?php echo GeoMashup::map('height=200&width=400&zoom=2&add_overview_control=false&add_map_type_control=false');?>
Tag Reference
The current tags available are: map, show_on_map_link, full_post, category_name, category_legend, and list_located_posts. See below for format and parameter details.
Map Tag
Inserts a map for the current post, page, or site.
Old Tag: GEO_MASHUP_MAP and <!--GeoMashup-->
Shortcode Tag: [geo_mashup_map parameter="value"]
Template Tag: <?php echo GeoMashup::map('parameter=value') ?>
Accepted Parameters:
- height - the height of the map in pixels
- width - the width of the map in pixels
- zoom - the starting zoom level, 0 to 17
- add_overview_control - true or false
- map_control - GSmallZoomControl, GSmallMapControl, GLargeMapControl
- add_map_control - true or false
- map_type - G_NORMAL_MAP, G_SATELLITE_MAP, G_HYBRID_MAP, G_PHYSICAL_MAP
- auto_open_info_window - true or false
- marker_min_zoom - hide markers until zoom level, 0 to 17
Map Link Tag
Inserts a link for the current post or page to overall blog map.
Old Tag: GEO_MASHUP_SHOW_ON_MAP_LINK
Shortcode Tag: [geo_mashup_show_on_map_link parameter="value"]
Template Tag: <?php echo GeoMashup::show_on_map_link('parameter=value') ?>
Accepted Parameters:
- text - the text of the link. Default is 'Show on map'.
- show_icon - true or false, whether to display the geotag icon before the link. Default is true.
Category Name Tag
Inserts the name of the currently displayed map category, if any.
Old Tag: GEO_MASHUP_CATEGORY_NAME and <!--GeoCategory-->
Shortcode Tag: [geo_mashup_category_name]
Template Tag: <?php echo GeoMashup::category_name(); ?>
Category Legend Tag
Inserts a table of colored map pins and the categories they go with.
Old Tag: GEO_MASHUP_CATEGORY_LEGEND
Shortcode Tag: [geo_mashup_category_legend]
Template Tag: <?php echo GeoMashup::category_legend(); ?>
Located Post List Tag
Inserts a list of all posts with location information.
Old Tag: GEO_MASHUP_LIST_LOCATED_POSTS
Shortcode Tag: [geo_mashup_list_located_posts]
Template Tag: <?php echo GeoMashup::list_located_posts(); ?>
Full Post Tag
Displays full post content on a map page if the 'Enable Full Post Display' option is checked.
Old Tag: GEO_MASHUP_FULL_POST and <!--GeoPost-->
Shortcode Tag: [geo_mashup_full_post]
Template Tag: <?php GeoMashup::full_post() ?>
KML Attachments
You can upload a KML file with a post or page using the media uploader. Be sure to save all changes to the upload before closing the upload dialog box. The KML file (center) will be used to determine a default location for the post or page. If you include a map in that post or page, it will load and display the KML file.
Category Connecting Lines
Markers in a category can be connected by a line in this version. Categories can be assigned a color for lines and markers in the Geo Mashup Options.
Sign in to add a comment
Tip: If you use another time zone you have to enable the "show future posts" option.
Or u can fix that editing the "geo-query.php" file, but i don't have mysql skills for do that. maybe if u have't too, try with PHP, or forget fix that and simple comment the line:
if ($opts['show_future'] != 'true') {
}The time zone problem is fixed in 1.1beta2