• Home
  • Pricing
  • Free Resources
  • About
  • Docs
  • Support
  • Account

Gravity Wiz

Magically enhanced tutorials, snippets and plugins for Gravity Forms!

  • Gravity Perks
    • Gravity Perks
    • Pricing
  • Blog
    • Free Resources
    • About
  • Support
    • Docs
    • Support
    • Account

gpml_media_data

  1. Description
  2. Usage
  3. Parameters
  4. Examples
    1. Set Uploaded Image Data
  5. Since

Description

Filter the data that will be used to upload and generate the new media file.

Usage

Apply to all files for all forms and fields.

add_filter( 'gpml_media_data', 'my_custom_function' );

Apply to all files for all fields of a specific form.

add_filter( 'gpml_media_data_FORMID', 'my_custom_function' );

Apply to all files for a specific form and field.

add_filter( 'gpml_media_data_FORMID_FIELDID', 'my_custom_function' );

Parameters

  • $media_data array

    • $file_array array

      The details of the actual file to be uploaded.

    • $post_id int

      The attachment ID to update or 0 to upload as a new attachment.

    • $desc string

      The description of the file.

    • $post_data array

      An array of data used to populate the generated attachment post (i.e. post_title, post_content, post_excerpt).

  • $field \GF_Field

    The current field object for which the file is being uploaded.

  • $entry array

    The current entry object.

Examples

Set Uploaded Image Data

<?php
/**
 * Gravity Perks // Media Library // Set Uploaded Image Data
 * https://gravitywiz.com/documentation/gravity-forms-media-library/
 */
add_filter( 'gpml_media_data', function( $media, $field, $entry ) {

	$media['post_data']['post_title']                            = 'Boom!';
	$media['post_data']['post_content']                          = 'This is the description.';
	$media['post_data']['post_excerpt']                          = 'This is the caption.';
	$media['post_data']['post_meta']['_wp_attachment_image_alt'] = 'This is the alt text.';

	return $media;
}, 10, 3 );

Since

This filter is available since Gravity Forms Media Library 1.0.11.

All Perks

  • GF Address Autocomplete
  • GF Advanced Calculations
  • GF Advanced Phone Field
  • GF Auto List Field
  • GF Auto Login
  • GF Better User Activation
  • GF Blocklist
  • GF Conditional Logic Dates
  • GF Conditional Pricing
  • GF Copy Cat
  • GF Date Time Calculator
  • GF Disable Entry Creation
  • GF Easy Passthrough
  • GF eCommerce Fields
  • GF Email Users
  • GF Entry Blocks
  • GF Expand Textareas
  • GF File Renamer
  • GF File Upload Pro
  • GF Google Sheets
  • GF Inventory
  • GF Limit Checkboxes
  • GF Limit Choices
  • GF Limit Dates
  • GF Limit Submissions
  • GF Live Preview
  • GF Media Library
  • GF Multi-Page Navigation
  • GF Nested Forms
  • GF Notification Scheduler
  • GF Page Transitions
  • GF Pay Per Word
  • GF PayPal One-time Fee
  • GF Placeholder
  • GF Populate Anything
  • GF Post Content Merge Tags
  • GF Preview Submission
  • GF Price Range
  • GF QR Code
  • GF Randomizer
  • GF Read Only
  • GF Reload Form
  • GF Terms Of Service
  • GF Unique ID
  • GF Word Count

Copyright © 2023 · Powered by WordPress · Gravity Wiz LLC

  • Support
  • Affiliates
  • About
  • Sitemap
  • Terms & Conditions of Use
  • Privacy Policy
  • Cookies Policy