Modifying the default IAG portal home page

  • Article

Applies To: Intelligent Application Gateway (IAG)

Whale Communications Intelligent Application Gateway (IAG) 2007 is supplied with a ready-made portal home page. This section describes how you can customize the default portal home page in order to match your corporate requirements. For information about creating a custom portal home page, see Creating a custom IAG portal home page.

Settings for the default portal home page are stored in files located in the \Whale-Com\e-Gap\Von\PortalHomePage folder. The following table summarizes the folders located under the PortalHomePage folder.

Folder Contents

PortalHomePage/css

Default style definitions

PortalHomePage/css/css/CustomUpdate

Custom style definitions

PortalHomePage/css/Images/CustomUpdate

Custom image files

PortalHomePage/inc

Default content definitions

PortalHomePage/inc/CustomUpdate

Custom content definitions

PortalHomePage/Languages

Default language definitions

PortalHomePage/Languages/CustomUpdate

Custom language definitions

PortalHomePage/Samples

Sample content definitions

You customize the page by changing .inc files that you place in the \Whale-Com\e-Gap\inc\CustomUpdate folder. Before you make changes, ensure you read "Before you begin" in Customizing IAG client endpoint Web pages.

You can modify the following settings on the default portal home page:

  • Customize the toolbar and logo of the page

  • Use custom graphics

  • Change fonts and colors in style sheets

Modifying the default portal home page

Modify the default portal home page as follows:

To customize the default home page

  1. Either open the relevant sample .inc file (located in the \Whale-Com\e-Gap\Von\InternalSite\samples folder), or create a new .inc file.

  2. Customize files and parameters by modifying the relevant .inc file. Files are described in the section "Customizable files and parameters".

  3. Save customized.inc files in the relevant CustomUpdate folders.

  • Figure 10 illustrates the visual items that can be customized on a portal home page running on a client endpoint computer.

  • Figure 11 illustrates the visual items that can be customized on a portal home page running on a client endpoint handheld device.

The portal name and application properties are not modified when you customize the default portal home page. These properties are defined in the portal trunk.

Figure 10. Sample portal home page on client endpoint computer

37388a89-3f8c-4260-884f-b1d47ed999ba

Figure 11. Sample portal home page on a client endpoint handheld device

4f980ce8-9a67-4180-acba-39a3583bc5ac

Notes

  • If you create your own files, ensure you use the same parameter names as those used in the supplied .inc files. If names are not identical, definitions may not be effective.

  • Place custom graphics in the folder \Whale-Com\e-Gap\Von\PortalHomePage\Images\CustomUpdate. When you modify a graphic (.gif) file, the name of the file must correlate with the name defined in the relevant .inc file. Change the path of the .gif file in the relevant .inc file to point to the PortalHomepage\Images\CustomUpdate folder. Ensure that you make changes to the .inc file in the inc\CustomUpdate folder.

Customizable files and parameters

Usage File (ID) and Parameter (ID correlates with that used in the sample customDefault.inc file) Save custom file in

URL users access when clicking the address defined in logo.inc

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(1) logoLink

Whale-Com\e-Gap\PortalHomePage\inc\CustomUpdate

Toolbar background color

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(2) toolbarBgColor

Whale-Com\e-Gap\PortalHomePage\inc\CustomUpdate

Toolbar logo image

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(3) toolbarImageSrc; toolbarImageLink

Whale-Com\e-Gap\PortalHomePage\inc\CustomUpdate

Enable and disable the System Information button

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(4) enableSystemInformation

Whale-Com\e-Gap\PortalHomePage\inc\CustomUpdate

Enable and disable the Information page button

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(5) InformationPage. To enable this button, place the information page in the CustomUpdate folder and specify the URL in the InformationPage parameter. This feature is available on client endpoint computers. It is not available on client endpoint handheld devices.

Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate

Enable and disable the Browse additional applications button

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(6)enableBrowseAdditionalInternalLocation. This feature is available on client endpoint computers. It is not available on client endpoint handheld devices.

Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate

Enable and disable the E-mail system administrator button and define e-mail address

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(7) administratorMailAddress. If no address is defined, the button is not displayed in the toolbar. This feature is available on client endpoint computers. It is not available on client endpoint handheld devices.

Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate

Control the appearance and functionality of the Whale Client Component Installer

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(8) enableOffLineInstallation. Enable and disable the Whale Client Components Installer button; offlineInstallationURL. Define which installation file is downloaded to the client endpoint computer. This setting is only visible on client endpoint computers running a Windows operating system.

Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate

Enable and disable the use of the IAG portal and toolbar from within another application.

Whale-Com\e-Gap\von\PortalHomePage\inc\customDefault

(9) embeddedPortal. Enabling this option results in the following changes on the client endpoint:

  • Logoff button is not displayed in the portal

  • Session timeout and scheduled logoff features are disabled.

This feature is available for client endpoint computers only. It is not available on client endpoint handheld devices.

Whale-Com\e-Gap\von\InternalSite\Images\CustomUpdate

Modify the position of the logo displayed in the top left hand corner of the page

Whale-Com\e-Gap\von\PortalHomePage\inc\Logo.inc (for client endpoint computers)

Whale-Com\e-Gap\von\PortalHomePage\inc\PDA_Logo.inc (for client endpoint handheld devices)

Whale-Com\e-Gap\von\InternalSite\Images\CustomUpdate

Modify style definitions such as fonts and colors

Whale-Com\e-Gap\von\PortalHomePage\css\customUpdate\portal.css (for client endpoint computers)

Whale-Com\e-Gap\von\PortalHomePage\css\customUpdate\PDAportal.css (for client endpoint handheld devices)

Whale-Com\e-Gap\von\InternalSite\css\CustomUpdate