# Adding a photoswipe gallery as a shortcode using Page.Resources

**URL:** https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672
**Category:** tips & tricks
**Created:** [February 21, 2018, 9:45pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672 "2018-02-21T21:45:42Z")
**Posts on this page:** 16
**Page:** 1

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [February 21, 2018, 9:45pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/1 "2018-02-21T21:45:43Z")

</div>

The code below adds this shortcode `{{ gallery folder="" title=""}}`

folder: must be a subdirectory in that Page Bundle. Required. I need to test if this allows multiple galleries in the same page.

Title: used in the initial H4 of the gallery. Optional.

This version is mostly a proof of concept and requires that you install PhotoSwipe, and optionaly Masonry, in your themes/YOURTHEME/static/plugins directory, or /static/plugins for example.

- Photoswipe: [https://github.com/dimsemenov/PhotoSwipe](https://github.com/dimsemenov/PhotoSwipe)
- Masonry: [https://masonry.desandro.com/](https://masonry.desandro.com/)

**To do** : Define a default value for folder and find a way to load the javascript and css only once per page

Hope it’s useful for someone. 🙂

Example front matter:

```
---
resources:
- src: "gallery/*.jpg"
  name: gallery-:counter
  title: gallery-title-:counter
---

```

* * *

Shortcode: **gallery.html**

```
<link rel="stylesheet" href="/plugins/photoswipe/photoswipe.css">
<link rel="stylesheet" href="/plugins/photoswipe/default-skin/default-skin.css">
{{ $galleryimages := .Page.Resources.Match (printf "%s-*" (.Get "folder")) }}

<h4 class="title">{{ .Get "title" }}</h4>
<div class="row">
  <div class="12u$">
	<div class="gallery" itemscope itemtype="http://schema.org/ImageGallery">
{{ range $galleryimages }}
{{ $thumbnail := .Resize "320x" }}

		<figure itemscope itemtype="http://schema.org/ImageObject" class="image gallery-item">
		  <a href="{{ .Permalink }}" itemprop="contentUrl" data-size="{{ .Width }}x{{ .Height }}" >
		      <img src="{{ $thumbnail.Permalink }}" itemprop="thumbnail" alt="galleryImage" />
		  </a>

		  <figcaption itemprop="caption description">
		    <span itemprop="copyrightHolder"></span>
		  </figcaption>
		</figure> 

{{ end }}
	</div>
  </div>
</div>

<style>
/* Extra Small Devices, Phones */ 
@media only screen and (min-width : 480px) {
  .gallery {
    column-count: 1;
    column-gap: 3px;
  }
}
/* Small Devices, Tablets */
@media only screen and (min-width : 768px) {
  .gallery {
    column-count: 3;
    column-gap: 3px;
  }
}

/* Medium Devices, Desktops */
@media only screen and (min-width : 992px) {
  .gallery { /* Masonry container */
      column-count: 4;
      column-gap: 3px;
  }
}

/* Large Devices, Wide Screens */
@media only screen and (min-width : 1200px) {
  .gallery{
    column-count: 4;
    column-gap: 3px;
  }
}

.gallery-item { /* Masonry bricks or child elements */
    background-color: #eee;
    display: inline-block;
    margin: 0 0 0em;
    width: 100%;
}
</style>

<!-- Root element of PhotoSwipe. Must have class pswp. -->
<div class="pswp" tabindex="-1" role="dialog" aria-hidden="true">
<!-- Background of PhotoSwipe.
     It's a separate element, as animating opacity is faster than rgba(). -->
<div class="pswp__bg"></div>
<!-- Slides wrapper with overflow:hidden. -->
<div class="pswp__scroll-wrap">
    <!-- Container that holds slides.
      PhotoSwipe keeps only 3 of them in DOM to save memory.
      Don't modify these 3 pswp__item elements, data is added later on. -->
    <div class="pswp__container">
      <div class="pswp__item"></div>
      <div class="pswp__item"></div>
      <div class="pswp__item"></div>
    </div>
    <!-- Default (PhotoSwipeUI_Default) interface on top of sliding area. Can be changed. -->
    <div class="pswp __ui pswp__ ui--hidden">
    <div class="pswp__top-bar">
      <!-- Controls are self-explanatory. Order can be changed. -->
      <div class="pswp__counter"></div>
      <button class="pswp __button pswp__ button--close" title="Close (Esc)"></button>
      <button class="pswp __button pswp__ button--share" title="Share"></button>
      <button class="pswp __button pswp__ button--fs" title="Toggle fullscreen"></button>
      <button class="pswp __button pswp__ button--zoom" title="Zoom in/out"></button>
      <!-- Preloader demo http://codepen.io/dimsemenov/pen/yyBWoR -->
      <!-- element will get class pswp__preloader--active when preloader is running -->
      <div class="pswp__preloader">
        <div class="pswp __preloader__ icn">
          <div class="pswp __preloader__ cut">
            <div class="pswp __preloader__ donut"></div>
          </div>
        </div>
      </div>
    </div>
    <div class="pswp __share-modal pswp__ share-modal--hidden pswp__single-tap">
      <div class="pswp__share-tooltip"></div>
    </div>
    <button class="pswp __button pswp__ button--arrow--left" title="Previous (arrow left)">
    </button>
    <button class="pswp __button pswp__ button--arrow--right" title="Next (arrow right)">
    </button>
    <div class="pswp__caption">
      <div class="pswp __caption__ center"></div>
    </div>
    </div>
    </div>
</div>
<script src="/plugins/photoswipe/photoswipe.min.js"></script>
<script src="/plugins/photoswipe/photoswipe-ui-default.min.js"></script>
<script type="text/javascript">
var initPhotoSwipeFromDOM = function(gallerySelector) {

// parse slide data (url, title, size ...) from DOM elements
// (children of gallerySelector)
var parseThumbnailElements = function(el) {
    var thumbElements = el.getElementsByTagName('figure'),
        numNodes = thumbElements.length,
        items = [],
        figureEl,
        linkEl,
        size,
        item;

    for(var i = 0; i < numNodes; i++) {

        figureEl = thumbElements[i]; // <figure> element

        // include only element nodes
        if(figureEl.nodeType !== 1) {
            continue;
        }

        linkEl = figureEl.children[0]; // <a> element

        size = linkEl.getAttribute('data-size').split('x');

        // create slide object
        item = {
            src: linkEl.getAttribute('href'),
            w: parseInt(size[0], 10),
            h: parseInt(size[1], 10)
        };

        if(figureEl.children.length > 1) {
            // <figcaption> content
            item.title = figureEl.children[1].innerHTML;
        }

        if(linkEl.children.length > 0) {
            // <img> thumbnail element, retrieving thumbnail url
            item.msrc = linkEl.children[0].getAttribute('src');
        }

        item.el = figureEl; // save link to element for getThumbBoundsFn
        items.push(item);
    }

    return items;
};

// find nearest parent element
var closest = function closest(el, fn) {
    return el && ( fn(el) ? el : closest(el.parentNode, fn) );
};

// triggers when user clicks on thumbnail
var onThumbnailsClick = function(e) {
    e = e || window.event;
    e.preventDefault ? e.preventDefault() : e.returnValue = false;

    var eTarget = e.target || e.srcElement;

    // find root element of slide
    var clickedListItem = closest(eTarget, function(el) {
        return (el.tagName && el.tagName.toUpperCase() === 'FIGURE');
    });

    if(!clickedListItem) {
        return;
    }

    // find index of clicked item by looping through all child nodes
    // alternatively, you may define index via data- attribute
    var clickedGallery = clickedListItem.parentNode,
        childNodes = clickedListItem.parentNode.getElementsByTagName('figure'),
        numChildNodes = childNodes.length,
        nodeIndex = 0,
        index;

    for (var i = 0; i < numChildNodes; i++) {
        if(childNodes[i].nodeType !== 1) { 
            continue;
        }

        if(childNodes[i] === clickedListItem) {
            index = nodeIndex;
            break;
        }
        nodeIndex++;
    }

    if(index >= 0) {
        // open PhotoSwipe if valid index found
        openPhotoSwipe( index, clickedGallery );
    }
    return false;
};

// parse picture index and gallery index from URL (#&pid=1&gid=2)
var photoswipeParseHash = function() {
    var hash = window.location.hash.substring(1),
    params = {};

    if(hash.length < 5) {
        return params;
    }

    var vars = hash.split('&');
    for (var i = 0; i < vars.length; i++) {
        if(!vars[i]) {
            continue;
        }
        var pair = vars[i].split('=');
        if(pair.length < 2) {
            continue;
        }
        params[pair[0]] = pair[1];
    }

    if(params.gid) {
        params.gid = parseInt(params.gid, 10);
    }

    if(!params.hasOwnProperty('pid')) {
        return params;
    }
    params.pid = parseInt(params.pid, 10);
    return params;
};

var openPhotoSwipe = function(index, galleryElement, disableAnimation) {
    var pswpElement = document.querySelectorAll('.pswp')[0],
        gallery,
        options,
        items;

    items = parseThumbnailElements(galleryElement);

    // define options (if needed)
    options = {
        index: index,

        // define gallery index (for URL)
        galleryUID: galleryElement.getAttribute('data-pswp-uid'),

        getThumbBoundsFn: function(index) {
            // See Options -> getThumbBoundsFn section of documentation for more info
            var thumbnail = items[index].el.getElementsByTagName('img')[0], // find thumbnail
                pageYScroll = window.pageYOffset || document.documentElement.scrollTop,
                rect = thumbnail.getBoundingClientRect();

            return {x:rect.left, y:rect.top + pageYScroll, w:rect.width};
        }

    };

    if(disableAnimation) {
        options.showAnimationDuration = 0;
    }

    // Pass data to PhotoSwipe and initialize it
    gallery = new PhotoSwipe( pswpElement, PhotoSwipeUI_Default, items, options);
    gallery.init();
};

// loop through all gallery elements and bind events
var galleryElements = document.querySelectorAll( gallerySelector );

for(var i = 0, l = galleryElements.length; i < l; i++) {
    galleryElements[i].setAttribute('data-pswp-uid', i+1);
    galleryElements[i].onclick = onThumbnailsClick;
}

// Parse URL and open gallery if it contains #&pid=3&gid=1
var hashData = photoswipeParseHash();

if(hashData.pid > 0 && hashData.gid > 0) {
    openPhotoSwipe( hashData.pid - 1 , galleryElements[hashData.gid - 1], true );
}
};</script>
<script>initPhotoSwipeFromDOM('.gallery');</script>
```

---

<div class="post-metadata">

### Author: ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)
#### Post date: [February 21, 2018, 9:57pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/2 "2018-02-21T21:57:57Z")

</div>

> [@brunoamaral](#):
>
> find a way to load the javascript and css only once per page

Tip: Use `.HasShortcode "gallery"` (replace gallery with your shortcode name) in your template.

---

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [February 22, 2018, 10:44am UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/3 "2018-02-22T10:44:05Z")

</div>

Thanks @bep, that solves the issue for me. I will see if I can use it to make this shortcode as contained as possible, the ideal scenario would be for it to be installed without touching the original template.

---

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [February 25, 2018, 6:46pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/4 "2018-02-25T18:46:44Z")

</div>

I’ve made improvements on the code above, it now uses a pure CSS masonry layout with css columns.

Minor setback, you can’t order the photos per row. Still trying to think up ways to load the JS for photoswipe only once.

---

<div class="post-metadata">

### Author: ![szac](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/szac/32/5358_2.png) [@szac](https://discourse.gohugo.io/u/szac)
#### Post date: [February 27, 2018, 2:33am UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/5 "2018-02-27T02:33:11Z")

</div>

Great stuff! I’ve done a similar gallery with directory crawling but pre-v0.32 image processing. I’m late to the party (learned about image processing last week) and was planning to try what you’ve done here. Thanks for sharing.

Side note: I also see some [skel.io](http://skel.io) classes 😉

---

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [February 27, 2018, 10:30am UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/6 "2018-02-27T10:30:09Z")

</div>

Glad to know it’s useful 🙂

Keep in mind what @bep said, about putting `.HasShortcode "gallery"` in the footer to load the required JS.

---

<div class="post-metadata">

### Author: ![divinerites](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/divinerites/32/12625_2.png) [@divinerites](https://discourse.gohugo.io/u/divinerites)
#### Post date: [February 28, 2018, 7:51am UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/7 "2018-02-28T07:51:10Z")

</div>

I was about to start the same thing. Thanks a lot !!  
When you said improve the code, you mean what we see is optimized ? Our do you have better code to share ? Anyway thanks again @brunoamaral

---

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [February 28, 2018, 8:40am UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/8 "2018-02-28T08:40:55Z")

</div>

The one above is the latest and should work almost out-of-the-box. It’s just that right now you can’t use the shortcode more than once in a page or post. ☹

---

<div class="post-metadata">

### Author: ![xdk88](https://avatars.discourse-cdn.com/v4/letter/x/91b2a8/32.png) [@xdk88](https://discourse.gohugo.io/u/xdk88)
#### Post date: [November 24, 2018, 4:19pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/9 "2018-11-24T16:19:16Z")

</div>

Hello!

I seem to struggle with implementing the gallery.  
I’m using the following shortcode in the post:  
`{{% gallery folder="img/gallery1/*.jpg" title="gallery" %}}`  
The jpg files are located in `static/gallery1`.

But the rendered page only shows the title _gallery_ on the page, not the pictures.

Any ideas? Thanks for your help!

---

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [November 24, 2018, 4:50pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/10 "2018-11-24T16:50:51Z")

</div>

your folder should be gallery1, try

```auto
{{% gallery folder="gallery1" title="gallery" %}}

```

If your folder `gallery1` is inside `img/` then it is something I didn’t test before. Let me know how it goes. 🙂  
EDIT: Sorry only now did I notice that your files are in static. That won’t work. they need to be inside the page-bundle. So something like this path:  
`/content/post/my-post/index.md <-- your post and frontmatter.`

and then `/content/post/my-post/gallery1 <-- the images for your gallery`

---

<div class="post-metadata">

### Author: ![juh2](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/juh2/32/3980_2.png) [@juh2](https://discourse.gohugo.io/u/juh2)
#### Post date: [August 23, 2019, 12:43pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/11 "2019-08-23T12:43:25Z")

</div>

If have the same problem. Only the title shows up.

index.md:

```
---
title: foo
resources: 
- src: "gallery1/*.jpg"
  name: Fotorundgang
  title: Fotorundgang
 ---

{{% gallery folder="gallery1" title="Rundgang" %}}

```

Images are in the folder `gallery1` in the content folder

Output:

```
<link rel="stylesheet" href="/plugins/photoswipe/photoswipe.css">
<link rel="stylesheet" href="/plugins/photoswipe/default-skin/default-skin.css">

<h4 class="title">Rundgang</h4>
<div class="row">
<div class="12u$">
<div class="gallery" itemscope itemtype="http://schema.org/ImageGallery">

</div>
</div>

```

Followed by style and js code of the shortcode

My guess is that the code does not play with hugo v0.54

---

<div class="post-metadata">

### Author: ![brunoamaral](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/brunoamaral/32/21144_2.png) [@brunoamaral](https://discourse.gohugo.io/u/brunoamaral)
#### Post date: [August 24, 2019, 6:36pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/12 "2019-08-24T18:36:59Z")

</div>

The resource name must match the folder name. That’s why it isn’t working.

This got so much attention that I went ahead and put everything in a blog post:

[https://brunoamaral.eu/post/creating-a-gallery-component-for-the-hugo-static-site-generator/](https://brunoamaral.eu/post/creating-a-gallery-component-for-the-hugo-static-site-generator/)

---

<div class="post-metadata">

### Author: ![juh2](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/juh2/32/3980_2.png) [@juh2](https://discourse.gohugo.io/u/juh2)
#### Post date: [August 25, 2019, 9:39am UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/13 "2019-08-25T09:39:52Z")

</div>

Thanks a lot.

With this exact snippet it works:

- src: “gallery/\*.jpg”  
name: gallery-:counter  
title: gallery-title-:counter

I thought that “name” and “title” could be customized.

---

<div class="post-metadata">

### Author: ![inder](https://avatars.discourse-cdn.com/v4/letter/i/73ab20/32.png) [@inder](https://discourse.gohugo.io/u/inder)
#### Post date: [March 8, 2021, 4:51pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/14 "2021-03-08T16:51:45Z")

</div>

Does photo swipe support .avif .webp etc have you try to set it up to load

/avif/gallery1  
and then fallback to the browser supported format folder  
/webp/gallery1  
jpeg/gallery1

---

<div class="post-metadata">

### Author: ![alexandros](https://avatars.discourse-cdn.com/v4/letter/a/ecc23a/32.png) [@alexandros](https://discourse.gohugo.io/u/alexandros)
#### Post date: [March 8, 2021, 5:42pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/15 "2021-03-08T17:42:13Z")

</div>

This is a question for the PhotoSwipe maintainer. It is OT in this forum.

> **[dimsemenov/PhotoSwipe](https://github.com/dimsemenov/PhotoSwipe/issues/)**
>
> s/

---

<div class="post-metadata">

### Author: ![alexandros](https://avatars.discourse-cdn.com/v4/letter/a/ecc23a/32.png) [@alexandros](https://discourse.gohugo.io/u/alexandros)
#### Post date: [March 8, 2021, 5:42pm UTC](https://discourse.gohugo.io/t/adding-a-photoswipe-gallery-as-a-shortcode-using-page-resources/10672/16 "2021-03-08T17:42:21Z")

</div>