Using Dynamic pages

Page versions

Create a page version for a dynamic page

To create a page version for a dynamic page, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to create a page version: the Dynamic page rules and Page versions panes open.

   

3. Optional: From the Dynamic page rules pane, add a data source filter for the page preview.

4. Optional: From the Dynamic page rules pane, create, edit, or duplicate a dynamic page rule.

5. From the Dynamic page rules pane, in the Page rules section, select the page rule with which you want to associate the page version.

6. In the Page versions pane, click + New page version: the Create page version dialog opens.

7. In the Create page version dialog, do the following:

   1. In the Page version name field, enter the name of the page version. Make sure to choose a relevant name so that it will be easy to find the page version in the future.

   2. From the Layout drop-down, select a layout or a page template.

   3. To display the page version for specific locales only, select the locale(s) from the Locale drop-down: the page version will be visible for all selected locales. Otherwise, leave the Locale field empty.

      The Locale drop-down is displayed only for projects with more than one locale.

   4. To handle advanced filtering based on locale, enter a FECL expression in the Custom field. For example, to display the page version for all locales except de_CH, enter locale != "de_CH".

   5. To make the page version the default, select the checkbox.

   6. Click Save: the page builder opens.

8. Edit the page version as desired. You can preview it if you added a data source filter for preview in the earlier steps.

9. Click Save or select the saving option from the drop-down. Then, click the back arrow to return to Dynamic pages.

Edit and manage a page version for a dynamic page

After creating a page version for a dynamic page, you may need to edit or manage it. For example, to change a layout element, to make the page version live, or to delete it. To do so, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to edit/manage the page version: the Dynamic page rules pane opens.

3. In the Page rules section, select the page rule with which the page version is associated.

4. In the Page versions pane, expand the section where the page version is located.

5. Hold the pointer over the page version and do one of the following:

   • Click the Edit icon to open the page builder and edit the page version's layout.
   • Click the More icon to perform other management actions.

   

Preview a page version for a dynamic page

When creating or editing a page version for a dynamic page, you may find it useful to preview the page version. To display the preview, you must add a data source filter for preview to the dynamic page.

A data source filter lets you configure the filtering parameters to retrieve data from a data source. You can add and edit a data source filter only for the data source that is set in the dynamic page's schema. The available filtering parameters depend on the data source configuration.

Let's say that in the schema of your Product search dynamic page, your development team sets the Products data source, which retrieves data from your product catalog. And let's assume that the data source configuration contains the Minimum price and Maximum price fields. In this case, you can add and edit the data source filter for the Products data source. For example, you can configure the filter to retrieve products that cost a minimum of 10 Euros and a maximum of 100 Euros.

Add a data source filter for page preview

To add a data source filter, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page to which you want to add a data source filter: the Dynamic page rules pane opens.

3. In the Data source for preview section, click Add data source: the data source filter editor opens.

4. Optional: Edit the filter's parameters.

5. Click Save: the data source filter appears in the Data source for preview section.

Edit a data source filter for page preview

To edit a data source filter, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to edit the data source filter: the Dynamic page rules pane opens.

3. In the Data source for preview section, click Edit data source: the data source filter editor opens.

4. Edit the filter's parameters.

5. Click Save.

Dynamic page rules

Create a dynamic page rule

To create a dynamic page rule, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to create a page rule: the Dynamic page rules pane opens.

3. Click + New rule: the Create dynamic page rule dialog opens.

4. In the Create dynamic page rule dialog, do the following:

   1. In General settings > Name, enter the name of the rule.
   2. In Entity rules > Entity criterion, enter the FECL expression.
   3. In the Data source section, click + Add data source filter and select the data source to get data from: the data source filter editor opens. Configure your data source filter and click Save to return to the Create dynamic page rule dialog.
   4. Set the configurations for the other sections.

5. Click Save.

Edit a dynamic page rule

To edit the settings of a dynamic page rule, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to edit the dynamic page rule: the Dynamic page rules pane opens.

3. In the Page rules section, select the dynamic page rule to edit.

4. Click the Settings icon: the Dynamic page rule settings dialog opens.

   

5. In the Dynamic page rule settings dialog, edit the settings as desired. For example:

   • In General settings > Name, edit the name of the rule.
   • In Entity rules > Entity criterion, enter or edit the FECL expression.
   • In the Data source section, edit or delete an existing data source filter or add one from the data source filter editor.

6. Click Save in the Dynamic page rule settings dialog.

Duplicate a dynamic page rule

If you want to create a dynamic page rule from an existing one, you can duplicate the latter. To do so, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to duplicate the dynamic page rule: the Dynamic page rules pane opens.

3. In the Page rules section, select the dynamic page rule to duplicate.

4. Click the Duplicate icon: the Save new dynamic page rule as draft dialog opens.

5. In the Save new dynamic page rule as draft dialog opens, edit the duplicated settings as desired. For example:

   • In General settings > Name, edit the name of the rule.
   • In Entity rules > Entity criterion, enter or edit the FECL expression.
   • In the Data source section, edit or delete an existing data source filter or add one from the data source filter editor.

6. Click Save in the Save new dynamic page rule as draft dialog.

Delete a dynamic page rule

To delete a dynamic page rule, follow these steps:

1. From the Studio home page or from the left menu, go to Dynamic pages.

2. From the dynamic page list, select the dynamic page for which you want to delete the dynamic page rule: the Dynamic page rules pane opens.

3. In the Page rules section, select the dynamic page rule to delete.

4. Click the Delete icon: the Delete dynamic page rule? dialog opens.

5. In the text box, enter DELETE.

6. Click Delete.