webskin

webskin

Prefixwebskin
Library path/tags/webskin
CFImport

<webskin:breadcrumb ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
separatorstringNo » The separator for the steps in the bread crumb. Can be a snippet of html (an image tag for example)
herestringNo set the text for the last item in the breadcrumb
linkClassstringNo
objectidstringNo#request.navid# This sets the starting point of the bread crumb tail. This is the attribute you are looking for. This must be a UUID of an element in the tree. To start this off, you can set an alias in the tree (for example 'mystuff') and then assign the alias uuid using something like application.navid['mystuff']. The default for this is request.navid
startLevelstringNo1
prefixstringNo
suffixstringNo
includeSelfstringNo0 include the current item in the bread crumb trail
linkSelfstringNotrue true,false should this item be a link in the bread crumb
homeNavIDstringNo#application.navid.home# the objectId of the starting element of the breadcrumb. This UUID should be of one of the items in the navigation tree. For example, if you were to set an alias of a navigation you could set this value like: application.navid['myalias']. The default is application.navid.home.

<webskin:bubble ...>

Displays a notification message on next request end.

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
titlestringNo The title of the message
messagestringNoThe actual message. This can be replaced with generatedContent
pausenumericNo3000How long (in milliseconds) the message appears before being removed
stickybooleanNofalseKeep the message displayed until the user actively closes.
imagestringNoImage to display with the message
tagsstringNoTags to identify message categories later
rbkeystringNogeneral.message.#rereplace(attributes.title,'[^\w]','','ALL')#-#rereplace(attributes.message,'[^\w]','','ALL')#The resource path for this message.
variablesstringNo#arraynew(1)#Variables for resource translation

<webskin:buildLink ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
hrefstringNothe actual href to link to
objectidstringNoAdded to url parameters; navigation obj id
aliasstringNoNavigation alias to use to find the objectid
typestringNoAdded to url parameters: Typename used with type webskin views
viewstringNoAdded to url parameters: Webskin name used to render the page layout
bodyViewstringNoAdded to url parameters: Webskin name used to render the body content
linktextstringNoText used for the link
targetstringNotarget window for link
externallinkstringNo
idstringNoAnchor tag ID
classstringNoAnchor tag classes
stylestringNoAnchor tag styles
titlestringNoAnchor tag title text
urlOnlystringNofalse
r_urlstringNoDefine a variable to pass the link back (instead of writting out via the tag). Note setting urlOnly invalidates this setting
xCodestringNoeXtra code to be placed inside the anchor tag
includeDomainstringNofalse
DomainstringNo#cgi.http_host#
stParametersstringNo#StructNew()#
urlParametersstringNo
JSWindowstringNo0Default to not using a Javascript Window popup
stJSParametersstringNo#StructNew()#
anchorstringNoAnchor to place at the end of the URL string.
onclickstringNothe js code to place in onclick
ampDelimstringNo& the default ampersand delimiter as used by getLink
rbkeystringNoIf set, FarCry will use the specified resource for @text and @title with the provided attribute values as the defaults
bModalstringNofalseIf set, FarCry will open the page as an iframed webtop modal window

<webskin:cache ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
flushcachebooleanNofalse
cacheBlockNamestringNoFarCry
cacheNamestringNo
cacheBlockNamestringNoFarCry
cacheNamestringNo

<webskin:div ...>

A standard HTML div tag usefull when coding so that opening and closing cfoutput tags are not required thereby cleaning up output.

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNo
classstringNo
stylestringNo

<webskin:flashWrapper ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
classstringNoruleFlashWrapper
SWFSourcestringNo
SWFIDstringNoSWFID
SWFWidthstringNo404
SWFHeightstringNo326
SWFVersionstringNo8
SWFBackgroundColorstringNo
SWFWModestringNotransparent
SWFScriptAccessstringNosameDomain
SWFMenustringNofalse
containerWidthstringNo
containerHeightstringNo
RPCServiceNamestringNofacade
RPCMethodstringNo
RPCObjectIDstringNo
stRPCstringNo#structNew()#

<webskin:flexWrapper ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
SWFSourcestringNo
SWFIDstringNo
flashVarsstringNo
flexAssetsPathstringNo#application.url.farcry#/admin/ui/flexassets
FAbridgeJSstringNo

<webskin:fuRedirect ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
notFoundHandlerstringNo

