You use this widget to display a gallery of image thumbnails, where each image can be opened individually. You choose an image from the images already uploaded in libraries.
PREREQUISITES: You uploaded at least one image. For more information, see Upload images.
After you place the Image gallery widget on your page you configure it to display images. To do this, click the Edit button in the upper-right corner of the widget. The Image gallery window contains a few tab pages, described in the following sections.
On the Content tab page you select which images to display in the gallery. Choose one of the following options:
From all libraries
All images that are uploaded and published will be displayed in the gallery.
From selected libraries only...
A custom selection of libraries is displayed.
To select one or more libraries from which you want to display images, click the Select button.
From currently opened library
All published images from the currently opened library will be displayed in the gallery.
Under Narrow selection by..., you can further specify which images to display by choosing one of the following:
All published images
This is selected by default and displays all images selected in the previous step.
Selection of images...
You can narrow down the displayed images, using categories, tags, and dates. Select one or more of the following:
List settings define how images are listed by the Image gallery widget. Choose one of the following options:
The system divides the image thumbnails into pages. In the input field you specify how many image thumbnails per page you want to display.
The system displays only a limited number of image thumbnails. In the input field, you specify how many image thumbnails you want to display.
No limit and paging
The system displays all images that meet the requirements and filters you set in the Content tab.
By default, last published images are listed on top. You can select a different sorting criterion:
Provides option for configuring size of image thumbnails. This size applies to the thumbnails of the images when widget is in List mode.
Select the template you want to use to list images on the webpage. Choose one of the following options:
Expand More options section to apply additional CSS classes to the Image gallery widget when in List mode.
Single item settings define how individual images are displayed. Choose one of the following options:
Open single item in...
Select one of the following options:
When you click an image, it is displayed in an automatically generated page with the same layout as the list page.
Selected existing page...
Select a page from the list of existing pages that has the desired layout. When you click on the image, it is displayed in this specific page.
NOTE: The page on which you want the image displayed, must have an Image gallery widget added.
Provides option for configuring size of the image. In the dropdown box, all predefined image sizes appear.
Select the template you want to use to display image's details on the webpage.
Expand More options section to apply additional CSS classes to the Image gallery widget when the image details are opened.
In Advanced settings, you specify individual properties of the widget:
Gets the ID of the page you have selected in the Selected existing page... option in the Single item settings tab.
Gets the template you have selected in the Detail template dropdown in the Single item settings tab.
Gets the template you have chosen in the List template dropdown in the List settings tab.
Defines whether when you click on an image thumbnail to open the detail view in a new window. The default value is False.
Model settings display all properties directly bound to the Image Gallery widget model. Access these properties by clicking the Model button in Advanced settings.
Gets and sets additional CSS classes to the image detail view.
Gets the value you have selected in the List settings tab:
To enable users to share your content in Facebook, Google+, Twitter, and so on, set the value of this property to True. By default, the value is False.
NOTE: The way your content is shared also depends on the settings that you applied inAdministration: Social sharing settings.
Filters images based on an additional filter expression.
Defines the number of images per page when paging is enabled. The default value is 20.
Gets and sets additional CSS classes to the list view.
Gets the option that you have chosen for libraries in the Content tab. The possible values are:
If you have more than one provider added, you can use an image provider different than the default one. To do this, specify the name of this provider.
NOTE: If you leave this property value empty, the default image provider is used.
Gets the option that you have chosen for images under Narrow selection by... in the Content tab. The possible values are:
In case images are filtered based on a date, tags, or categories, the IDs of the selected filter criterions are serialized and populated in that field.
In case images are specifically selected, the IDs of the selected images are serialized and populated in that field. For example:
In case image libraries are specifically selected, the IDs of the selected libraries are serialized and populated in that field. For example:
Contains serialized settings for size of the thumbnails. Specified size is used in the frontend of the Image Gallery widget when displayed in List mode.
Contains serialized settings for size of the image. Specified size is used in the frontend of the Image Gallery widget when displayed in Details mode.
Adds additional sorting expression for the images. The default value is PublicationDate DESC.
Gets or sets the URL key prefix. Used when building or evaluating URLs for paging and filtering.
Back To Top