Jump to content

Slideshow/Gallery Component: Difference between revisions

From Swarthmore Knowledge Base
Kwhiteb1 (talk | contribs)
No edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The '''''Slideshow/Gallery '''''component is used to easily add an interactive image gallery to your Drupal page. There are two styles or "display types" for a Slideshow/Gallery component, '''''Slideshow''' ''and '''''Gallery'''''.
{{DrupalBack}}
The '''Slideshow/Gallery''' component is used to easily add an interactive image gallery to your Drupal page. There are two styles (or display types) available: '''Slideshow''' and '''Gallery'''.


== Elements ==
== Elements ==
Line 8: Line 9:
## '''Options''': Slideshow (''default''), Gallery
## '''Options''': Slideshow (''default''), Gallery
# Number of Images to Display
# Number of Images to Display
## Default set to ‘All Slides’
## Default set to '''All Slides'''
# Slideshow/Gallery Items (Images)
# Slideshow/Gallery Items (Images)


[[File:Screenshot 2024-06-14 at 1.39.18 PM.png|800px|alt=Diagram demonstration main components of the Drupal slideshow and gallery component]]
{{Screenshot|Screenshot 2024-06-14 at 1.39.18 PM.png|800px|Diagram showing the fields that make up the Slideshow/Gallery component.|The Slideshow/Gallery component fields.}}


== Examples ==
== Examples ==


{{StorybookComponent|id=components-slideshow-gallery-slideshow--slideshow|height=650}}
===Image Slideshow===
 
{{Callout|type=tip|title=Interactive Example|content=The preview below shows the Slideshow component using its default configuration.
 
To experiment with different layouts and other settings, open the interactive component playground.
 
'''[https://toolkit.swarthmore.edu/?path=/story/swarthmore-theme-components-image-slideshow Open Component Playground]'''}}
 
{{StorybookComponent|id=swarthmore-theme-components-image-slideshow|height=650}}
 
===Image Gallery===
{{Callout|type=tip|title=Interactive Example|content=The preview below shows the Gallery component using its default configuration.
 
To experiment with different layouts and other settings, open the interactive component playground.
 
'''[https://toolkit.swarthmore.edu/?path=/story/swarthmore-theme-components-image-gallery Open Component Playground]'''}}
 
{{StorybookComponent|id=swarthmore-theme-components-image-gallery|height=650}}
 


== Step-by-step Instructions ==
== Step-by-step Instructions ==
Line 21: Line 40:
=== Preparing your Images ===
=== Preparing your Images ===


Although the slideshow layout is capable of handling various image sizes, we have a few recommendations that will help ensure a pleasant user experience for your visitors. Prior to creating your slideshow it would be helpful to use Photoshop or an equivalent tool to resize slide images with the following in mind:
Although the slideshow layout is capable of handling various image sizes, we have a few recommendations that will help ensure a pleasant user experience for your visitors. Prior to creating your slideshow, it is helpful to use Photoshop or an equivalent tool to resize slide images with the following in mind:


* Keep your image sizes consistent. If the images aren't exactly the same dimensions the screen will resize as the slider progresses.
* Keep your image sizes consistent. If the images aren't exactly the same dimensions, the screen will resize as the slideshow progresses.
* Image slider looks best when landscape oriented images are used (width is larger than height)
* Image slideshows look best when landscape-oriented images are used (the width is greater than the height).
** Optimal - '''1600px wide''' x '''1000px tall'''
** Optimal: '''1600px wide''' × '''1000px tall'''
** Larger heights are acceptable, but should be consistent across all slides
** Larger heights are acceptable but should be consistent across all slides.
* '''IMPORTANT:''' Before proceeding to Drupal, prepare your images first using a photo editor like Photoshop. Once your images are properly cropped, color corrected and sized, then proceed to the steps below:
* '''IMPORTANT:''' Before proceeding to Drupal, prepare your images first using a photo editor such as Photoshop. Once your images are properly cropped, color corrected, and sized, continue with the steps below.


=== Creating a Slideshow/Gallery ===
=== Creating a Slideshow/Gallery ===


