FREE block. Displays a JavaScript-driven image slider for a fundraising action, using the featured image and any additional gallery images.
Why use this
A photo gallery makes fundraising actions more personal and compelling. The gallery block combines the featured image with extra images uploaded by the creator into a single navigable slideshow.
What it does
The block prepends the featured image as the first slide, then appends any images stored in the _get_fund_gallery_images meta (managed by the gallery uploader in the action wizard and frontend edit form). Each slide can open a full-size lightbox when clicked. Navigation dots and arrows are optional. Autoplay with a configurable interval is available.
Note: percentage values for sliderHeight are rejected and fall back to 400px.
The block supports Query Loop context.
How to use it
- Add the Image Gallery block to your action template.
- Set width, height, border radius, and image size in the inspector.
- Toggle dots, arrows, lightbox, and autoplay as preferred.
- Gallery images are added by the fundraiser creator using the image uploader in the Action Wizard or frontend edit form.
Settings and options
| Option | Type | Default | Description |
|---|---|---|---|
| Slider width | string | 100% | CSS width value |
| Slider height | string | 400px | CSS height value; percentage values fall back to 400px |
| Image size | string | large | WordPress registered image size name |
| Border radius | number | 12 | Corner rounding in pixels |
| Show dots | boolean | true | Navigation dot indicators |
| Show arrows | boolean | true | Previous/next arrow buttons |
| Autoplay | boolean | false | Auto-advance slides |
| Autoplay speed | number | 5000 | Time between slides in milliseconds |
| Lightbox | boolean | true | Open full-size image on click |
| Post ID override | number | 0 | Force a specific post ID |
What you can and cannot do
- Slider height must be a pixel value. Percentage heights are not supported.
- The block does not expose an output filter.
- Gallery images are managed through the action creation and edit flows, not through this block’s settings.
Troubleshooting
Only one slide appears: The action has no gallery images, only a featured image. The creator can add more images via the frontend edit form.
Slider height collapses: A percentage value was entered for height. Use a pixel value instead (e.g., 400px).