ez.no / documentation / ez publish / user manual / 3.8 / daily tasks / publishing at multiple loca...

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.

Publishing at multiple locations

The content structure of eZ Publish makes it possible to publish the same object at different locations in the tree. This means that you can for example have the same news article appear at different places on your site. Please note that this feature only works with single nodes. If you add a new location for a folder that contains several news articles, the system will only make a new location for the folder itself but not the articles.

You can either add a new location to an object that has already been published or you can publish an object at multiple locations at the same time. Please note that the first approach requires that the information has already been published. The second approach does not have this requirement because you can control the locations where the information should be published from the edit interface. The following text explains both approaches.

Adding a new location to a published object

This approach allows you to publish an already published object at a new location in the tree. For example, if you have a news article that you also wish to make available somewhere else on the site, you can simply add a new location (a node) to the object that contains the article. For this to work, you'll need to enable the "Locations" window. This can be done by clicking on the "Locations" button in the toolbar located in the top/middle of the main area. The following image shows how this window looks like.

Locations window.

Locations window.

The following text explains how you can add new locations.

  1. Navigate the node tree until you find the node (page) that you wish to make available at an alternate location. Make sure that you're actually looking at the node.
  2. Click the "Add locations" button in the "Locations" window. The system will bring up the browse interface.
  3. Use the browse interface to select the alternate location(s) where the object should be published.
  4. Click OK - the object will be published at the selected location(s) and thus it should appear at different locations in the tree.

Controlling the locations before publishing

First of all, you'll need to enable the "Locations" window. This can be done by clicking the "On" link in the "Edit mode settings" window displayed when the "My account" tab is selected.

Edit mode settings.

Edit mode settings.

When done, the object edit interface will contain an additional window at the bottom. This window will allow you to control where the object that is being edited should be published. The following image shows how this window looks like.

Locations window in edit mode.

Locations window in edit mode.

You can use this window control where the object should be published and how it should be published (sorting settings, visibility status and so on.).

In order to avoid possible conflicts when an object is edited by multiple users at the same time, the system will no longer allow to change locations via the object edit interface except the first object's version. This means that you can control locations when creating a new object but not when editing an existing one. However, it is still possible to modify location(s) of existing objects using the locations window that is displayed when viewing an object.

Balazs Halasy (08/02/2006 12:07 pm)

Balazs Halasy (31/07/2006 8:34 am)

Balazs Halasy, Svitlana Shatokhina


  • Controlling locations before publishing didn't work in 3.8.0-3.8.3

    In eZ Publsh versions prior to 3.8.4, additional locations added in the object edit interface were not taken into account when publishing, see http://ez.no/bugs/view/8438