Company logo to replace the default logo in the main UI and authentication screens. Should specify a background image and background size.
Primary colors used for header and highlight text. Should specify a 'color' attribute.
Primary color (or fill) used for header region.
Primary color (or fill) used for popup buttons, and the popup button selected by default.
Marker classes indicating current state of UI that can be used in CSS to selectively change the display of custom content.
These are areas within parts of the UI intended for custom content to be added using script.
These are all on the home screen.
These are on the app details (info) page.
These are all on the explicit authentication screen.
These are all on the general authentication screens (when shown).
These relate to all authentication screens.
This is the low level data format from the server. See wire API specifications.
Note that during these calls, the UI may be hidden by native Citrix Receiver, so it is not safe to show UI.
For APIs passing a callback, you MUST call the callback function, though you may delay calling it until code of your own has run.
Web browsers only. Called prior to displaying any logon dialogs. You may call "showMessage" here, or add your own UI.
All clients, called prior to displaying the main UI. This is the ideal place to add custom startup UI.
Note that for native clients, the user may not have logged in at this stage, as some clients allow offline access to the UI.
All clients, called once the UI is loaded and displayed. The ideal place to call APIs to adjust the initial UI, for example to start in a different tab.
This passes back information about the native client environment. Not called for web browser access.
This passes information about the store being accessed by the native client - as the page URI does not necessarily give any clue.
A low level, but extremely useful function to modify application data prior to any processing.
Note an app object exists. Useful if you want to remember specific apps (for example to launch them yourself). This is called during initialization, so you should not immediately attempt to use the app object until initialization completes.
Exclude an application completely from all UI, even if it would normally be included.
Include an application, even if it would normally be excluded. For example, a platform might exclude applications intended for a different platform.
Force an app to be included in the "Favorites" view
Force an app to be excluded from the "Favorites" view
These APIs all allow the apps shown in a particular view to be sorted or filtered. You should modify the array of apps in place.
Note that the "Favorites" view supports user rearrangement by default, so sorting the list here may be confusing unless you also disable the user rearrangement.
These are low-level catch-all functions intended to help tweak a UI that misbehaves. Strictly redraw is under the whim of the browser, so this really means before/after significant UI events, such as change of view. Generally, there are more specific callbacks on UI change.
Called prior to displaying the details page for an app. Useful to tweak the buttons/information to be displayed.
Called on the Store view if the folder is changed, passing the path. Also called passing "" if a non-folder view is selected on the store view.
Called if the view changes.
Called when HTML is generated for one or more app tiles, passing the parent container. Intended for deep customization. (Warning: this sort of change is likely to be version specific)
Called whenever the UI is considering showing a native dialog, rather than a web dialog for a message. You can return false to force the web dialog to be used. Note that some error messages originate in native code and cannot be redirected to the web UI.
Allow override of the (web) dialog used for all error and similar messages, to enable a replacement function to be used.
Overrides the HTML markup for app tiles. You can call the default function and then modify the markup, or return custom markup. The return value must be a string. (StoreFront 3.5 and later)
Provide custom HTML markup for featured app group tiles. The return value must be a string. (StoreFront 3.5 and later)
Overrides the HTML markup for folder tiles. You can call the default function and then modify the markup, or return custom markup. The return value must be a string. (StoreFront 3.5 and later)
Force inclusion of an authentication method, by returning true
Force exclusion of an authentication method, by returning true
Return true/false to enable/disable the menu item
Return true/false to enable/disable the menu item
Return true/false to enable/disable reconnection at startup. Note that reconnection at startup is not supported on all platforms.
Return the action to be taken with regard to ICA sessions during logoff.
Return one of "disconnect", "terminate" or "none"Detailed hooking of logoff steps
The first phase of logoff is to handle ICA sessions.
Return one of "disconnect", "terminate" or "none"
The second phase of logoff is to exit the web session from the server.
Return false to prevent web session termination.
The third and final phase of logoff is to terminate any gateway sesson.
Return false to prevent gateway session termination
Called once logoff has completed.
Show a message box. Data contains messageText, messageTitle, okButtonText, cancelButtonText, okButtonAction, cancelButtonAction
Inform Receiver that custom elements have changed size, and that it may need to update the UI layout.
Send a trace message to the underlying trace system.
Refresh application lists from server. May have side effects, such as reconnection and/or causing authentication prompts.
Change the current view being displayed. For views added by extensions, also supply a title to be displayed.
Note that changing to the "appinfo" view will show the app info of the last app for which info was displayed - or return to the home screen if this is no longer valid. Changing to the "search" view is not supported.
Change the current folder being displayed. View should be "store".
Toolbar buttons are only shown on "apps" view by default.
Add an additional view button alongside Favorites, Desktops and Apps.
Add a button to the app info view.
Add a help button to the UI header.
Get an item from web local storage or the native equivalent. The callback function will be called passing the value, and this may return asynchronously.
Set an item in web local storage or the native equivalent. The name and value should be strings. The callback is called once the value has been stored.
Open a URL in a new web browser tab, or using the default web browser application.
Proxy a request to a web service. 'options' is a subset of the jQuery ajax() request options.
Note that this is recommended only for access to the server hosting the Receiver UI. Access to other servers may be limited by browser and/or native security policies.
Enable subscription (and extended app) properties when communicating with the server.
Update the subscription properties stored on the server for an app to match the in memory object. The callback function is called on completion, passing a status string.
Launch an app or desktop.
Given an array of app objects, displays the corresponding app icons in the UI. (StoreFront 3.5 and later)