Chapter 2. Reference For apps.xml

Table of Contents

@appExtRef(NAME, URL, [ONAME], [ATTRS])
@appExtBandwidthd([ONAME], [ATTRS])
@appExtFruity([ONAME], [ATTRS])
@appExtGoogleEarth([ONAME], [ATTRS])
@appExtGoogleMaps([ONAME], [ATTRS])
@appExtGreenbone([ONAME], [ATTRS])
@appExtInprotect([ONAME], [ATTRS])
@appExtKismet([ONAME], [ATTRS])
@appExtLiveUsbCreator([ONAME], [ATTRS])
@appExtMysql([ONAME], [ATTRS])
@appExtMariaDB([ONAME], [ATTRS])
@appExtMariaMysqlDB([ONAME], [ATTRS])
@appExtNagios([ONAME], [ATTRS])
@appExtNessus([ONAME], [ATTRS])
@appExtNmap([ONAME], [ATTRS])
@appExtNtop([ONAME], [ATTRS])
@appExtNtopng([ONAME], [ATTRS])
@appExtNMBScan([ONAME], [ATTRS])
@appExtOpenVAS([ONAME], [ATTRS])
@appExtPostgresql([ONAME], [ATTRS])
@appExtPhp([ONAME], [ATTRS])
@appExtSubversion([ONAME], [ATTRS])
@appExtTCPTraceRoute([ONAME], [ATTRS])
@appExtTrac([ONAME], [ATTRS])
@appExtZabbix([ONAME], [ATTRS])

@appExtRef(NAME, URL, [ONAME], [ATTRS])

Reference to a external application.

The following parameters are recognized:

NAME

Default name of application (to appear in body of text and default tool tip).

URL

URL to jump to when user clicks (must be properly escaped).

[ONAME]

If not blank, will be inserted in the body of text shown to the user, but not included in the default tool tip.

[ATTRS]

Allows one to override the default "tooltip" and "target" attributes. You may also specify any other <a> attributes you want here (other than "href" and "class").

This macro is used to form other macros. It is intended for links to external web sites which you would like to appear in a consistent manner within the main body of text (typically used within paragraphs).

Example of using the macro:

@appRefExt("Inprotect","@inprotectUrl()")
@appRefExt("Inprotect","@inprotectUrl()","the people at Inprotect","@htmlAttr("title","Go check it out")@htmlAttr("style","font-size: 200%")")

Assuming the com.ccg.macros.at.All class is within your CLASSPATH and the config/apps.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/apps.at",,"d")

@appRefExt("Inprotect","@inprotectUrl()")
@appRefExt("Inprotect","@inprotectUrl()","the people at Inprotect","@htmlAttr("title","Go check it out")@htmlAttr("style","font-size: 200%")")

EOF

This macro is defined as:

<a
   @htmlAttr("class","appExtRef")@ifEqual("@param(3)",,"
   @htmlAttr("onmouseover","domTT_activate(this, event, 'content', unescape('@encodeFormParam("<span") @encodeFormParam("class=\"ttNote\">")Open@encodeFormParam("</span>") the @encodeFormParam("<span") @encodeFormParam("class=\"ttCommand\">")@param(0)@encodeFormParam("</span>") web site: @encodeFormParam("\"<span") @encodeFormParam("class=\"ttSite\">@param(1)</span>\"") in a new @encodeFormParam("<span") @encodeFormParam("class=\"ttNote\">")Tab@encodeFormParam("</span>") / @encodeFormParam("<span") @encodeFormParam("class=\"ttNote\">")Window@encodeFormParam("</span>").'), 'width', calcDomTTLen('@param(1)', 0, 480, 1600));")
   @htmlAttr("target","_blank")","
   @param(3)")
   @htmlAttr("href","@param(1)")><span@htmlAttr("style","white-space: nowrap;")>@fnb("@param(2)","@param(0)")</span></a>