The form-based content editor

The form-based editor is the standard editor for XML contents. It opens when you click the pencil at a content element in the page editor, or when you edit an XML content from the workplace. The editor shows all content fields in an intuitivly editable way. Dependent on the type of the content field, special editor widgets are used.

Figure [content_editor_example] shows a content opened in the form-based editor. In the example you see:

• The structure of the content is reflected in the editor's appearance. The order of the editor fields reflects the order of the schema elements and nested schema elements are displayed as nested editor fields, e.g., Text is nested inside of Paragraph.
• Content fields are grouped into several tabs.
• Content values of different types are edited via different widgets - compare for example the editor fields for Title, Text and Image values
• Optional fields (as Teaser) are shown in gray if not provided
• If fields can appear more often than already present, a is shown to add more fields
• If fields are not mandatory they can be cut, clicking the symbol.
• The editor shows the content in one language. The language can be switched via the language selector in the toolbar.

To edit a content, just click on the editor field displaying the content value you want to edit. Then, it depends on the widget used for the editor field, which options you get for editing. Typically, each widget is intuitive and you should not need extra information on how to use it. For more information on the available widgets, and on how to configure them, see here.

The form-based editor's toolbar provides options to store, and publish content, to close the editor and to handle multiple languages. Here are the options one by one.

In the following sections, we discuss several details of the form-based content editor. Here we only briefly hint on some things that may be discussed in detail below.

When you edit content, or latest when something behaves "strange" in your eyes, you should be aware that:

• You are editing the content in a specific language. Is it the right language?
• Editor fields may depend on each other, e.g., changing the value of one field will change the value of another field. (Probably rarely the case)
• The editor may be configured such that a field is synchronized for all languages. I.e., if you update the field, it is updated in all languages.
• Values may be verified and you may get warnings or error messages. If an error exists, you can not store the content.
• When you click Publish , the content is first stored, even if publishing fails, the changes in the content are stored.
• When you click Publish , the changes in the content are published for all languages.

When you edit content values, fields you edit may get highlighted yellow or red. If so, the entered value does not comply with the intended format. Usually, you also get a warning or error message shown.

When errors or warnings appear in tabs, the tab is highlighted accordingly - either yellow or red. Errors or warnings in other languages you cannot see directly.

But, what's the difference between errors and warnings? Warnings you can simply ignore, but errors will prevent saving changes. The save buttons will be deactivated when an error is present and pressing publish will result in an error message.

When you edit a content, you can potentially always edit it in multiple languages. But, when you create a new content, it is created only in one language. This language depends on the locale of the page where you add the content. E.g., if you add a content on an english page, it will be available in english.

If you want provide your content in more than one language you can:

• Add a new language version with default values: In the form-based editor's toolbar, you can switch the language. If a language is marked by "[-]" in the language selector, it does not exist yet. It is created with the default values if you switch to that language.
• Copy the values of your currently edited language to another language: Use the "Copy locale" option () from the toolbar and select to which language you want to copy the values from the current language to. With the "Copy locale" function, you can also overwrite already existing language versions.
• Delete an exisiting language version: If more than one language version is present, you can delete language versions. To do so, switch to the language you want to delete and press "Delete locale" () in the toolbar.

For each content type, it can be configured that special fields of the content should be the same in all languages. This may in particular be used for images or links.

If a content is edited outside of the form-based or the inline editor, it may happen that usually synchronized values are out of sync. To sync them again, use the "Synchronize" button in the "Copy locale" dialog. Then all fields that should be synchronized are set to the values of these fields in the currently edited language. Note that the "Synchronize" button only appears in the "Copy locale" dialog if there are synchronized fields defined.