Add a link element to an item

We add a link element to a site area or content item when we want a link to be used for a specific site area or content item.

We can only add an element to a content item if the manage elements button has been enabled in the authoring template used by the content item.

1. Open or create a site area or content item.

2. Click Manage Elements .

3. Select Link as the element type.

4. Enter a name. Do not use double-byte and non-ASCII characters.

5. Enter a display title to use as the title of the element displayed indexes and forms.

6. If we have created a text provider plug-in for a multi-locale site, we can also select the text provider and enter a key to look up a string from the selected text provider. The text provider displays a different display title for each language it has been configured for. The text entered in the Display Title field is only used if an appropriate display title is not available from the selected text provider, or if the text provider is not available.

7. Click OK. The link element is added to the form.

8. Go to the link element created.

9. Either click Browse Content to select a content item, file resource component, image component or link component to link to, or enter a URL in the URL field. The inserted URL will be rendered relative to the URL of the site area of the currently rendered content item. Internet protocols, such as "http://" should be added at the beginning of the inserted link if an absolute URL is intended to be rendered.

10. Select a link display type:

    Text

    We select this to display the link as text.

    • Use name of linked item: We select this to use the title of the item being linked to as the link text.

    • Link text: Enter the text to use as the link text. To enter text we must unselect Use name of linked item.

    Image Component

    We select this to display the link as an image. Click Select Image to select an image component to use as the link image.

11. Enter a description of the link by selecting either:

    Use description of linked item

    We select this to use the description of the item being linked to as the link description.

    Enter description

    We select this to enter the text to use as the link description. To enter a description we must unselect Use description of linked item.

12. Select a link target:

    Name

    We select this to specify the name of the link target.

    New Window

    We select this to open the link in a new browser window.

    None

    Select this to specify no link target.

    Parent

    We select this to open the link in the parent frameset of the frame the link appears in, replacing the entire frameset.

    Self

    We select this to open the link in the current frame, replacing the content in that frame.

    Top

    We select this to open the link in the current browser window, replacing all frames.

13. Enter additional attributes, such as style sheet classes or javascript. These are used as if entering an attribute in a "<a href=" "></a>" tag. For example:

    • To create the link tag , <a class="classname" href="http://www.ibm.com"></a> we would enter class="classname" in the Additional attributes field.

    • To create the link tag , <a name="homepage" class="classname" href="http://www.ibm.com"></a> we would enter name="homepage" class="classname" in the Additional attributes field.

14. Save the item form.

Parent Use a link element