Using and configuring web parts

This page describes how to work with web parts when editing Portal Engine templates for administration interface pages.

To edit the web part content of a template:

1. Open the Administration interface application and switch to the Page templates tab.
2. Select a template in the tree and switch to the Design tab.

Alternatively, you can design templates directly when editing UI elements (for elements whose content is based on a template):

1. Open the Modules application.
2. Edit a custom module.
3. Open the User interface tab.
4. Select a UI element in the tree and switch to the Design tab.

The Design tab allows you to view the structure of the page's template and manage the template's web parts.

Adding web parts

From the web part toolbar

The most direct way to add a new web part to the template is provided by the web part toolbar, which appears on the right side of the Design tab:

1. Find the required web part in the toolbar's list – you can use two approaches:
   • Type the name of the web part or its part into the search box. The toolbar searches for both individual web parts and entire categories.
   • Select a web part category at the top of the toolbar.
2. Drag the web part from the toolbar and drop it into the desired location in one of the template's web part zones.

Using zone actions

If you do not wish to use the toolbar, you can add new web parts into specific zones:

1. Right-click the header of the required zone, or click the zone's menu icon ().
2. Click Add new web part in the menu.

The Select web part dialog opens, which contains a catalog of all available web parts. Locate specific web parts by browsing through the category tree or using the search. Click Select to confirm your selection.

Configuring web parts

When you add a new web part instance into a zone, using either the toolbar or the zone action buttons, the Web part properties dialog opens. Here you can set up the behavior of the web part by entering values into its properties.

To open the configuration dialog for existing web part instances, double-click the web part's header on the Design tab or open the web part's menu () and select Configure. You can also edit properties for entire Web part zones by double-clicking their header.

Moving web parts

To relocate a web part to different positions or to other zones, drag the web part's header to the desired location.

Alternatively:

1. Right-click the web part's header.
2. Hover over Move to.
3. Select one of the options to move the web part up/down in the current zone, or to one of the other zones on the template.

To move all web parts in a specific zone:

1. Right-click the header of the zone.
2. Hover over Move web parts to.
3. Select the target web part zone.

Copying web parts

Copying allows you to duplicate web parts and paste them into any web part zone.

You can copy:

• Individual web parts – right-click the web part's header, click Copy
• All web parts in a zone – right-click the header of the zone, click Copy all

The system saves the web parts and their configuration into an internal component clipboard. To paste the copied web parts into a zone, choose the target location:

• At the end of the zone – right-click the header of the zone, click Paste
• Directly below a specific web part – right-click the given web part's header, click Paste

You can paste the web parts any number of times. Copying different web parts overwrites the clipboard content. Every user in the system has their own separate clipboard.

Removing web parts

To remove existing web part instances from the page template:

• Right-click the header of a specific web part and select Remove.
• To remove all web parts in a zone, right-click the zone header and select Remove all web parts.

Finding where specific web parts or widgets are used

You can see which objects use a specific web part or a widget. The objects are:

Web parts

• Page templates
• Web parts – for inheriting web parts
• Widgets – for widgets based on the web part

Widgets

• Page templates
• Dashboards

To find specific web part or widget usage

1. Open the Web parts (or Widgets) tab in the Administration interface application.
2. Select a specific web part (or widget).
3. Switch to the Usage tab.
4. Here, you can see listed the objects that use the web part.

Resolving web part errors

In rare cases, web part errors may prevent the Design tab from working correctly. For example due to invalid configuration of a web part or when testing custom web parts.

You can fix the page by manually editing the web part XML source of the page template:

1. Open the Administration interface application and switch to the Page templates tab.
2. Edit the given template.
3. Open the Web parts tab.
4. Remove the source of the error by editing the XML data.
   • You can modify the values of properties for all web parts on the template.
   • You can remove web parts from the template by deleting entire <web part> elements.
5. Click Save.