<webskin:genericNav ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
navIDstringNo#request.navID#
depthstringNo1
startLevelstringNo2
idstringNo
bFirststringNo0
firstClassstringNofirst If enabled, this css class name is applied to the first list element in the nav
bLaststringNo0
lastClassstringNolast If enabled, this css class name is applied to the last list element in the nav
bActivestringNo0
activeClassstringNoactive
bIncludeHomestringNo0
sectionObjectIDstringNo#request.navID#
functionMethodstringNogetDescendants
functionArgsstringNodepth=attributes.depth
bDumpstringNo0
classstringNo
stylestringNo
displayStylestringNounorderedList
bHideSecuredNodesstringNo0MJB: check if option to Hide Nav Node Items that user does't have permission to access: default to 0 for backward compatibility
afilterstringNo#arrayNew(1)#
bSpanstringNofalse
lColumnsstringNonavType,externallink,lNavIDAlias,internalRedirectID,externalRedirectURL,target
lColumnsstringNoexternallink,lNavIDAlias
homeAliasstringNohome

<webskin:hbs ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
templatestringNo

<webskin:htmlHead ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
textstringNo
idstringNo#application.fc.utils.createJavaUUID()#
librarystringNo
libraryStatestringNotrue
positionstringNolastfirst or last

<webskin:icon ...>

XML StyleYes

Attributes

<webskin:importCSS ...>

NameTypeRequiredDefaultOptionsDescription
None
XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
typestringNoimport

<webskin:include ...>

XML StyleYes

Attributes

<webskin:listOfLinks ...>

NameTypeRequiredDefaultOptionsDescription
None
XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
qDataqueryNo
startLevelintegerNo2
objectIDuuidNo#request.navID#
lLineagestringNo
listTypestringNoul
idListstringNo
classLIfirststringNo
classLIlineagestringNo
classLIcurrentstringNocurrent

<webskin:loadCSS ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNoThe id of the library that has been registered with the application
lCombineIDsstringNoA list of registered CSS ids, to be included in this library
baseHREFstringNo
lFilesstringNoThe files to include in that baseHREF
mediastringNothe media type to use in the style tag
conditionstringNothe condition to wrap around the style tag
prependstringNoany CSS to prepend to the beginning of the script block
appendstringNoany CSS to append to the end of the script block
bCombinestringNoShould the files be combined into a single cached css file. Passing true/false will override how it was registered.

<webskin:loadJS ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNoThe id of the library that has been registered with the application
lCombineIDsstringNoA list of registered JS ids, to be included in this library
baseHREFstringNo
lFilesstringNoThe files to include in that baseHREF
conditionstringNothe condition to wrap around the style tag
prependstringNoany JS to prepend to the beginning of the script block
appendstringNoany JS to append to the end of the script block
bCombinestringNoShould the files be combined into a single cached js file. Passing true/false will override how it was registered.
corestringNofalseSet to true if this JS is part of core and should be loaded after other JS

<webskin:location ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
urlstringNo
hrefstringNo#attributes.url#the actual href to link to. Defaults to attributes.url
aliasstringNoNavigation alias to use to find the objectid
objectidstringNoAdded to url parameters; navigation obj id
typestringNoAdded to url parameters: Typename used with type webskin views
viewstringNoAdded to url parameters: Webskin name used with type webskin views
bodyViewstringNoAdded to url parameters: Webskin name used with type webskin views
externallinkstringNo
stParametersstringNo#StructNew()#
urlParametersstringNo
includeDomainstringNofalse
DomainstringNo#cgi.http_host#
addTokenstringNofalse
ampDelimstringNo&
statusCodestringNoOptional: add a status code to the cflocation redirect

<webskin:multiPageNav ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
objectIdstringNo
displaystringNotrue
displayPageNumbersstringNotrue
displayNextPreviousstringNotrue
displayNextPreviousTitlestringNotrue
classstringNomultiPage
r_qlinksstringNor_qlinks
seperatorstringNo 
previousArrowstringNo«
nextArrowstringNo»

<webskin:multiPageTOC ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
objectIdstringNo
displaystringNotrue
classstringNomultiPage
r_qlinksstringNor_qlinks

<webskin:onReady ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNo#application.fc.utils.createJavaUUID()#

<webskin:pagination ...>

