Difference between revisions of "UserMap Documentation"

From OSGeo
Jump to navigation Jump to search
 
(31 intermediate revisions by 7 users not shown)
Line 1: Line 1:
This is a documentation of how to display a map of your location or a map of all to the data base added users locations in the osgeo wiki.
+
'''This documentation is now deprecated, the user amp is now replaced by the OSGeo Member map.''' See: [[OSGeo_Member_Map_documentation]].
  
=== Add yourself to the userMap ===
+
 
Every user adds himself to the userMap by placing a parser tag 'umSetParam' on his userpage (User:username). The tag has the following syntax:
+
The following documentation shows how to display a map of your location or a map of all users in the Osgeo 'user database'.
 +
 
 +
It also shows how to include yourself in the aforementioned database. Please give feedback [[Usermap-develop|here]].
 +
 
 +
 
 +
= Add yourself to the usermap =
 +
There are two ways to add yourself to the usermap.
 +
 
 +
== By using the parser tag ==
 +
You can define your location parameters, as they are shown in the userMap by including a parser Tag on your user page (User:YourUsername).  
 +
The tag has the following syntax:
 
<pre>
 
<pre>
{{#umSetParam: lon|lat|location name|username|real name}}
+
{{#umSetParam: long|lat|City, Country|Wiki username|Full name}}
 
</pre>
 
</pre>
The coordinates are in decimal degree.
+
The coordinates are in decimal degrees, x|y format. If the User doesn't exist, or the parameters are changed and the tag is placed on the users userpage, the database will be updated.
If the User doesn't exist, or the params are changed and the tag is places on the users userpage, the data base will be updated.
+
For example (on the wiki page: [[User:Christian_Willmes]], an other example with different name and wiki name : [[User:Yjacolin|yjacolin]]):
For example (on the wiki page: User:Christian_Willmes):
 
 
<pre>
 
<pre>
 
{{#umSetParam: 6.92|50.95|Cologne, Germany|Christian Willmes|Christian Willmes}}
 
{{#umSetParam: 6.92|50.95|Cologne, Germany|Christian Willmes|Christian Willmes}}
 
</pre>
 
</pre>
  
=== display a map of a users home location ===
+
== By using umAdmin ==
 +
You can include the usermap Admin tool with the '#umAdmin' parser tag on your wiki userpage (User:YourUsername).
 +
 
 +
The syntax is:
 +
<pre>
 +
{{#umAdmin: YourUsername}}
 +
</pre>
 +
 
 +
When you edited your page accordingly you will see a small menu with three options:
 +
* MyMapViews
 +
* NewMapView
 +
* EditMyUserMap
 +
 
 +
It looks like this:
 +
 
 +
[[Image:Usermap_umAdmin.png]]
 +
 
 +
By clicking on 'EditMyUserMap' two forms are displayed on the page.
 +
* The first is for entering/editing your userMaps MapView parameters (width, height, zoom, navigationbar and baselayer).
 +
* The second is for entering/editing your Location parameters (Your full name, Location name, latitude and longitude.
 +
It is relatively self explaining. :)
 +
By clicking on the submit button of the according form the values are inserted or updated in the database.
 +
By clicking again on EditMyUserMap you can see how your Map looks like with the given parameters.
 +
 
 +
 
 +
== Display a map of a users home location ==
 
To display a map of the home location of a user include the following tag into a wikipage:
 
To display a map of the home location of a user include the following tag into a wikipage:
 
<pre>
 
<pre>
{{#umUserMap: username|width|height|zoom}}
+
{{#umUserMap: username|width|height|zoom|baselayer|navbar}}
 
</pre>
 
</pre>
The 'width' and 'height' parameters are optional. If not providet standart values of 'width=400px', 'height=250px' and 'zoom=4' are applied.<br>   
+
The 'width' and 'height' parameters are optional. If not provided, standard values of 'width=400px', 'height=250px' and 'zoom=4' are applied. "baselayer" is a number between 1 and 4, where 1 = <Openlayers WMS>, 2 = <OSM Mapnik>, 3 = <OSM TilesAtHome>, 4 = <OSM CycleMap>, at default (if not set) its set to 1 (OpenLayers WMS). "navbar" is a boolean, where 'y' enables th OPenLayers Navigationbar and 'n' disables it (which is the default value). <br>   
 
For example:
 
For example:
 
<pre>
 
<pre>
{{#umUserMap: Christian Willmes}}
+
{{#umUserMap: Christian Willmes|400px|400px|7|2|y}}
 
</pre>
 
</pre>
{{#umUserMap: Christian Willmes}}
+
generates this map:
  
=== display a map of all users home locations ===
+
{{#umUserMap: Christian Willmes|400px|400px|7|2|y}}
 +
 
 +
=== base layers ===
 +
As described above but here again to have it structured:
 +
* 1 = OpneLayers WMS (by Metacarta)
 +
* 2 = OSM Mapnik
 +
* 3 = OSM TilesAtHome (Osmarenderer)
 +
* 4 = OSM CycleMap
 +
 
 +
= Display a map of all users home locations =
 
To display a map of all wiki users include the following tag:
 
To display a map of all wiki users include the following tag:
 
<pre>
 
<pre>
{{#umAllUserMap: width|height|zoom}}
+
{{#umAllUserMap: width|height|zoom|centerat|baselayer|navbar}}
 +
</pre>
 +
By combination of the zoom and centerat parameters you can focus any region of the map.
 +
The parameters are optional. If no parameters are provided, standard ones will be used (width=800px, height=450px, zoom=2, centerat=0, 0).<br />
 +
For example with an focus on Europe:
 +
<pre>
 +
{{#umAllUserMap: 800px|450px|4|7, 51|4|y}}
 
</pre>
 
</pre>
The parameters are optional. If no paramters are providet, standart values are providet (width=800px, height=450px, zoom=2).<br>
+
{{#umAllUserMap: 800px|450px|4|7, 51|4|y}}
For example:
+
 
 +
= MapViews with umAdmin =
 +
By using the usermap Admin tool (described above), you can define several MapViews.
 +
 
 +
=== Creating a Mapview with umAdmin ===
 +
By clicking on the option "NewMapView", a form will be shown, where you can enter the parameters of the mapView. It is relatively self explaining, but a short help is also displayed at the bottom of the page.
 +
 
 +
[[Image:Usermap_umAdmin_newMapView.png]]
 +
 
 +
=== Showing the created mapView on a wiki page ===
 +
Every MapView gets a unique ID you can include you mapView wit the '#umMapView' parser tag.
 +
The syntax is:
 +
<pre>
 +
{{#umMapView: ID}}
 +
</pre>
 +
 
 +
For example the following mapView Nr.1
 
<pre>
 
<pre>
{{#umAllUserMap:}}
+
{{#umMapView: 1}}
 
</pre>
 
</pre>
{{#umAllUserMap:}}
+
 
 +
defines a view of Europe:
 +
{{#umMapView: 1}}
 +
 
 +
== Help ==
 +
* If you have any problems displaying the map, add yourself to the database or find a bug please contact [[Christian_Willmes|Christian Willmes]].
 +
* [[Usermap-develop | Here]] you can also request a new feature or report an error.
 +
 
 +
== See also ==
 +
* [http://wiki.osgeo.org/wiki/Category:OSGeo_Member OSGeo Member Category] where the member map is displayed
 +
 
 +
[[Category:Membership]]

Latest revision as of 08:40, 20 November 2015

This documentation is now deprecated, the user amp is now replaced by the OSGeo Member map. See: OSGeo_Member_Map_documentation.


The following documentation shows how to display a map of your location or a map of all users in the Osgeo 'user database'.

It also shows how to include yourself in the aforementioned database. Please give feedback here.


Add yourself to the usermap

There are two ways to add yourself to the usermap.

By using the parser tag

You can define your location parameters, as they are shown in the userMap by including a parser Tag on your user page (User:YourUsername). The tag has the following syntax:

{{#umSetParam: long|lat|City, Country|Wiki username|Full name}}

The coordinates are in decimal degrees, x|y format. If the User doesn't exist, or the parameters are changed and the tag is placed on the users userpage, the database will be updated. For example (on the wiki page: User:Christian_Willmes, an other example with different name and wiki name : yjacolin):

{{#umSetParam: 6.92|50.95|Cologne, Germany|Christian Willmes|Christian Willmes}}

By using umAdmin

You can include the usermap Admin tool with the '#umAdmin' parser tag on your wiki userpage (User:YourUsername).

The syntax is:

{{#umAdmin: YourUsername}}

When you edited your page accordingly you will see a small menu with three options:

  • MyMapViews
  • NewMapView
  • EditMyUserMap

It looks like this:

Usermap umAdmin.png

By clicking on 'EditMyUserMap' two forms are displayed on the page.

  • The first is for entering/editing your userMaps MapView parameters (width, height, zoom, navigationbar and baselayer).
  • The second is for entering/editing your Location parameters (Your full name, Location name, latitude and longitude.

It is relatively self explaining. :) By clicking on the submit button of the according form the values are inserted or updated in the database. By clicking again on EditMyUserMap you can see how your Map looks like with the given parameters.


Display a map of a users home location

To display a map of the home location of a user include the following tag into a wikipage:

{{#umUserMap: username|width|height|zoom|baselayer|navbar}}

The 'width' and 'height' parameters are optional. If not provided, standard values of 'width=400px', 'height=250px' and 'zoom=4' are applied. "baselayer" is a number between 1 and 4, where 1 = <Openlayers WMS>, 2 = <OSM Mapnik>, 3 = <OSM TilesAtHome>, 4 = <OSM CycleMap>, at default (if not set) its set to 1 (OpenLayers WMS). "navbar" is a boolean, where 'y' enables th OPenLayers Navigationbar and 'n' disables it (which is the default value).
For example:

{{#umUserMap: Christian Willmes|400px|400px|7|2|y}}

generates this map:

{{#umUserMap: Christian Willmes|400px|400px|7|2|y}}

base layers

As described above but here again to have it structured:

  • 1 = OpneLayers WMS (by Metacarta)
  • 2 = OSM Mapnik
  • 3 = OSM TilesAtHome (Osmarenderer)
  • 4 = OSM CycleMap

Display a map of all users home locations

To display a map of all wiki users include the following tag:

{{#umAllUserMap: width|height|zoom|centerat|baselayer|navbar}}

By combination of the zoom and centerat parameters you can focus any region of the map. The parameters are optional. If no parameters are provided, standard ones will be used (width=800px, height=450px, zoom=2, centerat=0, 0).
For example with an focus on Europe:

{{#umAllUserMap: 800px|450px|4|7, 51|4|y}}

{{#umAllUserMap: 800px|450px|4|7, 51|4|y}}

MapViews with umAdmin

By using the usermap Admin tool (described above), you can define several MapViews.

Creating a Mapview with umAdmin

By clicking on the option "NewMapView", a form will be shown, where you can enter the parameters of the mapView. It is relatively self explaining, but a short help is also displayed at the bottom of the page.

Usermap umAdmin newMapView.png

Showing the created mapView on a wiki page

Every MapView gets a unique ID you can include you mapView wit the '#umMapView' parser tag. The syntax is:

{{#umMapView: ID}}

For example the following mapView Nr.1

{{#umMapView: 1}}

defines a view of Europe: {{#umMapView: 1}}

Help

  • If you have any problems displaying the map, add yourself to the database or find a bug please contact Christian Willmes.
  • Here you can also request a new feature or report an error.

See also