Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

The "Anchor" button

The "Anchor" button is located in the "Special Tools" area of the OE toolbar. The following image reveals how this button looks like.

The "Anchor" button

The "Anchor" button

A hyperlink may refer not only to a whole document but also to a specific part of the document itself. You need to mark the fragment before you can link to it. To do this, insert an anchor in the beginning of the fragment. When creating a hyperlink referring to this fragment, append the hash character (#) and the anchor name to the URL. Please note that the anchor names must be unique within the same page/document/object. When generating XHTML code, the system will use the "a" tag for anchors. This behavior is dictated by the "/design/standard/templates/content/datatype/view/ezxmltags/anchor.tpl" template.

Inserting an anchor

  1. Position the cursor at a place where you wish to add an anchor and click the "Anchor" button. You can also right click at this location and choose the "Insert anchor" item from the context menu. You will see a modal dialog called "Insert anchor". This dialog is shown in the screenshot below.

    The "Insert anchor" dialog.

  2. Specify the anchor name and click the "OK" button. The inserted anchor will appear as a special icon in the OE text area. The following image shows how this icon looks like.

    The "Anchor" icon

    The "Anchor" icon

Changing the anchor's name

  1. Click on the anchor in the OE text area so that it will become a selected element.
  2. Click the "Anchor" button. The "Insert anchor" dialog will be displayed. You can change the anchor name using this dialog. Click the "OK" button when done.

Please note that you can also edit the anchor by right clicking on it and choosing the "Properties" item from the context menu.

Using anchors together with internal links

It is possible to link to a specific part of an object which is referred to by an internal link through either the "eznode://" or the "ezobject://" notation. The following example explains how this can be done.


Let's say that you have an anchor called "Steve" inside an article called "Apple", you can insert a link directly to the "Steve" position in the "Apple" article from another article called "Banana":

  1. Open the "Banana" article for editing and create a link using either the "Link" button or the context menu.
  2. In the "Insert link" dialog choose either "eznode:" or "ezobject:" and click the "Browse" button. Find and select the article called "Apple" and click the "OK" button. The address of the "Apple" article will appear in the URL field, for example like this: "eznode://113".
  3. Modify the URL by appending the hash character "#" and the anchor name "Steve" to the address:
  4. Click the "OK" button to exit the dialog, the link will be created. When this is done, your visitor will be able to jump to the "Steve" position inside the "Apple" article from within the "Banana" article.

Please note that you can type the link address directly into the URL field without having to choosing a link type first.

Svitlana Shatokhina (20/12/2005 1:40 pm)

Svitlana Shatokhina (11/05/2007 9:26 am)

Balazs Halasy, Svitlana Shatokhina


There are no comments.