Gretyl's Portal

Heretto Help

Navigational Tiles

Tiles are navigational elements that help users easily access different sections of content. They often include visuals and short descriptions that represent the content they lead to. Navigational tiles can be added to the portal home page as well as lower portal levels.

Tiles are also referred to as cards because of their card-like presentation in portal. For example, three tiles on a portal home page could look like this.

Figure 1. Tiles in the main screen area on the portal home page.
Three square tiles on the portal home page

Tiles are created by adding sitesection elements to sitemaps. Sitesection is a specialized topichead element that can be added only to sitemaps. Each sitesection contains a topicmeta element that can contain:

  • A navtitle element for the tile title

  • A shortdesc element for a tile short description

  • A data element for a tile icon

An example of a sitesection with a title, short description, and an icon looks like this:

<sitesection>
        <topicmeta>
            <navtitle>Tile One</navtitle>
            <shortdesc>A short description of content added under this tile.</shortdesc>
            <data href="tile-one-icon.png" name="thumbnail"/>
        </topicmeta>
    </sitesection>

An example of a sitemap with three sitesections looks like this:

<sitemap>
    <title>Sitemap Title</title>
    <sitesection>
        <topicmeta>
            <navtitle>Tile One</navtitle>
            <shortdesc>A short description of content added under this tile.</shortdesc>
            <data href="tile-one-icon.png" name="thumbnail"/>
        </topicmeta>
    </sitesection>
    <sitesection>
        <topicmeta>
            <navtitle>Tile Two</navtitle>
            <shortdesc>A short description of content added under this tile.</shortdesc>
            <data href="tile-two-icon.png" name="thumbnail"/>
        </topicmeta>
    </sitesection>
    <sitesection>
        <topicmeta>
            <navtitle>Tile Three</navtitle>
            <shortdesc>A short description of content added under this tile.</shortdesc>
            <data href="tile-three-icon.png" name="thumbnail"/>
        </topicmeta>
    </sitesection>
</sitemap>

Important Considerations

  • Tiles added to the main sitemap (sitemap that holds all content published to your portal) are displayed on the portal home page.

  • Tiles added to child sitemaps (sitemaps added to the main sitemap) are displayed at lower levels of content in your portal.

  • By using the sitesection element in both main and child sitemaps or by nesting sitesection elements, you can achieve the effect where a tile on a portal page takes you to a set of tiles on a lower level page.

  • Restrictions apply to titles of the main navigational tiles (tiles visible on the portal home page). Do not use these words, phrases, or any locale codes as titles for main tiles, as they can cause navigation issues:

    • search

    • api

    • login

    • logout

    • error

    • index

    • upgrade_browser

    • locale codes (for example, en, en-us, it, it-it, fr, fr-ca)