ImageGalleryComponent: Difference between revisions

Latest revision as of 17:08, 28 November 2013

An Image Gallery component is used for adding a number of images to your site, in a variety of ways.

Where to Find

This Component can be found in the "Add Content to Page" section of the Toolbar.

Adding to Website

After selecting this Component, you will be able to choose exactly where you want to add it!

You will see all available content locations it can be added to - on the current page only (content locations in Gold), on every page (content locations in Red), or on every page under the current page directory (content locations in Blue. For example - if you are editing a page called "About", the blue content locations would allow you to add this component to all pages under the /about/ directory).

Options

After choosing where this Component will appear, you can configure it by choosing the folder to show images from. You can also create a new folder.

Clicking on the "click here" or "Upload images" link in the Preview area will take you to the File Manager which you can use to upload images from your computer.

Clicking on "Manage images" will take you to the main file manager area with the "Images" filter in place to only show uploaded images.

Further configuration can be done before the Component is added.

You can optionally set a Title to be displayed above the Image Gallery content on your page.

The How Many Images to Display? option allows you to choose how the images in this component display on your site. You can choose to show all, or show a number that you define. You can also choose to Randomize Image Order in addition to either case, making them display in random order each time the page is viewed.

Thumbnail Style gives you a graphical representation of how the thumbnail versions of your images will appear in the gallery on your site. Thumbnail Sizes allows you to define the height and width of these. You can also set the Space Between Thumbnails here. These settings are defaulted to reasonable amounts.

The Click Behaviour option will allow you to set what happens when an image in the gallery is clicked on. The choices are:

Start Fullscreen Slideshow (opens the image clicked to be fullscreen - if more than one image exists, this uses slideshow mode, which opens the image clicked, and allows you to move your cursor over the image to go to the next or previous in the collection)
Directly open this image (Links directly to the image file)
Do nothing (clicking on the image will do nothing)

Slideshow Display Items allows you to display titles and descriptions and a download image button, or deactivate these.

Slideshow Rotation Speed gives you the option to choose how long the image will be displayed for before switching to the next one.

Editing

Need to make a change? You can access the settings for this Component again by clicking on the "Settings" button on the Component Toolbar.

Example Sites

An example of this Component can be viewed on the Multimedia page of http://builderexample.com

@@ Line 2: / Line 2: @@
 An Image Gallery component is used for adding a number of images to your site, in a variety of ways.
+==Where to Find==
-====Where to Find:====
+This Component can be found in the [[Adding to a Page | "Add Content to Page"]] section of the [[Toolbar]].
-This Component can be found in the [[Adding to a Page | "Add to Page..."]] section of the [[Toolbar]].
-====Adding to Website:====
+==Adding to Website==
 After selecting this Component, you will be able to choose exactly where you want to add it!
@@ Line 17: / Line 12: @@
 You will see all available [[content locations]] it can be added to - on the current page only (content locations in Gold), on every page (content locations in Red), or on every page under the current page directory (content locations in Blue. For example - if you are editing a page called "About", the blue content locations would allow you to add this component to all pages under the /about/ directory).
+==Options==
-====Configuring:====
 [[Image:Imagegallery.PNG]]
-After choosing where this Component will appear, you can configure it by choosing the collection to '''show images from'''. You can also [[File Collections | create a new collection]].
+After choosing where this Component will appear, you can configure it by choosing the folder to '''show images from'''. You can also [[File Folders | create a new folder]].
 Clicking on the "click here" or "Upload images" link in the Preview area will take you to the [[File Manager]] which you can use to upload images from your computer.
@@ Line 41: / Line 33: @@
-The '''Image Selection''' option allows you to choose how the images in this component display on your site. You can choose to ''show all'', or ''show a number that you define''. You can also choose to '''Randomize''' the displayed images in either case, making them display in random order each time the page is viewed.
+The '''How Many Images to Display?''' option allows you to choose how the images in this component display on your site. You can choose to show all, or show a number that you define. You can also choose to '''Randomize Image Order''' in addition to either case, making them display in random order each time the page is viewed.
-The '''Number of Images''' that display at once can be set to show all, or show only a number of the most recent images.
+'''Thumbnail Style''' gives you a graphical representation of how the thumbnail versions of your images will appear in the gallery on your site. '''Thumbnail Sizes''' allows you to define the height and width of these. You can also set the '''Space Between Thumbnails''' here. These settings are defaulted to reasonable amounts.
 The '''Click Behaviour''' option will allow you to set what happens when an image in the gallery is clicked on. The choices are:
-* Open Lightbox (opens the image clicked in a lightbox - if more than one image exists, this uses gallery mode, which opens the image clicked in a lightbox, and allows you to move your cursor over the image to go to the next or previous in the collection)
+* Start Fullscreen Slideshow (opens the image clicked to be fullscreen - if more than one image exists, this uses slideshow mode, which opens the image clicked, and allows you to move your cursor over the image to go to the next or previous in the collection)
-* Link to image (Links directly to the image file)
+* Directly open this image (Links directly to the image file)
-* No click action (clicking on the image will do nothing)
+* Do nothing (clicking on the image will do nothing)
-There are several different '''Themes''' you can choose from for your image gallery. For example, Dark Rounded will border your images with a rounded black border.
-* '''Tip:''' Don't want borders around your images at all? Add this line of code to your theme's CSS file while [[Editing Theme Source Code | editing your theme's source code]] to remove them:
-          '''.image_gallery_component .image img { border-width: 0px; }'''
-You can optionally set a '''Slideshow Delay'''. If you enter a number in this box, your lightbox will open in ''slideshow mode'', showing each image for this many seconds before advancing to the next one.
-The '''Image Size''' can be set to one of a variety of combinations of cropped and non-cropped.
+'''Slideshow Display Items''' allows you to display titles and descriptions and a download image button, or deactivate these.
-====Editing:====
+'''Slideshow Rotation Speed''' gives you the option to choose how long the image will be displayed for before switching to the next one.
+==Editing==
 Need to make a change? You can access the settings for this Component again by clicking on the "Settings" button on the [[Component Toolbar]].
+==Example Sites==
-====Example:====
+An example of this Component can be viewed on the [http://builderexample.com/multimedia Multimedia] page of http://builderexample.com
-An example of this Component can be viewed on the [http://example.viviti.com/multimedia Multimedia] page of http://example.viviti.com
 [[Category:Components]]
 [[Category:Multimedia Components]]