ibexa

Path

ez publish / user manual / 3.9 / the administration interface / the object edit interface


Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

The object edit interface

Whenever a you click the "Create here" button to add content, the "Edit" button in the preview window or one of the edit icons in the sub items window, the system will bring up the object edit interface. This interface makes it possible to edit the actual contens of objects. In addition, it allows you to manage the object's versions and preview the version that is being edited. The following screenshot shows how this interface typically looks like.

The object edit interface.

The object edit interface.

The object edit interface usually consists of 5 windows:

  • Object information (1)
  • Current draft (2)
  • Translate from (3)
  • The main edit window (4)
  • Related objects (5)

The "Object information" window

The "Object information" window reveals information about the object that is being edited. The following image shows how this window looks like.

The "Object information" window.

The "Object information" window.

The screenshot reveals that the ID of the object which is being edited is 5912. The object was initially created on the 11th of January, 2005 by Balazs Halasy at 9:19 AM. The object was last modified by the same user on the 9th of May, 2005 at 12:43 PM. The object exists in several versions and it is the 3rd version that is the currently published version. In other words, it is the 3rd version that will be displayed when the object is being viewed.

The "Manage versions" button brings up the version interface which makes it possible to administer the versions of the object that is being edited.

The "Current draft" window

The "Current draft" window reveals information about the version that is currently being edited. The following image shows how this window looks like.

The "Current draft" window.

The "Current draft" window.

Every time an object is created or edited, eZ Publish will automatically create a new draft. A draft only contains the language that is being edited by the user. If a new object is being created or new translation is being added to an existing object then the draft will be empty. However, if an existing language/translation of an object is edited then the system will create a draft which contains this translation copied from the last published version.

This window simply reveals information about when the draft (which is being edited) was originally created, who created it and when it was last modified (stored). In addition, the window also reveals the actual version number of the draft.

Please note that the version number of the current draft differs from the version number of the published version (shown in the "Object information" window). The reason for this is because eZ Publish does not allow the editing of published and archived versions. It only allows you to edit drafts. When an object is edited, a new draft will be created and it is this draft that you will be able to edit.

The "View" button brings up the preview interface which can be used to generate a preview of the content that is being edited without having to publish it. When the "Store and exit" button is clicked, the system will store the draft and exit the object edit interface. The draft will be available in the "My drafts" list located under the "My account" tab. It can be re-edited at any time.

The "Translate from" window

The "Translate from" window reveals information about the existing languages and allows to select the language which the edited translation should be based on. The following image shows how this window looks like for an object that exists in English, French and Norwegian languages.

The "Translate from" window.

The "Translate from" window.

If the user selects a language using the radio buttons located in this window and clicks the "Translate" button then the main edit window will be switched to a special "translator mode" in order to make it easier to translate an object from the selected existing language.

The main edit window

The main edit window is where you can modify the contents of the different attributes that make up the object which is being edited. For example, if a news article is being edited, this window will most likely allow you to change the title of the article, the intro text and the body. The attributes will be displayed in the same order as they were set up when the class (which defines the actual data structure) was created. Required fields will have additional text "required" in the label. The following image shows how this window looks like when a documentation page is being edited.

The main edit window.

The main edit window.

In this case, there are 3 attributes that can be edited: "Title", "Body" and "Show children".

The "Send for publishing" button will attempt to validate the contents of the attributes and send the draft for publishing. If there are problems (for example invalid or missing data) then the system will indicate this using a yellow frame over the main edit window. If everything is okay, the draft will become the current/published version for the object and the previously published version will become archived. Since the draft only contains data for one language, the system will copy other languages from the last published version of this object to the draft when publishing it.

The "Store draft" button makes it possible to store the information that has been entered. This button is particularly useful when you're working on something and want to save your work from time to time. In addition, since eZ Publish will attempt to validate the input, this button can also be used to verify that the inputted data is correct according to the definitions that were set up when the class (the data structure definition) was created. Please note that the published version of the object will not change.

The "Discard draft" button makes it possible to get rid of the draft that is currently being edited. The draft will not be validated or stored, it will simply be thrown away.

The "back to edit" checkbox

The "Back to edit" checkbox can be used to change the behavior of the system. It is useful when you're working with related objects and hidden nodes. When enabled, it appears in the bottom of the edit window, near the "Send for publishing" button, as shown in the following screenshot.

The "back to edit" checkbox

The "back to edit" checkbox

When checked, the system will bring the user back to the object edit interface after the "Send for publishing" button is clicked. In other words, you can keep working on the object (publishing and editing it) without having to manually re-edit it again. Note that the state of this checkbox is not persistent, it is reset (unchecked) every time the object edit interface is displayed.

By default, this checkbox is not available in the object edit interface. It can be enabled by clicking the "On" link for "Re-edit" in the "Edit mode settings" when the "My account" tab is selected. Refer to the following screenshot for details.

Edit mode settings.

Edit mode settings.

The "translator" mode

The main edit window can be switched to a special "translator mode" so that the actual content in the selected existing language will be displayed above all the attribute fields. This makes it easier to translate an object from an existing language into a new one. The following image shows how this window looks like when a documentation page is being translated from English into German.

The main edit window when translating an object.

The main edit window when translating an object.

Balazs Halasy (01/02/2006 9:38 am)

Svitlana Shatokhina (18/06/2007 10:02 am)

Julia Shymova, Balazs Halasy, Svitlana Shatokhina


Comments

There are no comments.