Administration Console: Branding Configuration Page

Customize the PeopleUpdate user interface using the Branding page to manage the site title, localization file, banner and style sheet. The settings on the Branding page apply to your entire PeopleUpdate application across all tabs.

Accessing the Branding Configuration Page

You must have administrative access to the PeopleUpdate Administration console to modify branding settings.

To navigate to the Branding page:

Log in to the Administration Console. Click here for more information about logging into the Administration Console.
Click Branding in the left navigation bar in the Global Configuration section.

Setting Site Information

You can modify the site titles that appear in the application banner and on the browser's title bar to fit your organization.

Site Title	Title text displayed on each page under your web site banner
Browser Title Bar Text	Text that displays in the browser's title bar at the top of your browser application
Localization File Path	File path to the global localization file to use for the application. This localization file acts as the default global localization file. Individual tabs can have their own localization files and tab-level localization files override the global localization file.
No Data Found Message	Text that displays on the Detailed Results page when an object cannot be found in the directory. This issue most commonly occurs when the web application security settings for the product are incorrectly configured in IIS. In this scenario, the My Info tab cannot locate the account for the authenticated user and will then display this message. In general, the message displays on the Details page when the item about which you want to display details cannot be located.
Link Options	User Display Name: Check this option to display a linkable user name in the welcome text in the upper-left part of the Task Nav of the Search Console. E-Mail Addresses: Check this option to create linkable e-mail addresses for any attributes that display an e-mail address. You can override this option at an attribute level on the Attributes management page. URIs: Check this option to create linkable URIs for any attributes that display URI. You can override this option at an attribute level on the Attributes management page. URI Target: Set the default target for linkable URIs displayed in the Search Console. You can use the default HTML options of "_blank," "_parent," "_self" or "_top." You may also enter a name for a window and all links will target the same new window.
Default Text Box Width	Default width of all edit text boxes that display. You can override this at an attribute level on the Attributes management page.

To modify site title settings:

Navigate to the Administration Console’s Branding page.
Edit the Site Title and Browser Title Bar Text fields.
Click Save Changes to update your PeopleUpdate branding configuration.

Localizing the Application Across All Tabs

PeopleUpdate allows you to localize your PeopleUpdate installation. You can provide a default localization file that will set the text on all Search Console pages in all tabs and these localizations override the default application text. This is a good configuration if you'd like to customize your Search Console and provides a default display for tabs that do not override the global localization file you set up on the Branding configuration page. You might want to use this feature if you are a multi-national corporation operating offices in locations that speak multiple languages. You can then expose PeopleUpdate to each office in their native language and consolidate administration to one PeopleUpdate instance instead of managing multiple application distributions.

PeopleUpdate localization works by reading an XML file that contains the localized text for the display elements in the application. You can put the XML localization file anywhere you’d like where the PeopleUpdate web server can access it and you can create multiple localization files for PeopleUpdate. Web Active Directory recommends that you store the localization files outside of the PeopleUpdate installation directory so the files are not overwritten during product upgrades. All you need to do is set the localization file path to the location where you saved the file.

If you do not set a localization file or if the file cannot be located for the configuration then the entire application will use the default language implementation of U.S. English. Individual tabs can override the global localization file to allow you extensive customization of the user interface from tab to tab.

To set a global localization file:

Navigate to the Administration Console’s Branding page.
Enter the path to your localization file in the Localization File Path field. You may enter the path using any path descriptor that allows PeopleUpdate to find the file, including a local path on the web server like C:\MyLocalizationFile.xml, using a UNC path like \\MyServer\MyShare\MyLocalizationFile.xml and using HTTP like http://MyServer/MyVirtualDirectory/MyLocalizationFile.xml.
Click Save Changes to update your PeopleUpdate localization configuration.

Changing the banner settings

PeopleUpdate allows you to customize the banner image that displays so you can seamlessly integrate the application into your corporate software environment.

Banner Path	HTTP path to the banner to display at the top of each PeopleUpdate page. For example, if your banner image is stored at http://www.mycompanyname.com/images/YourCompanyLogo.gif, then enter the entire previous URL to the image. We recommend that you store your custom banner image outside the virtual directory installed with the application to ensure the image isn't deleted or overwritten when you upgrade to newer versions. You can also use the default banner image located at http://<YourServerName>/<YourVirtualDirectory>/Images/Branding/WadBanner.gif, where <YourServerName> is the name of the web server on which you installed the application and <YourVirtualDirectory> is the virtual directory into which you installed. Note: You can also use a relative path to reference your image using the form /<YourVirtualDirectory>/Images/YourImage.gif.
Banner Preview	Displays a preview of the banner image you specify in Banner Path when you save the configuration changes
Alternate Text	Text displayed when a user hovers his or her mouse over the banner image
Banner Width	Forces the banner image to the width you specify; if you set this option to zero (0) for width, it will display the image at its native width
Banner Height	Forces the banner image to the height you specify; if you set this option to zero (0) for height, it will display the image at its native height

To modify banner settings:

Navigate to the Administration Console’s Branding page.
Make the appropriate changes to the Banner Path, Alternate Text, Banner Width and Banner Height fields.
Click Save Changes to update your PeopleUpdate branding configuration.

Customizing the style sheet

PeopleUpdate uses Cascading Style Sheets (CSS) technology to store display formatting for the Search Console. You can copy the default style sheet from the ~/Styles directory in the PeopleUpdate application installation directory and customize the style sheet for your organization. You should copy the style sheet to a location outside the PeopleUpdate installation directory to ensure you customized style sheet will not get overwritten when you upgrade PeopleUpdate.

Style Sheet Path

HTTP path to the style sheet you want use. For example, if your style sheet is located at http://www.mycompanyname.com/styles/YourStyles.css, then enter this for the path value. Alternately, you can use the default style sheet located at http://<YourServerName>/<YourVirtualDirectory>/Styles/MainStyle.css.

Note: Do not make changes to the default style sheet as these changes will be overwritten when the application is removed or upgraded. Instead, copy MainStyle.css outside of the virtual directory, make your changes, and then point the style sheet path to the new location. This will ensure the style sheet is not removed or overwritten when you upgrade to newer versions.

Display Table Cell Width

Sets the width of each column for data displayed on the Detailed Results and Edit pages in the Search Console. The width, defined in pixels, determines how wide each column of data displays. Set the width to 0 to expand the column width to the width of any data displayed in the column. You can use this value when you change the behavior of the Details button from the Summary Results page and you need to limit the width of the data.

To set a custom style sheet path:

Navigate to the Administration Console’s Branding page.
Enter the path to your customized style sheet in the Style Sheet Path field.
Click Save Changes to update your PeopleUpdate branding configuration.