What is it?

The Photos in Folder widget displays images from a connected Folder channel in your digital workplace. See the article on Folders to learn more about files and folders in Igloo.

Like other Widgets, the Photos in Folder widget can be placed on Pages and Spaces.

Configuration settings

Options tab settings

Title

Enter a title for the Widget. The title appears as a heading above the Widget's contents. You should use the title to provide users with an idea of why the Widget's content is important to them or to highlight the content's purpose. Titles also serve to better structure the content of a page by clearly denoting different sections. 

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should click the field's Translation button () and enter a title for each supported language.

Title link

Select to link the Widget's title to the selected Folder Channel or Folder. User's who click the Widget's title, if it has one, will go to this location.

Description

Enter a description for the Widget. The description appears between the title and the Widget's contents. You can use this text to provide additional context to the Widget or instructions for using the Widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should click the field's Translation button () and enter a description for each supported language.

Source

Select a Folder Channel or Folder. Content from this source will display in the Widget. 

Access Rules determine what users will see when configuring and viewing the Widget: 

• Users who are configuring this Widget will only see Folder Channels and Folders that meet both of these conditions:
  • The user must have at least Read Access to the Folder Channel or Folder.
  • The user must have at least Read Access to all locations above where the Folder Channel or Folder are nested.
• Only users who have Read Access or higher to the selected Folder Channel or Folder will see content in the published Widget. These users will only see content to which they have at least Read Access.

To select a Folder Channel or Folder:

1. Click "No folder selected". If there is an existing source in this field, click it.
2. Search for a Folder Channel or Folder by its name. This search will return up to 100 results and include the Pages and Spaces that contain a Folder or Folder Channel that matches the search query.
3. Select a Folder Channel or Folder from the list of search results.

Sort options

Select how to sort content in the Widget. Options include:

• Title
• Comments
• Size
• Type
• Created Date
• Created by
• Last Modified
• Modified by
• Views
• Rating

You can then select whether the sort order is ascending or descending.

Number of results

Enter the maximum number of results to display initially. You must enter a value between 1 and 99. If there are additional items to display, users can click the View All link found at the bottom of the Widget to go to the source Folder Channel or Folder.

Show add link

Select to add an "Upload a photo" button to the Widget. Only users with at least Write Access to the connected Folder Channel or Folder can see this button. These users can click this button to add content to the connected Folder Channel or File.

Layout tab settings

The Photos in Folder widget has a few options available to adjust how the images are displayed.

Squares: Images will all be displayed as squares in a grid. Rectangular images will be cropped. Additional options include:

• Photo title: Displays the file name of the image.
• Created by: Displays the full name of the member who uploaded the image.
• Rating: Displays the Star Rating by selecting this option.
• Size: You can select from three sizes of the image to display.

Thumbnail: Images will be shown with their original aspect ratio and their title beneath.

Detail: Images will be displayed in a stacked list with small squared previews of the images and additional details as selected. Additional options include:

• Size: Displays the size of the file in KB or MB.
• Type: Displays the filetype extension.
• Created by: Displays the first and last name of the person that uploaded the file.
• Last Modified: Displays the date or the most recent update to the file.
• Modified By: Displays the name of the last person to update the file.
• Views: Displays the total number of times the image has been viewed.
• Comments: Displays the number of comments on each image.
• Rating: Displays the Star Rating by selecting this option.
• Likes: Displays the number of Likes the image has received and includes a button to like it, yourself.

List: Images will be shown in a more compact stacked list than the Detail view. Additional options include:

• Created by: Displays the first and last name of the person that uploaded the file.
• Last Modified: Shows the date or the most recent update to the file
• Views: Displays the total number of times the image has been viewed.
• Comments: Displays the number of comments on each image.
• Rating: Displays the Star Rating by selecting this option.

Tile: The Tile view will display images in a grid with a square thumbnail image and the title of the image to the right. Additional options include:

• Created by: Displays the first and last name of the person that uploaded the file
• Last Modified: Displays the date or the most recent update to the file.

Slideshow: The Slideshow view will display images from a folder one after the other. Additional options include:

• Time: Sets how long individual slides will stay on the screen.
• Image Order: Select whether slideshow images are ordered based on the Sort method selected on the options tab, or ordered randomly.
• Image Size: Determines how the image will be sized to the widget and works in conjunction with the Height option found on the Appearance tab. Auto will cause the slideshow height to dynamically change based on the image being displayed and will maintain the images original vertical height. Fill will result in the image taking up the entire width of the widget while the view of the image is centered vertically. Fit will scale the image so that its height will match that of the widget.
• Transition: The animation style used when images rotate in the slideshow, either Fade or Slide.
• Controls: Provide methods for manually navigating a slideshow using Dots and/or Arrows.
• Photo Title: Displays the file name of the image.
• Last Modified: Displays the date of the most recent update to the file.
• Views: Displays the total number of times the image has been viewed.
• Created by: Displays the full name of the member who uploaded the image.
• Comments: Displays the number of comments on each image.
• Likes: Displays the number of Likes the image has received.

Appearance tab settings

Use the Class field to add custom CSS to this Widget. 

Your digital workplace's CSS theme overrides other settings on this tab.

Image size and display behavior

Images displayed in the Photos in Folder widget are often scaled down from their original size. Using PNG images is the best way to minimize any image degradation that can occur as a result of this image scaling.

The slideshow layout provides additional options for determining how images are displayed. The image size option determines this behavior:

• Auto: Causes the slideshow height to dynamically change based on the image being displayed and will maintain the images original vertical height. 
• Fill: Scales the image taking up the entire width of the widget while the view of the image is centered vertically. 
• Fit: Scales the image so that its height will match that of the widget.

Image widths can range from 200px/600px/620px/1080px (narrowest column to the entire page column). The height of the slideshow is configured on the Appearance tab of the widget and ranges from 50px to 600px with adjustments occurring in increments of 50px.

Set up 

You can follow the standard Widget placement and set up steps for this Widget. You may find it helpful to leave this article open as a reference for what specific configuration settings do.