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 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 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 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 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 Select.

To add multiple components from proposal sections:

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

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

1. Click 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 Select.

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

1. Click 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, click 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 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 Save. You can also click 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 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 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 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 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 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 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 the context menu (vertical dots).
2. In the menu, select Remove group.