# orion.page.link

The link service provides a mechanism for plugins to add links that should appear in the main header of Orion pages. Clients supply the link name and URL. The header code will look for implementors of this service when generating page headers for Orion.

## Service methods

None.

## Service attributes

Implementations of `orion.core.linkScanner` must define the following attributes:

name
  A human readable link name, typically used as an HTML anchor element body, or in a tooltip.
id
  A symbolic id for referencing this link.
href
  The anchor's hypertext reference. This should be an absolute URL because the service implementation won't know anything about the position of the pages that may choose to insert this link.

## Examples

The following snippet defines the main links that are shown in a default Orion installation.

      var serviceImpl = {};//no service methods required
      provider.registerServiceProvider("orion.page.link", serviceImpl, {
         name: "Navigator",
         id: "orion.navigator",
         href: "/navigate/table.html#"
      });
      provider.registerServiceProvider("orion.page.link", serviceImpl, {
         name: "Sites",
         id: "orion.sites",
         href: "/sites/sites.html"
      });
      provider.registerServiceProvider("orion.page.link", serviceImpl, {
         name: "Repositories",
         id: "orion.repositories",
         href: "/git/git-repository.html#"
      });