List of items tile/Selected items portlet

You will need this information when you have added a List of items tile/Selected items portlet, and wish to populate it for the first time or edit it.

What is the List of items tile/Selected items portlet?

The list of items tile/selected items portlet are used for displaying links to multiple items of content from multiple sections and different content types. You can add any item of content from any section of your website into this tile/portlet. The tile/portlet is customisable and allows various different layouts and options to manipulate how you display the information.

Adding content into the List of items tile/Selected items portlet:

  1. Whilst the List of items tile and Selected items portlet perform in a similar way, the route for adding content to each is different:
    1. List of items tile;
      1. In the 'Compose' view, you will see that your List of items tile is empty (unless you are coming back to edit it!). To populate the List of items tile, you will need to drag items of content from the content chooser on the left of the compose view, into the tile. To then edit the properties of the tile, hover over the tile until you see the blue 'Edit' button in the top left, and then click on it.
    2. Selected items portlet;
      1. Click on your name in the top right of the edit bar to access the drop-down menu, ensuring that you are on the page you wish to host the ‘Events’ portlet.
      2. Select ‘Manage portlets’ from the dropdown menu.
      3. From the ‘portlets’ drop down menu, click on Selected Items.
  2. The headed sections in the Selected items portlet, and list of items tile edit interface will be:
    1. 'Content' tab:
        1. This defines how many items the tile will show, useful if you want to have a scrollable list.
          1. Full-width list - This will display items vertically, one per row, as wide as you set the column.
          2. Horizontal scrolling list - This will display the most appropriate number of items dependant on the users' screen size from the number that you add to the tile. We would recommend adding now more than eight items to the tile if you are using this display option. Arrows to scroll through the items from right to left will display on all devices.
          3. Full-width accordion - This will display items vertically, one per row, as wide as you set the column, but only the title of the item will display until the accordion is expanded to see all the details.
          4. Multi-column list - This will display numerous items in a multi-column listing, specified in the drop down menu. 
      1. 'Elements'
        1. This field allows you to drag and drop to reorder the items in the list tile, remove items from the list tile as well as defining if their title shows or not.
    2. 'Fields' tab/Content tab for portlet (Please note that whilst the Fields tab exists only on the List of items tile, it contains the same properties as the Content tab in the Selected items portlet) :
      1. 'Title mode'
        1. This gives the user some control over how the title of the tile is displayed.

      2. Items (portlet only)
        1. This is where you can search for items of content to add to the portlet.
      3. Extra fields
        1. This functionality allows the user to specify any other extra information about the listing items featured in the tile.
      4. Show lead images
        1. Check the box if you would like to show the lead images for the items of content if they are available.
      5. Lead images position 
        1. Use the dropdown menu to select the option that best suits how you would like to display the images with the content.
        2. Lead images ratio

          1. This determines the scale of the lead image in the tile/portlet

        3. Show lead images captions?

          1. If this box is checked, the captions attached to the lead image will be displayed in the tile/portlet.

    3. 'Button' tab:
      1. 'Internal link'
        1. If you choose an internal and an external link, the internal link will take priority.
      2. 'External link'
        1. This should be a fully formed URL including 'https'.
      3. 'Button text'
        1. This is the text that will appear on the button. If you do not provide text, default text will be shown e.g. 'Find out more'.
      4. 'Button alignment'
        1. This defines where on the listing the button will be located
      5. 'Button type'
        1. This defines what kind of button you want to show.
    4. 'Style' tab:
      1. 'Box Border'
        1. This feature allows the user to deploy a border of their choice on either or both sides of the tile.
      2. 'Box type'
        1. This feature allows the user to deploy a highlighted background to the portlet.

  3. When using a portlet, there is an additional headed section in the Events edit interface:

    1. Advanced;
      1. Show only for sub-items

        1. Check this box if you would like to add the portlet at a section level, and define that it shows only on all the items in the section, rather than on the section as well.

Editing content in the List of items tile/Selected items portlet:

  1. When editing the List of items tile;
    1. Go to the 'Compose' view of the Cover page, navigate to the List of items tile, and hover your cursor over it, the blue 'Edit' button will appear in the top left, click this and edit any of the fields you would like to.

  2. When editing the selected items portlet;
    1. Click on your name in the top right of the edit bar to access the drop-down menu, ensuring that you are on the correct page, which hosts the portlets in question.

    2. Select ‘Manage portlets’ from the dropdown menu.

    3. Click onto the portlet you wish to edit edit any of the fields you would like to.

Removing the List of items tile:

  1. If you wish to remove the List of items tile, navigate to the 'Layout' view of the cover page, and click 'x' in the top left of the tile. When deleting a tile, the tile you are selecting has a red border.

Removing the Selected items portlet:

  1. If you wish to remove the Selected items portlet, click on your name in the top right of the edit bar to access the drop-down menu, ensuring that you are on the correct page, which hosts the portlets in question.

  2. Select Manage portlets from the dropdown menu

  3. Click on the X button, next to the portlet you wish to delete.