Alexander Haneng
Sep 27, 2010
(0 votes)

EPiImage Part 3: EPiImageGallery Property

The EPiImageGallery property gives you preview thumbnails in edit mode, drag and drop sorting and the possibility to add an image description to each image.


This is the third part of a four part series that started with EPiImage Part 1: EPiImageResizer


EPiImageGallery Property

The EPiImageGallery property is a custom property that have the following features:

  1. Thumbnail view of all the pictures in the gallery in edit mode
  2. Click the “i” button to preview the image and add an image description
  3. Drag and drop sorting



This is what the EPiImageGallery Property looks like in edit mode if no image is selected. If clicked the normal file selection dialog box is opened.

This is what the EPiImageGallery Property looks like in edit mode if it contains images. A thumbnail of each image is shown, and the images can be dragged and dropped into the right sequence. On mouse over the “i” button is shown, if clicked it opens a preview window where image description can be added.


If you click the “i” button you will see a bigger preview of the image and you have the possibility to add a description.


How do I start using it?

Simply download the module from EPiCode and install it using EPiServer Deployment Center. (It just copies in a few files, it doesn’t touch your web.config or require a rebuild)

You will now get a new property type called “EPiImageGallery”:



How do I access the property value?

You can use the EPiImagegallery Viewer user control, or you can access the collection of images directly using the GetImages(CurrentPage) method.

Here is an example:

   //Get the property
    if (!CurrentPage.Property["EPiImageGalleryProperty"].IsNull)
      EPiImageGalleryProperty galleryProperty = 
CurrentPage.Property["EPiImageGalleryProperty"] as EPiImageGalleryProperty; if (galleryProperty != null) { //Get the images by calling GetImages(CurrentPage) EPiImageGalleryImageCollection imageCollection =
galleryProperty.GetImages(CurrentPage); //Databind the image collection to a repeater repGallery.DataSource = imageCollection; repGallery.DataBind(); } }


  <asp:Repeater ID="repGallery" runat="server">
      Image url: 
      <%# (Container.DataItem as EPiImageGalleryImage).ImageURL %><br />
      <%# (Container.DataItem as EPiImageGalleryImage).Description %> 


Have feedback? Want to help out?

Feel free to email or twitter me with your feedback: @ahaneng :-)

And finally: Thank you to Making Waves for donating it to EpiCode!

Next and last post: EPiImageGallery Viewer.

Sep 27, 2010


Michael Horsch
Michael Horsch Mar 22, 2011 06:28 PM

What if I want to use more than 1 per page? The front end of this tool breaks because you've used 'EPiImageGallery' as the id for the div's and then the js doesn't properly handle it from there going forward.

I really like the tool but would like to use more than 1 on the same page type! :)

Please login to comment.
Latest blogs
Optimizely community meetup - Sept 29 (virtual + Melbourne)

Super excited to be presenting this Thursday the 29th of September at the Optimizely community meetup. For the full details and RSVP's see the...

Ynze | Sep 27, 2022 | Syndicated blog

Preview multiple Visitor Groups directly while browsing your Optimizely site

Visitor groups are great - it's an easy way to add personalization towards market segments to your site. But it does come with it's own set of...

Allan Thraen | Sep 26, 2022 | Syndicated blog

The Report Center is finally back in Optimizely CMS 12

With Episerver.CMS.UI 12.12.0 the Report Center is finally re-introduced in the core product.

Tomas Hensrud Gulla | Sep 26, 2022 | Syndicated blog

Dynamic Route in ASP.NET Core When MapDynamicControllerRoute Does Not Work

Background Creating one of the add-on for Optimizely I had to deal with challenge to register dynamically route for the API controller. Dynamic rou...

valdis | Sep 25, 2022 | Syndicated blog