Each fundraising page can have a photo gallery in addition to its featured image. Gallery images can be uploaded during action creation (wizard) and managed afterwards via the frontend edit form. This is a free feature.
Why use this
A gallery lets fundraisers tell a visual story with event photos, before/after images, or field updates. Multiple images on a fundraising page increase engagement compared to a single featured image.
What it does
Gallery images are managed by the Get_Fund_Gallery singleton. Images are stored as an array of WordPress attachment IDs in the _get_fund_gallery_images meta key.
Uploading images in the wizard
The wizard accepts multiple files via the gallery_images file input. For each file:
- The MIME type is validated against the allowed types from gallery settings.
- The file is uploaded via
Get_Fund_Gallery::upload_image($file, $post_id)and attached to the post. - The total number of images is capped by the
max_imagessetting.
Managing images in the frontend edit form
Images are loaded via Get_Fund_Gallery::get_gallery($post_id), which returns an array with id, thumbnail, and alt for each image.
To remove an image, the creator unchecks or removes it. The surviving IDs are submitted as fund_gallery_keep (comma-separated). New files are uploaded via the fund_gallery_images[] multi-file input. JavaScript handles drag-to-reorder in the UI, and the new order is reflected in the fund_gallery_keep field order.
The final gallery is array_merge($kept_ids_in_new_order, $new_upload_ids), saved via Get_Fund_Gallery::set_gallery($post_id, $ids).
Allowed file types
In the frontend edit form: jpg, jpeg, png, gif, webp.
In the wizard: determined by the allowed_types array in gallery settings (filterable via get_fund_gallery_settings).
How to use it
As a fundraiser (wizard)
- On the Create Fundations page, scroll to the gallery upload field.
- Select one or more images (up to the maximum set by the admin).
- Submit the form. The gallery is attached to the new fundraising page.
As a fundraiser (editing)
- Visit the fundraising page and click Edit.
- In the edit form, find the Gallery section.
- Drag images to reorder, click the delete icon to remove, or use the file input to add new ones.
- Click Save.
Settings and options
Gallery settings are stored internally and filtered via get_fund_gallery_settings. The key settings are:
| Setting key | Description |
|---|---|
max_images | Maximum number of images per gallery |
allowed_types | Array of allowed MIME types for gallery uploads |
What you can and cannot do
You can reorder images from the frontend edit form, mix images uploaded at creation time with images added during editing, and filter the image data returned for each attachment with get_fund_gallery_image_data.
You cannot upload images larger than the server’s PHP upload_max_filesize and post_max_size limits. Non-image file types are rejected by MIME validation.
Troubleshooting
Gallery images not showing on the page. Confirm the get-fund/gallery block is present in the fundraising page template and that attachment IDs stored in _get_fund_gallery_images are valid and the files exist on disk.
Drag-to-reorder not working. A JavaScript error may be preventing the drag library from initialising. Check the browser console for errors and ensure no other plugin is interfering with drag events.
Images disappear after save. Confirm fund_gallery_keep is being submitted with the correct attachment IDs. If the form has JavaScript disabled, the reorder UI will not function and the field may submit empty.
Developer reference
Filters
| Hook | Arguments | Description |
|---|---|---|
get_fund_gallery_settings | array $settings | Modify gallery settings (including max_images and allowed_types). |
get_fund_gallery_image_data | array $image_data, int $attachment_id | Modify the image data array (id, thumbnail, alt) for each gallery image. |
Meta key
| Meta key | Type | Description |
|---|---|---|
_get_fund_gallery_images | array | Array of WordPress attachment IDs for the gallery. |