You are here: Home Plone Book Kupu Insert Internal Link

Insert Internal Link

by Olha Pelishok last modified 2010-05-18

This article applies to Kupu 1.4 and Plone 3.0, Plone 2.5, Plone 2.1

We recommend you to watch Insert Internal links with Kupu screencast.

 

The Kupu editor allows you to create links to another objects within a Plone site, using the internal-link button on the Kupu toolbar:
toolbar-internal-link

Clicking this button launches the Insert Internal Link dialog:
insert-link-dialog

  Three columns of the dialog display:

  1. A folder navigation list.
  2. An object navigation list, from which you can select a document you want to link your object to. You may choose any content type you need. This may be a simple item - linkable (a page, image, formmailer) as well as one containing other items - collection (folder, blogfolder). In case any content type is missing in object navigation list, make sure it is selected in Kupu Resource Types (Preferences, Kupu Visual Editor, Resource Types):

    kupu-resource-type
  3. Document preview. In case selected document contains anchors you can link your object to the whole document or to the necessary part if it:
insert-link-dialog-anchor HTML code

generated will have the following look ('test'-a piece of the text that is linked to the document 'Frequently Asked Questions'):

  • if linked to the whole document:
    <a title="Frequently Asked Questions" href="faq/index_html">test </a>
  • if linked to an anchor:
    <a title="Frequently Asked Questions" href="faq/index_html#what-is-plone">test</a>

In case you activate ResolveUID functionality on your site (Preferences, Kupu Visual Editor, Kupu Configuration), then the generated HTML code will look quite differently:

  • if linked to the whole document:
    <a title="Frequently Asked Questions" href="resolveuid/97f34ebe16f7fceb2da7ec446f5b7cce">test</a>
  • if linked to an anchor:
    <a title="Frequently Asked Questions" href="resolveuid/97f34ebe16f7fceb2da7ec446f5b7cce#what-is-plone">test</a>
Document Actions
Powered by Plone