Provides the functionality to paginate through a recordset

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
querystringNoA query name that contains the objectids to loop over.
arraystringNoAn array of objectids to loop over. Can be used instead of query.
typenamestringNo
paginationIDstringNopageUniquely identifies this pagination set. Set if using sticky pages or if multiple pagination sets on a single page.
bStickyPagesstringNofalseKeeps track of the page the user is currently on in session against this key.
currentPagestringNo0
actionURLstringNo
r_stObjectstringNostObjectThe name of the calling page structure that will contain the current row of the recordset as struct
totalRecordsstringNo0The total number of records in the records. Used if only the current page of the recordset was passed in. 0 assumes that the recordset passed in is the entire recordset to be paginated.
maxRecordsToDisplaynumericNo0
pageLinksnumericNo10
recordsPerPagenumericNo10
submissionTypestringNourl
StepnumericNo1
topbooleanNotrue
bottombooleanNotrue
oddRowClassstringNooddrowThe class name returned in stobjects for each "even" current row
evenRowClassstringNoevenrowThe class name returned in stobjects for each "odd" current row
bDisplayTotalRecordsstringNo0display the total records or not
linksWebskinstringNodisplayLinkswebskin to use for rendering the pagination scroll
r_pageLinksHtmlstringNoSave page links html to a variable so we can return it to the caller

<webskin:pop ...>

The pop tag is useed to handle bubble'd messages.

NOTE: Core uses the following tags in it's messages:

  • type
  • [typename]
  • container
  • rule
  • security
  • updated
  • created
  • deleted
  • workflow
  • information
  • warning
  • error
  • system
  • updateapp

XML StyleYes

This tag has two modes: custom output and automatic output.

Custom output
<skin:pop start="<ul>" end="</ul>">
 <li><strong>#message.title#</strong> #message.message#</li>
</skin:pop>
Automatic output:
<skin:pop format="headerblock" />
Only handling messages with specific tags:
<skin:pop format="headerblock" tags="error" />

Attributes

NameTypeRequiredDefaultOptionsDescription
tagsstringNoMessages with any of these tags will be popped. All messages are popped by default.
variablestringNomessageThe variable that the message information will be stored in
startstringNoString to output at the start ONLY if there is at least one matching message
endstringNoString to output at the end ONLY if there is at least one matching message
formatstringNoAutomatically process the output using "gritter" or "headerblock"

<webskin:postprocess ...>

This tag will run the specified post-processing functions on the input

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
inputstringNo
functionsstringNo

<webskin:printFriendly ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
linktextstringNoPrinter Friendly Version

<webskin:registerCSS ...>

Register a CSS library into the application:

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNoThe id of the library that has been registered with the application
lCombineIDsstringNoA list of registered CSS ids, to be included in this library
baseHREFstringNo
lFilesstringNoThe files to include in that baseHREF
mediastringNoallthe media type to use in the style tag
conditionstringNothe condition to wrap around the style tag
prependstringNoany CSS to prepend to the begining of the script block
appendstringNoany CSS to append to the end of the script block
bCombinestringNotrueShould the files be combined into a single cached css file.

<webskin:registerJS ...>

Register a JS library into the application:

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNoThe id of the library that has been registered with the application
lCombineIDsstringNoA list of registered JS ids, to be included in this library
baseHREFstringNo
lFilesstringNoThe files to include in that baseHREF
conditionstringNothe condition to wrap around the style tag
prependstringNoany JS to prepend to the begining of the script block
appendstringNoany JS to append to the end of the script block
bCombinestringNotrueShould the files be combined into a single cached js file.
aliasofstringNoFlags this library as an alias of an existing one. The original library must already have been registered.
corestringNoFlags this library as being a core library. This library should only be directly referenced by core.

<webskin:relatedcontent ...>

Display related content.

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
objectiduuidNoThe object for which related objects are to be found
webskinstringNowebskin to render related content view
typenamestringNocontent typename of parent; providing improves performance
arrayTypestringNoThe typename containing the array property that defines the relationship we are looking for
arrayPropertystringNopropertyname of the array to render
filterstringNoThe typename of related objects to find. Empty for ALL typenames.
rendertypestringNononerender options: unordered, ordered, none
alternateHTMLstringNo#attributes.webskin# template unavailable.alternative HTML if webskin is missing
r_htmlstringNoEmpty will render the html inline
lValidStatusstringNo#request.mode.lValidStatus#Filter displayed items by their status