# Provide a '''''Title''''' for the new'' '''Slideshow/Gallery. '''''
# Provide a '''Title''' for the new '''Slideshow/Gallery'''.
## '''''Note: '''At this time, the '''Title '''is only shown when the '''Display Type '''is set to '''Image Gallery''' ''
## '''Note:''' At this time, the '''Title''' is only displayed when the '''Display Type''' is set to '''Image Gallery'''.
# Optionally, add a '''''Label.'''''
# Optionally, add a '''Label'''.
# Under '''''Display Type''''', select either''''' Slideshow '''''or''''' Image Gallery '''''(see examples above).
# Under '''Display Type''', select either '''Slideshow''' or '''Image Gallery''' (see the examples above).
# Under '''''Number of Images to Display''''', select the amount of images to be displayed in the component. The default value is '''''All Slides'''.''
# Under '''Number of Images to Display''', select the number of images to display in the component. The default value is '''All Slides'''.
# Begin adding your Slide Items:
# Begin adding your Slide Items:
## '''If using an existing image already in the system''':
## '''If using an existing image already in the system:'''
### Click '''''Insert an Image '''''button to launch the browser pop-up window.
### Click the '''Insert an Image''' button to launch the image browser.
### Navigate to the image under '''''Select Image''''', clicking on the radio button to the left of the thumbnail to select it.
### Navigate to the image under '''Select Image''', select it using the radio button, and click '''Select Image'''.
### Press the '''''Select Image''''' button in the bottom left.
## '''If using a new image:'''
## '''If using a new image''':
### Click the '''Insert an Image''' button to launch the image browser.
### If you’re adding a new image to the system, click the '''''Insert an Image '''''button to launch the browser pop-up window button.
### Select '''Upload Image''', click '''Browse…''' to locate the image on your computer, then click '''Select Image'''.
### Click '''''Upload Image '''''and then the '''''Browse…''''' button to browse your local system for the file, select it, and click the '''''Select Image '''''button.
## Optionally, add a '''Video URL'''. The system expects the video to come from YouTube.
## Optionally, add a '''''Video URL'''''. The system expects the video to come from YouTube.
### ''Note:'' If both a '''Video URL''' and '''Image File''' are present, the image will be used as the video's poster image. This is the intended behavior but is not required.
### ''Note'': If both a '''''Video URL''''' and '''''Image File''''' are present, the image will be used as the video’s “poster image”. This is the way the system is intended to be used but is not required.
## Optionally, add a '''Caption'''. The '''Caption''' should be no more than 250 characters and ideally closer to 125 characters.
## Optionally, add a '''''Caption'''. ''The '''''Caption''''' should be no more than 250 characters and ideally, closer to 125 character.
## Optionally, add '''Image Attribution''' with the photographer's name and any other required attribution.
## Optionally, add''''' Image Attribution '''''with the Photographer's name & any other attribution required.
## Drupal automatically creates a '''Thumbnail Image'''. The thumbnail is used primarily in RSS feeds and may be replaced with your own if desired.
## Drupal automatically creates '''''Thumbnail  Image''''''''.''' The thumbnail is used primarily in RSS feeds. It is possible to replace this thumbnail with your own.
## Click the blue '''Add another item''' button and repeat the process for each additional slide.
## Click the blue '''''Add another item''''' button and repeat the process to add more slides.
# When finished, click the green '''Save''' button at the bottom of the page.
# Once you are done, click the  green '''''Save''''' button at the very bottom.<br>
 


[[Category:Drupal]]
[[Category:Drupal]]
<!-- Imported from Confluence page id=20513017 (https://swatkb.atlassian.net/wiki/spaces/DRUP/pages/20513017/Slideshow+Gallery+Component) -->

Latest revision as of 20:28, 9 July 2026

The Slideshow/Gallery component is used to easily add an interactive image gallery to your Drupal page. There are two styles (or display types) available: Slideshow and Gallery.

Elements

  1. Title (required but not displayed)
  2. Label
  3. Display Type (required)
    1. Options: Slideshow (default), Gallery
  4. Number of Images to Display
    1. Default set to All Slides
  5. Slideshow/Gallery Items (Images)
Diagram showing the fields that make up the Slideshow/Gallery component.
Figure: The Slideshow/Gallery component fields.

Examples

Image Slideshow

Interactive Example
The preview below shows the Slideshow component using its default configuration.

To experiment with different layouts and other settings, open the interactive component playground.

Open Component Playground



Image Gallery

Interactive Example
The preview below shows the Gallery component using its default configuration.

To experiment with different layouts and other settings, open the interactive component playground.

Open Component Playground



Step-by-step Instructions

Preparing your Images

Although the slideshow layout is capable of handling various image sizes, we have a few recommendations that will help ensure a pleasant user experience for your visitors. Prior to creating your slideshow, it is helpful to use Photoshop or an equivalent tool to resize slide images with the following in mind:

  • Keep your image sizes consistent. If the images aren't exactly the same dimensions, the screen will resize as the slideshow progresses.
  • Image slideshows look best when landscape-oriented images are used (the width is greater than the height).
    • Optimal: 1600px wide × 1000px tall
    • Larger heights are acceptable but should be consistent across all slides.
  • IMPORTANT: Before proceeding to Drupal, prepare your images first using a photo editor such as Photoshop. Once your images are properly cropped, color corrected, and sized, continue with the steps below.

Creating a Slideshow/Gallery

  1. Provide a Title for the new Slideshow/Gallery.
    1. Note: At this time, the Title is only displayed when the Display Type is set to Image Gallery.
  2. Optionally, add a Label.
  3. Under Display Type, select either Slideshow or Image Gallery (see the examples above).
  4. Under Number of Images to Display, select the number of images to display in the component. The default value is All Slides.
  5. Begin adding your Slide Items:
    1. If using an existing image already in the system:
      1. Click the Insert an Image button to launch the image browser.
      2. Navigate to the image under Select Image, select it using the radio button, and click Select Image.
    2. If using a new image:
      1. Click the Insert an Image button to launch the image browser.
      2. Select Upload Image, click Browse… to locate the image on your computer, then click Select Image.
    3. Optionally, add a Video URL. The system expects the video to come from YouTube.
      1. Note: If both a Video URL and Image File are present, the image will be used as the video's poster image. This is the intended behavior but is not required.
    4. Optionally, add a Caption. The Caption should be no more than 250 characters and ideally closer to 125 characters.
    5. Optionally, add Image Attribution with the photographer's name and any other required attribution.
    6. Drupal automatically creates a Thumbnail Image. The thumbnail is used primarily in RSS feeds and may be replaced with your own if desired.
    7. Click the blue Add another item button and repeat the process for each additional slide.
  6. When finished, click the green Save button at the bottom of the page.