@ipToMapHoverEnhance([IP])

Inserts a "onmouseover" attribute that will enable user to click on entity to show location of IP address on map.

The following parameters are recognized:

[IP]

The optional IP address or host name to show on a map (if omitted, we default to the text of a entity).

This macro is used turn any HTML entity into a object which the end user can click on to show the location of the IP address or host name on a map. If the first child node of the entity the attribute is applied to contains the text IP address to report information on, then it can be omitted when using this @macro. In all other cases, it MUST be passed. Also, applying this attribute will cause both the "onmouseover" and "onclick" handlers for the entity to be re-assigned as soon as the user mouses over the entity.

Example of using the macro:

<span @ipToMapHoverEnhance()>www.google.com</span>
<img @ipToMapHoverEnhance("www.google.com") src="world.gif" />

Assuming the com.ccg.macros.at.All class is within your CLASSPATH and the config/html.at macros file has been generated (Hint: run make atmacros in the wui directory), a developer should be able to run the above example by copy/pasting from below:

[root@probe root]# java com.ccg.macros.at.All <<EOF
@include("config/html.at",,"d")

<span @ipToMapHoverEnhance()>www.google.com</span>
<img @ipToMapHoverEnhance("www.google.com") src="world.gif" />

EOF

This macro is defined as:

@htmlAttr("onmouseover","NstIp.hoverMapEnhance(this, event @ifEqual("@param(0)",,,", '@param(0)'"));")