<webskin:relatedLinks ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
aRelatedIDsarrayNo
outputstringNotrue
classstringNorelatedLinks
r_qlinksstringNor_qlinks

<webskin:secondaryNav ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
navidstringNo#request.navid#
bIncludeParentstringNotrue
r_navQuerystringNo
bDisplaystringNofalse

<webskin:seo ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
stobjectstructNocontent object of page
titlestringNo
imagestringNoog:image image thumb for content (optional)
descriptionstringNodescription; google search prefers 170 chars but other services may be happy with more
typestringNoarticleog:type defaults to article
urlstringNoog:url is the fully qualified URL to the content

<webskin:simpleNav ...>

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
navIDstringNo#application.fapi.getNavID(alias=
depthstringNo1
currentNavIDstringNo#request.navID#
bIncludeHomestringNotrue
homeAliasstringNohome
tagstringNoul
idstringNo
classstringNo
stylestringNo
activeClassstringNoactive
itemTagstringNoli
itemNestedClassstringNoparent
itemMarkupStartstringNo
itemMarkupEndstringNo
nestedTagstringNoul
functionMethodstringNogetDescendants
functionArgsstringNodepth=attributes.depth
lColumnsstringNoexternallink,lNavIDAlias
aFilterstringNo#arrayNew(1)#

<webskin:sitemap ...>

Build s a sitemap by calling generic nav with specific parameters.

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
depthnumericNo4
startPointstringNo#application.navid.home#
bDisplaystringNotrue
r_navQuerystringNor_navQuery
idstringNositemapNav

<webskin:tooltip ...>

Displays a tool tip on hover.

XML StyleYes
Linking a tool tip to a DOM element using the id attribute
<skin:tooltip message="Stuff!" selector="#a-123" />
<a href="javascript:void(0);" id="a-123">Things</a>

Linking a tooltip to a DOM element using the id attribute and doing an HTML style tooltip

<skin:tooltip selector="#a-123">
  <b>THINGS!</b>
</skin:tooltip>
<a href="javascript:void(0);" id="a-123">Things</a>

Linking a tool tip to several DOM elements using the class selector

<skin:tooltip selector=".yadda">
   <b>THINGS!</b>
</skin:tooltip>
<a class="yadda" href="javascript:void(0);">Thing 1</a>
<a class="yadda" href="javascript:void(0);">Thing 2</a>
<a class="yadda" href="javascript:void(0);">Thing Red</a>
<a class="yadda" href="javascript:void(0);">Thing Blue</a>

Attributes

NameTypeRequiredDefaultOptionsDescription
idstringNoid used to ensure the tooltip is only loaded once per id.
selectorstringNoThe id of the dom element that you wish to have the tooltip display on hover.
messagestringNoThe actual message. If this is blank, the text between the opening and the closing tag will be used (generatedContent)
classstringNoThe css class to be assigned to the tooltip div
positionstringNoThe css class to be assigned to the tooltip div

<webskin:view ...>

This tag will run the view on an object with the same objectid until it is saved to the database.

XML StyleYes

Attributes

NameTypeRequiredDefaultOptionsDescription
stObjectstringNo#structNew()#use to get an existing object that has already been fetched by the calling page.
typenamestringNotypename of the object.
objectidstringNoused to get an existing object
keystringNouse to generate a new object
templatestringNocan be used as an alternative to webskin. Best practice is to use webskin.
webskinstringNothe webskin to be called with the object
onExitProcessstringNo
stPropsstringNo#structNew()#
stParamstringNo#structNew()#
r_htmlstringNoEmpty will render the html inline
r_objectidstringNoAllows the return of the objectid usefull if it is generated by the tag in the case of when passing a key.
hashKeystringNoPass in a key to be used to hash the objectBroker webskin cache
bAjaxstringNo0Flag to determine whether to render an ajax call to load the webskin instead of inline.
ajaxIDstringNoThe id to give the div that will call the ajaxed webskin
ajaxShowloadIndicatorstringNofalseShould the ajax loading indicator be shown
ajaxindicatorTextstringNoloading...What should be text of the loading indicator
ajaxURLParametersstringNoparameters to pass for ajax call
ajaxTimeoutstringNo30parameters to pass for ajax call
bIgnoreSecuritystringNofalseShould the getView() ignore webskin security
bAllowTracestringNotrueSometimes having webskin trace information can break the integrity of a page. This allows you to turn it off.
alternateHTMLstringNo