Navigation Links File
The Navigation Links file contains the navigation map for the site. Use the
Navigation Editor to make changes to your site map.
XML Schema Examples
This section contains a number of examples of links in the navigation links file.
<?xml version="1.0" encoding="utf-8" ?>
<Links xmlns="http://schemas.TrackerRealm.com/AspNet/LinksFile">
<Link>
<Text>Jazz Notes</Text>
<Url>~/</Url>
<ToolTip>WiebeWorks Home Page</ToolTip>
<MenuName></MenuName>
<Sitemap Include="True">
<ChangeFreq>monthly</ChangeFreq>
<Priority>0.8</Priority>
</Sitemap>
</Link>
<Link>
<Text>Jazz Notes</Text>
<Url>~/help/jazznotes.aspx</Url>
<ToolTip>help for Jazz Notes Model</ToolTip>
<MenuName>Jazz Models help</MenuName>
<Tags>Data,Notes</Tags>
</Link>
<Link>
<Text>Powered by Jetfire</Text>
<Url>http://www.jetfire.ca</Url>
<ToolTip>Jetfire - a domain specific language designed by TrackerRealm</ToolTip>
<MenuName>Footer</MenuName>
<ImageUrl>~/images/poweredbyjetfire.png</ImageUrl>
<Target>_blank</Target>
</Link>
<Link>
<Text>Reports</Text>
<Url>~/parks/reports.aspx</Url>
<ToolTip>Reports page for Parks</ToolTip>
<MenuName>Parks</MenuName>
<MustBeLoggedIn LoginType="Jetfire">
<Roles>
<Role>Foreman</Role>
</Roles>
</MustBeLoggedIn>
</Link>
</Links>
XML Schema
This section contains the schema for the navigation file.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<Links xmlns="http://schemas.microsoft.com/AspNet/LinkList">
<Link>
<Text Comment="The text displayed for the link">WiebeWorks</Text>
<Url Comment="The navigation link">http://www.WiebeWorks.com</Url>
<ToolTip Comment="The description is displayed as a mouse over">TrackerRealm Corporation is a software company dedicated to producing business web products and services.</ToolTip>
<MenuName Comment="The name of the menu that this link belongs to"></MenuName>
<Target Comment="The window that the page is opened in. Default = '' means display in the same tab. "_blank" means display page in new tab."></Target>
<Language Comment="The language of the web part. Only displayed if the user language matches. Default = 'All languages'."></Language>
<Tags Comment="A comma-delimited list of tag names"></Tags>
<ImageUrl Comment="Used for Image option - the url to display">~/Images/JetfireLogo.jpg</ImageUrl>
<MouseOverImageUrl Comment="Used for Image option - the url to display when user mouses over the control">~/Images/JetfireLogo.jpg</MouseOverImageUrl>
<SelectedImageUrl Comment="Used for Image option - the url to display when selected">~/Images/JetfireLogo.jpg</SelectedImageUrl>
<Devices Comment="What device this is targeted at. e.g. if Devices=MobileDevices, the link will only be displayed to mobile users" Default = "AllDevices" means display on all devices.></Devices>
<MustBeLoggedIn Comment="The user must be logged in to see this link. Login may include: COR, Jetfire, or combinations. Default = '' means logged in not required." LoginType="Both">
<Roles Comment="List of Roles that are allowed to see the link">
<Role Comment="This role is allowed to see the link">WebMaster</Role>
</Roles>
</MustBeLoggedIn>
<Sitemap Comment="Used by the Google Site Map Web Part. This allows the webmaster to exclude specific links from the sitemap." include="true">
<ChangeFreq>monthly</ChangeFreq>
<Priority>0.8</Priority>
</Sitemap>
</Link>
</Links>
Definitions
Basic Navigation
Basic navigation is performed by the following fields in the navigation file.
Text
The text displayed for the link.
Url
The navigation address for the link. This may be an absolute url, e.g. 'http://www.wiebeworks.com' or a 'rooted' url, e.g. '~/pages/here.aspx'. The '~' relates to the root of the network. Relative url's may be used, but be careful, because the url is relative to where the page is located in the site.
MenuName
The name of the menu that this link belongs to. if blank, then the navigation item is a top level item. Typically, this is the 'Home' page, or the start point for the site map.
SEO Attributes
Attributes for Search Engine Optimization improve the site's ranking on google.
ToolTip
The description is displayed as a mouse over. The description is useful to the person navigating the site and to the search engine as additional information about the layout of the site.
Sitemap
Used by the
Web Part: CMS Google Site Map. This allows the webmaster to exclude specific links from the sitemap. Use include = "true" to include the link, include = "false" to exclude the link.
- ChangeFreq is used to identify how often the link should be checked.
- Priority is used to define the importance of the link within the site map.
Adding images
Images may be used in place of text for any navigation item.
ImageUrl
This attribute is used to place an image in the navigation display. This may be an absolute url or a 'rooted' url.
MouseOverImageUrl
This attribute is used in conjunction with the ImageUrl attribute. This image is displayed when the user mouses over the image. This may be an absolute url or a 'rooted' url.
SelectedImageUrl
This attribute is used in conjunction with the ImageUrl attribute. This image is displayed when the navigation item is selected. This may be an absolute url or a 'rooted' url.
Managing what gets displayed when and where¶
The webmaster can control how links, languages, devices and roles affect what the user sees.
Target
The window that the page is opened in. The default is blank and means to display the content in the active tab. "_blank" means display page in new tab. Other names, such as "my tab" are useful for keeping similar topics in the same tab.
Language
The language of the web part. Only displayed if the user language matches. The default is any language, which means that people navigating the site will automatically see the page.
Language Web Parts must be used to allow users to select what language they wish to navigate the site in.
Devices
Choose what device the page is targeted at. The default is all devices - both desktop and mobile. As the webmaster, you can build web parts targeted at mobile users vs desktop users.
Roles
Lock down web parts using the 'MustBeLoggedIn' attribute. This attribute allows the WebMaster to define one or more Roles that can see the web part content. This may include COR and/or Jetfire Roles.
The WebMaster can also use Roles to change the content depending on login, e.g. use one web part to welcome the person to the site; use a second web part to tell the person that they are logged in. This is done using 'CORDeny' and 'COR' login types respectively.
Tagging Content
Tags
Enter a comma-delimited list of tag names for the navigation item.