Resource element

Lauren Lentini

January 02, 2018 19:25

Element settings

In addition to the common element settings, the Resource element includes the following configuration options.

Browse: Use this button to search for a specific file or gallery within Resources, or to upload a new resource and display in the element.

List, Grid, and Slideshow formats

Resources and Galleries/Resources/Galleries (List and Grid only): The list and grid formats have the ability to show resources only, galleries only, or both. This gives you flexibility to show some of the organizational structure of Resources. If you configure this element to show only galleries, you can link it to another Resource element to display the individual resources in that gallery.
- Include Sub-Gallery Resources: This option appears when you select "Resources" above. If you include resources in the element, you have the option to display only resources that are in that gallery, or to include resources in any galleries that exist underneath the selected gallery.
Display Resource Type(s): Use the Audio, Image, Video, Document, and Other buttons to filter the resources displayed.

Gallery

Name: Display the name of the gallery as part of the element display.
Description: Display the description of each gallery in the element display.

All

Display Resource: Choose to display the filename or the title of the resource, or none. If "Title" is chosen in grid or slideshow view, you may opt to show it above or below the resource.
Description: Display the description of each resource in the element display.

Audio

Autoplay: Enable this option to make the audio play automatically when it loads, rather than waiting for the user to press play.
Closed Captions: If a closed caption file is included for the audio in Resources, enable this option to display the captions.
Loop: With this option enabled, the audio will return and play from the beginning after it reaches the end. If disabled, nothing will happen after the audio ends.

Video

Resolution up to: The choices are 4K Ultra HD (2160px), Full HD (1080px), HD (720px), and SD (480px), but by default the element will display the video at the optimal resolution for the video and the screen size.
Show Controls/Hide Controls: Enable “Show Controls” to allow users to pause and play the video, mute and control volume, and skip to a specific point in the video. “Hide Controls” will not allow any of this functionality, so “Autoplay” is required when controls are hidden.
Autoplay: Enable this option to make the video play automatically, rather than waiting for the user to press play. If Autoplay is selected, the "Muted" and "Plays inline on mobile (iOS)" options are required.
Closed Captions: If a closed caption file is included for the video in Resources, enable this option to display the captions.
Loop: With this option enabled, the video will return and play from the beginning after it reaches the end.
Muted: This option automatically mutes the video. If the “Show Controls” option is also enabled, users can choose to unmute it.
Plays inline on mobile (iOS): By default, a video viewed on an iOS (Apple) device will open in a lightbox and block out the rest of the page when viewed. With this option selected, the video will instead play as part of the page.

Controls

Display Breadcrumbs (Grid only): The element will display "breadcrumb" links to any collections the currently selected one is underneath.
Scrolling (Slideshow only): Slideshow scrolling may be vertical or horizontal.
User control type (Slideshow only): Users can control the slideshow using dots, arrows, neither, or both.
Autoplay (Slideshow only): The slideshow will scroll automatically. This is required if no user controls are selected.
- Play/Pause button (Slideshow only): Adds the option to pause and resume playing a slideshow when slideshow autoplays.
- Show each slide for [X] seconds (Slideshow only): When the slideshow autoplays, choose the length of time each slide will be shown.
Show [X] items per slide (Slideshow only): Choose to show one or more than one resource on each slide of a slideshow.
Transition effect (Slideshow only): The transition effect may be slide or fade.

Formatting

Order Resources/Galleries by: Choose "Alphabetical (A-Z)" to display resources in alpha order by Title or Filename, depending on which you've chosen for "Display Resource" above. Otherwise, display resources in "Gallery Order," the order they appear in Resources.
Show Gallery (List and Grid only): Choose to show galleries before or after resources (if both resources and galleries are set to display in the element).

Display Resource Type Icons (List only): An icon for each type of file will be shown next to the file name.

Display Resources (Grid only): In Grid format, you may either display resources inline or as thumbnail links. Displaying resources as thumbnail links will link the smaller version of the image to the full-size image, in a popup or a Single-format Resource element on the same or a different page.

Note: PDFs, Images, and Videos will display thumbnails; Other file types, such as .xlsx or .docx, will not display a thumbnail. For these file types, it's better to use a list format where the file will download when clicked on (according to browser rules).
Show [X] columns wide (Grid only): Choose to display resources in up to five columns.
Show a maximum of [X] resources (Grid only): Specify how many resources will appear on each page. If there are more than the maximum number of resources in the selected gallery, the grid will be paginated. Tip: Choose a number here that is compatible with the number of columns you have to display, so that a full row will be displayed at the bottom of the grid.

Advanced

Ignore URL Parameters: If this option is selected, the resource displayed in the element by default will remain even if user-selected criteria would normally override it.

Link to

Popup/Page/Element: If resources are linked, choose to display the full resource in a popup or a Single-format Resource element on the same or a different page.
Display slideshow controls in pop-up: Choose to display arrows so users can scroll through the resources in the element from the popup window.

Single format

Using the Resource element to display a single resource functions exactly as the dedicated Image element and Video element, with the settings outlined in the linked articles. For all other file types, the only options are whether to display the filename or title and whether to ignore URL parameters.