Home Page Layout File

The layout file (default.layout) defines the number, type, and location of the widgets used in the home page. The layout file is stored in HomePageLayouts folder (located on the web server under \Inetpub\wwwroot\AITLive\HomePageLayouts).

The home page layout file defines each of the widgets used on the home page:

title
control type
image icons used in the title
position on page and size (measured in pixels)
additional parameters specific to the widget's content (for example, TopicDisplay includes the topic's object code, WebDisplay includes the web page URL or path to the HTML file, and TopicSearch includes the search parameters)

Any number of HomePageControlInfo elements can be placed in a home page layout file, and configured with the following properties:

Parameters	Optional	Description
Title	Yes	Title text to display in the widget title area.
Control	No	The type of widget to display: WebDisplay, TopicSearch or TopicDisplay
Position	Yes	The order to display the widgets. 0=first. The order of configuration file does not have to the same as Author-it Live Home page display.
Width/Height	No	Width and Height in pixels of the widget.
Parameters	No	Dependent on the type of widget being displayed (as entered in the Control property).

Example:

<?xml version="1.0" encoding="utf-8"?>

<HomePageLayoutInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <ControlInfo>

     <HomePageControlInfo>

      <Title>Welcome to Author-it Live!</Title>

      <Control>TopicDisplay</Control>

      <Icon></Icon>

      1</Position>

      <Width>765</Width>

      <Height>75</Height>

      <Parameters xsi:type="TopicDisplayParameters">

        <ID>601</ID>

      </Parameters>

    </HomePageControlInfo>

    <HomePageControlInfo>

      <Title>Getting Started</Title>

      <Control>WebDisplay</Control>

      <Icon>/HPI/blackboard.png</Icon>

      2</Position>

      <Width>370</Width>

      <Height>130</Height>

      <Parameters xsi:type="WebDisplayParameters">

        <Url>HomePageLayouts/MyHomePage/GettingStarted.htm</Url>

      </Parameters>

    </HomePageControlInfo>

  </ControlInfo>

</HomePageLayoutInfo>

Naming the layout file

When you log in to a single library you can either name the file default.layout or you can rename the file so it uses the library alias, for example, Acme.layout.

If you access more than one library through your Author-it Live installation you can create a different home page for each library. In this case, ensure you name each layout file using the alias for that library.

Home Page Layout File

Parameters

Optional

Description

Example:

Naming the layout file

See Also