Work with components in Sophora Web

Components are the building blocks of your documents. Examples: Images are components of an image gallery. Teasers are components of a homepage. Each component references a document.

You can adapt a component to the context by overriding some of its original content, for example the alternative text of an image.

Components are added to a document via component groups. A list of teasers and a playlist of videos are component groups, for example. Component groups can have settings of their own.

To manage components, open a document and switch to the tab Components.

Adding components

To add a component via search:

1. On the component group, click or tap the Plus icon.
2. In the search panel, in the tab Search, search for a document. You will only see documents appropriate for the component group. To apply filters, click or tap the filter icon in the search box.
3. Select a document. The search panel closes.

To add a component from proposal sections:

1. On the component group, click or tap the Plus icon.
2. In the search panel, in the tab Proposals, browse to find a document. You will only see proposed documents appropriate for the component group.
3. Select a document. The search panel closes.

To add multiple components via search:

1. On the component group, click or tap the Plus icon.
2. To activate multiselecting, activate Multiple selection.
3. In the search panel, in the tab Search, search for documents. You will only see documents appropriate for the component group. To apply filters, select the filter icon in the search box.
4. Select multiple documents.
5. To approve, click or tap Select.

To add multiple components from proposal sections:

1. On the component group, click or tap the Plus icon.
2. To activate multiselecting, activate Multiple selection.
3. In the search panel, in the tab Proposals, browse to find a document. You will only see proposed documents appropriate for the component group.
4. Select multiple proposed documents.
5. To approve, click or tap Select.

To add a component via search and create a component group:

1. Click or tap Add Component. 
2. In the search panel, in the tab Search, search for documents. You will only see documents appropriate for the component group. To apply filters, select the filter icon in the search box.
3. Select a document.
4. In the next panel, choose one of the component groups listed in Add to new group.
5. To approve, click or tap Select.

To add a component from a proposal section and create a component group:

1. Click or tap Add Component. 
2. In the search panel, in the tab Proposals, browse to find a document. You will only see proposed documents appropriate for the component group.
3. Select a proposed document.
4. In the next panel, choose one of the component groups listed in Add to new group.
5. To approve, select Select.

If your component is an image, you have the option to upload an image. To upload one or more images:

1. On the component group, click or tap the Plus icon.
2. In the tabbed search panel, select the tab Upload new images.
3. Choose one or more images. The dialog Upload image opens.
4. Enter image meta data.
5. Click or tap Save. You can also click or tap Publish to publish immediately.
6. Sophora creates all necessary image documents and references in the background.

Managing components in a document

To reorder the components in a component group:

1. Select and drag the component up or down.
2. Drop the component in the right position.

To move a component to another component group:

1. Select and drag the component.
2. Drop the component in the different component group. Some component groups will not be available as targets, because of their configuration. 

To remove a component:

1. On the component, click or tap the context menu (vertical dots).
2. In the menu, select Remove component.

To open the document referenced by the component:

1. On the component, click or tap the context menu (vertical dots).
2. In the menu, select Open in new browser tab.

To override a component’s details:

1. On the component, click or tap the context menu (vertical dots).
2. In the menu, select Edit.
3. In the dialog, change details. Note: Your changes will not alter the original content. You can always reset the original content with the restore icon on the right, next to each edited field.
4. Optional: To edit another component, use the arrows in the upper section of the dialog. All changes will be preserved until the dialog is closed.
5. To save, click or tap Done.

Managing component groups in a document

New component groups can only be added implicitly via Add Component (see above).

To edit the details of a component group:

1. On the component group, click or tap the context menu (vertical dots).
2. In the menu, select Edit.
3. In the dialog, edit the component group’s details.
4. To save, click or tap Done.

To reorder component groups:

1. Select and drag the component group up or down.
2. Drop the component group in the right position.

To remove a component group and all components:

1. On the component group, click or tap the context menu (vertical dots).
2. In the menu, select Remove group.