Gravity Perks Media Library 1.2.22

Gravity Perks Media Library allows to automatically import uploaded files (images, documents, etc.) to the WordPress Media Library when the form is submitted.

This plugin enhances Gravity Perks Media Library with the ability to automatically import uploaded files (images, documents, etc.) to the WordPress Gravity Perks Media Library when the form is submitted.

Features

Documentation

1. How do I enable this functionality?
2. Feature Details
   1. Image Merge Tags
   2. ACF Support
   3. Developer Usage
      1. Get File ID’s in a WordPress Template
      2. Get file ID for a Single File Upload field
      3. Get file ID’s for a Multi-file Upload field
      4. Get file ID of the 2nd file in a Multi-file Upload field
3. FAQs
   1. How can I set a maximum width/height or quality for uploaded images?
   2. Will this work if I store my images with a cloud storage provider?
   3. How can I prevent WordPress from scaling down large images?
   4. How can I automatically enable this for all fields?
4. Hooks
5. Related Articles

How do I enable this functionality?

After installing and activating Gravity Forms Media Library, media library uploads become available in File Upload fields within any form. Let’s step through how to turn them on.

That’s it! Now all files and images will be uploaded to your Media Library from your form when it is submitted.

Feature Details

Image Merge Tags

Gravity Perks Media Library also supports outputting the uploaded images in Notification Emails and Confirmation Messages. This is done via merge tags.

It supports everything supported by Gravity Perks Media Library for Post Image merge tags. View Gravity Forms merge tag documentation.

You will find the available merge tags in the Gravity Perks Media Library section of the Gravity Forms merge tag selector.

By default, the four standard WordPress sizes will be displayed (thumbnail, medium, large, full) and up to four custom sizes per field.

You can also modify which image merge tags are available with the gpml_merge_tag_image_sizes hook

Lastly, while merge tags will still display for all File Upload fields, this will only work correctly for images that are uploaded to the field.

ACF Support

Need to integrate this with Advanced Custom Fields? No problem, we have you covered! Check out our article on How to Add Advanced Custom Fields Support for GP Media Library

Developer Usage

Here are some examples of how to retrieve the files and images that are added to the WordPress Media Library by Gravity Perks Media Library.

One case where this would be useful would be to retrieve the file ID of the image in order to output different sizes of the image that are created by WordPress.

Get File ID’s in a WordPress Template

Get file ID for a Single File Upload field

Get file ID’s for a Multi-file Upload field

Get file ID of the 2nd file in a Multi-file Upload field

FAQs

How can I set a maximum width/height or quality for uploaded images?

Use EWWW Image Optimizer to automatically optimize and resize images uploaded through GP Media Library.

To set a maximum width or height, click the Resize tab in EWWW Image Optimizer’s settings and set the max width and height. No additional settings are needed for optimization.

Will this work if I store my images with a cloud storage provider?

Yep! If you want to offload your images onto a cloud storage provider, we recommend WP Offload Media Lite. No additional setup is needed.

How can I prevent WordPress from scaling down large images?

WordPress automatically scales very large images (>2560px) when they are imported into the Media Library. This can be disabled using this hook:

add_filter( 'big_image_size_threshold', '__return_false' );

Unless you have a specific need for allowing very large file uploads, we do not recommend removing the big image size threshold.

How can I automatically enable this for all fields?

You can use the snippet below to enable the Media Library setting on all File Upload Fields on the website, to ensure that all uploaded files are always saved in the Media Folder.

The snippet will apply the setting when the form is edited.