Manual Chapter :
Advanced Customization Using Templates
Applies To:
Show Versions
BIG-IP APM
- 15.1.10, 15.1.9, 15.1.8, 15.1.7, 15.1.6, 15.1.5, 15.1.4, 15.1.3, 15.1.2, 15.1.1, 15.1.0
Advanced Customization Using Templates
About Advanced Customization view
Through the Advanced Customization view, you can directly edit PHP, CSS, JavaScript, and HTML
to control the display and function of web and client pages in Access Policy Manager. You can use the built-in editor to edit files, or you can copy and paste with an
editing application of your choice.
Editing files in Advanced Customization view
Edit files in Advanced Customization to configure
settings not easily set using General Customization.
- On the Main tab, click .The Customization tool appears in Advanced Customization view, displaying theForm Factor: Full/Mobile Browsersettings in the left pane.
- Select the resource type folder forAccess Profiles,Per Request Policies, orWebtops.
- Navigate through the folder hierarchy to find the file you want to edit, and click it.For example, you can edit any of the files associated with Logon pages, Logout, Ending pages, Decision pages, Messages pages, or OAuth Authorization pages that are used in the access profile or per-request policy. Or, edit the files associated with Webtops.The file appears in the built-in editor pane, with simple syntax highlighting.
- Make the changes you require to the file. You can make changes in the editor screen, or you can edit in an external editor using copy and paste commands for your operating system.
- To save a draft of your changes without applying them, click theSave Draftbutton.
- To discard any changes saved with theSave Draftbutton, clickRevert, and follow the instructions on the confirmation dialog box.
- After you customize settings, click theSaveicon at the top of the Customization tool.
Files for access profiles in Advanced Customization
You can customize the following files for access profiles
in Advanced View. The files may differ depending on whether you created the access profile or
per-request policy with the
Customization
Type
set to Modern
or
Standard
. In that case, separate
tables are provided for Modern and Standard.Common - Modern
Files |
Location |
Description |
|---|---|---|
user-common.css |
The CSS code that controls the
look and feel for every page in the policy. |
|
user-common.js |
Common Javascript file that is
loaded for every page in the policy including various versions of the Logout Page (instead
of Request Blocked). This page is not intended to contain sensitive information. |
Common - Standard
Files |
Location |
Description |
|---|---|---|
apm_full.css |
The CSS and PHP code that controls
the look and feel for pages on a web browser. |
|
header.inc |
Specifies the page header content
for access profile pages on all devices. |
|
apm_mobile.css |
The layout properties for access
policy pages on any mobile device that is not a PocketPC. |
|
javascript_disabled.inc |
Specifies content that is
displayed if scripts are not supported, or are disabled in the user's browser. |
|
footer.inc |
The include that specifies the
footer text line. |
|
apm_mobile_ppc.css |
The CSS that controls the look and
feel for pages on a PocketPC device. |
|
apm_edge.css |
The CSS that controls the look and feel for BIG-IP
Edge Client® pages. |
Logout or Ending Deny - Modern
Files |
Location |
Description |
|---|---|---|
user-logout.js |
or |
The JavaScript code executed when
a user logs out. |
user-logout.css |
or
|
The layout properties of the
logout page. |
request_blocked.inc |
or
|
The HTML code used when a request
was blocked. |
Logout or Ending Deny - Standard
Files |
Location |
Description |
|---|---|---|
access_notfound.inc |
or |
The HTML, JavaScript, and PHP code
that presents a page when access is not granted. |
request_blocked.inc |
or
|
The HTML, JavaScript, and PHP code
that presents a page when a request is blocked. |
urlfilter_blocked.inc |
or
|
The HTML, JavaScript, and PHP code
that presents a page when an URL filter has blocked a page. |
my.acl.inc |
or
|
The HTML, JavaScript, and PHP code
that presents a page when the access to a page is denied for one of several reasons,
including by an ACL. |
logout.inc |
or
|
The HTML, JavaScript, and PHP code
that presents a page when the user logs out. The file includes several options for
different logout reasons. |
Logon Pages - Standard and Modern
Files |
Location |
Description |
|---|---|---|
http_401.inc |
The page that appears when an HTTP
401 error (unauthorized) occurs. |
|
user-logon.css |
The layout properties of the logon page. |
|
view.inc |
Specifies the customization of VMware View logon page |
|
user-logon.js |
The Javascript that is executed
when users logon. |
|
citrix_challenge.inc |
The message that displays during a Citrix logon issue. |
Files for webtops in Advanced Customization
You can customize the following files for webtops in
Advanced View. The files differ depending on whether the webtop was created for a policy with
the
Customization Type
set to
Modern
or Standard
.Webtops - Modern
Files |
Location |
Description |
|---|---|---|
user-webtop.js |
The JavaScript code that specifies
how the webtop page is dynamically created. |
|
user-webtop.css |
The CSS that controls the look and
feel for the webtop screen. |
|
hometab.inc |
The JavaScript code that controls
the look and feel for the Home tab. |
Webtops - Standard
Files |
Location |
Description |
|---|---|---|
desktopClass.js.inc |
The JavaScript code that specifies
how the webtop page is dynamically created. |
|
webtop_popup.css |
The CSS that controls the look and feel for the webtop popup screen. |
|
webtop_help.inc |
The HTML code on the webtop page that provides the link to the webtop help
page. |
|
sna_container_ui.js.inc |
The Javascript code for the user interface for standalone network access such as
if the popup was blocked, network access failed to start, installation required, or
auto-start not supported. |
|
sapptun.js.inc |
The Javascript code for the user interface for the application tunnel for network
access. |
|
hometab.inc |
The JavaScript code that controls the look and feel for the Home tab. |
About advanced customization templates
Access Policy Manager advanced customization templates provide code and
images for customizing pages. With the templates and the instructions provided for them, you can
walk through step-by-step instructions and produce pages with a unique look-and-feel using
features that are frequently requested.
For downloading APM advanced customization templates, refer to the DevCentral page.
For APM Advanced Customization examples with Modern Template for BIG-IP
version 15.1 and above, refer the APM Advanced Customization Examples with
Modern Template page.
