Asset selections screen

The Asset selections screen allows you to configure the list of assets to select assets from the list and submit them. These selections can then be passed onto another asset in the system, such as an ecommerce cart.

Asset selections

This section allows you to specify whether to show radio buttons, a drop-down list, or text boxes for each asset. By default, no asset selections will be added.

To add a new selection:

  1. Enter a name into the Add new selection field

  2. Click Save

Additional fields will appear in the Asset selections section:

The asset selections section

The fields that are available in the Asset selections section are as follows.

Input style

Select the style of box to show on the asset listing page. You can select radio buttons, a drop-down list, or a text field.

Options

The following options are available.

Allow multiple selections

Select this option if you want to allow the user to select multiple assets. This option will only be used if the input style is either radio buttons or drop-down list.

Allow negative values

Select this option to allow users to enter negative values for an asset. This value will only be used if the input style is either text fields or drop-down list.

Restrict values to a range

Select this option to restrict the number of selections a user can make in the list. This value is only used if the input style is either text fields or drop-down list.

Delete

To delete a selection:

  1. Click Delete

  2. Click Save

Showing the selection on the asset listing page

Once you have created an asset selection on the Asset selections screen, you need to tell the asset listing where to show it. This action is done through a keyword replacement on the default format bodycopy.

  1. Right-click on the default format bodycopy in the asset tree

  2. Select Edit contents

  3. Add the keyword replacement for the asset selection in the WYSIWYG editor.

This keyword replacement will be in the format %<selection>_asset_selection%, where <selection> is the name of the asset selection that you created.

You can use the keyword %<selection>_asset_selection_input%, where <selection> is the name of your asset selection, which will print an HTML5 input field for the specified asset selection in a format similar to the following:

<input type="numeric" name="Purchase[16500]" value="0" size="3" min="5" max="33" step="1" id="Purchase_16500" class="sq-form-field" />

Asset targets

This section allows you to specify where to submit the selected assets on the asset listing page. For example, you can submit them to an ecommerce cart. By default, no targets will be added.

At least one target is required when using an asset selection. To add a new target:

  1. Enter a name into the add new target field

  2. Click Save.

Additional fields will appear in the asset targets section, as shown in the figure below.

The asset targets section

The fields that are available in the asset targets section are as follows.

Button label

Enter the text you want to appear on the button on the asset listing page. For example, you can enter Add to cart.

Target

Enter one of the following options:

URL

Enter the URL of the target page to which the selected asset list has to be submitted.

Asset

Select the target asset that the selected asset list has to be submitted to, for example, the ecommerce cart.

Delete

To delete a target:

  1. Click the Delete box

  2. Click Save

Showing the target on the asset listing page

Once you have created a target on the Asset selections screen, you need to tell the asset listing where to show it on the page. This action is done through a keyword replacement on the page contents bodycopy.

  1. Right-click on the page contents bodycopy in the asset tree

  2. Select Edit contents

  3. Add the keyword replacement for the target in the WYSIWYG editor.

This keyword replacement will be similar to Asset Target button (test target). The test target is the name you entered into the add new target field when you created the target.

© 2015-2020 Squiz Pty Ltd