class-gravityview-merge-tags.php

Go to the documentation of this file.

<?php

/**
 * Enhance Gravity Forms' merge tag functionality by adding additional merge tags
 * @since 1.8.4
 */
class GravityView_Merge_Tags {

    /**
     * @since 1.8.4
     */
    public function __construct() {
        $this->add_hooks();
    }

    /**
     * Tap in to gform_replace_merge_tags to add merge tags
     * @since 1.8.4
     */
    private function add_hooks() {

        /** @see GFCommon::replace_variables_prepopulate **/
        add_filter( 'gform_replace_merge_tags', array( 'GravityView_Merge_Tags', 'replace_gv_merge_tags' ), 10, 7 );

        // Process after 10 priority
        add_filter( 'gform_merge_tag_filter', array( 'GravityView_Merge_Tags', 'process_modifiers' ), 20, 5 );

    }

    /**
     * Process custom GravityView modifiers for Merge Tags
     *
     * Is not processed on `{all_fields}` Merge Tag.
     *
     * @since 1.17
     *
     * @param string $value The current merge tag value to be filtered.
     * @param string $merge_tag If the merge tag being executed is an individual field merge tag (i.e. {Name:3}), this variable will contain the field's ID. If not, this variable will contain the name of the merge tag (i.e. all_fields).
     * @param string $modifier The string containing any modifiers for this merge tag. For example, "maxwords:10" would be the modifiers for the following merge tag: `{Text:2:maxwords:10}`.
     * @param GF_Field $field The current field.
     * @param mixed $raw_value The raw value submitted for this field.
     *
     * @return string If no modifiers passed, $raw_value is not a string, or {all_fields} Merge Tag is used, original value. Otherwise, output from modifier methods.
     */
    public static function process_modifiers( $value, $merge_tag, $modifier, $field, $raw_value ) {

        // No modifier was set or the raw value was empty
        if ( 'all_fields' === $merge_tag || '' === $modifier || ! is_string( $raw_value ) || '' === $raw_value ) {
            return $value;
        }

        // matching regex => the value is the method to call to replace the value.
        $gv_modifiers = array(
            'maxwords:(\d+)' => 'modifier_maxwords', /** @see modifier_maxwords */
            'timestamp' => 'modifier_timestamp', /** @see modifier_timestamp */
            'explode' => 'modifier_explode', /** @see modifier_explode */

            /** @see modifier_strings */
            'urlencode' => 'modifier_strings',
            'wpautop' => 'modifier_strings',
            'esc_html' => 'modifier_strings',
            'sanitize_html_class' => 'modifier_strings',
            'sanitize_title' => 'modifier_strings',
            'strtolower' => 'modifier_strings',
            'strtoupper' => 'modifier_strings',
            'ucfirst' => 'modifier_strings',
            'ucwords' => 'modifier_strings',
            'wptexturize' => 'modifier_strings',
        );

        $modifiers = explode( ',', $modifier );

        $return = $raw_value;

        $unserialized = maybe_unserialize( $raw_value );

        if ( method_exists( $field, 'get_value_merge_tag' ) && is_array( $unserialized ) ) {

            $non_gv_modifiers = array_diff( $modifiers, array_keys( $gv_modifiers ) );

            $return = $field->get_value_merge_tag( $value, '', array( 'currency' => '' ), array(), implode( '', $non_gv_modifiers ), $raw_value, false, false, 'text', false);
        }

        foreach ( $modifiers as $passed_modifier ) {

            foreach( $gv_modifiers as $gv_modifier => $method ) {

                // Uses ^ to only match the first modifier, to enforce same order as passed by GF
                preg_match( '/^' . $gv_modifier . '/ism', $passed_modifier, $matches );

                if ( empty( $matches ) ) {
                    continue;
                }

                // The called method is passed the raw value and the full matches array
                $return = self::$method( $return, $matches, $value, $field );
                break;
            }
        }

        // No GravityView modifications were made; return the (default) original value
        if ( $raw_value === $return ) {
            return $value;
        }

        /**
         * @filter `gravityview/merge_tags/modifiers/value` Modify the merge tag modifier output
         * @since 2.0
         * @param string $return The current merge tag value to be filtered.
         * @param string $raw_value The raw value submitted for this field. May be CSV or JSON-encoded.
         * @param string $value The original merge tag value, passed from Gravity Forms
         * @param string $merge_tag If the merge tag being executed is an individual field merge tag (i.e. {Name:3}), this variable will contain the field's ID. If not, this variable will contain the name of the merge tag (i.e. all_fields).
         * @param string $modifier The string containing any modifiers for this merge tag. For example, "maxwords:10" would be the modifiers for the following merge tag: `{Text:2:maxwords:10}`.
         * @param GF_Field $field The current field.
         */
        $return = apply_filters( 'gravityview/merge_tags/modifiers/value', $return, $raw_value, $value, $merge_tag, $modifier, $field );

        return $return;
    }

    /**
     * Convert Date field values to timestamp int
     *
     * @since 1.17
     *
     * @uses strtotime()
     *
     * @param string $raw_value Value to filter
     * @param array $matches Regex matches group
     *
     * @return int Timestamp value of date. `-1` if not a valid timestamp.
     */
    private static function modifier_timestamp( $raw_value, $matches ) {

        if( empty( $matches[0] ) ) {
            return $raw_value;
        }

        $timestamp = strtotime( $raw_value );

        // Can return false or -1, depending on PHP version.
        return ( $timestamp && $timestamp > 0 ) ? $timestamp : -1;
    }

    /**
     * Trim the Merge Tag's length in words.
     *
     * Notes:
     * - HTML tags are preserved
     * - HTML entities are encoded, but if they are separated by word breaks, they will be counted as words
     *   Example: "one & two" will be counted as three words, but "one& two" will be counted as two words
     *
     * @since 1.17
     * @since 2.0 Added $field param and support for urlencode
     *
     * @param string $raw_value Value to filter
     * @param array $matches Regex matches group
     * @param GF_Field|false $field
     *
     * @return string Modified value, if longer than the passed `maxwords` modifier
     */
    private static function modifier_maxwords( $raw_value, $matches, $field = null ) {

        if( ! is_string( $raw_value ) || empty( $matches[1] ) || ! function_exists( 'wp_trim_words' ) ) {
            return $raw_value;
        }

        $max = intval( $matches[1] );

        $more_placeholder = '[GVMORE]';

        /**
         * Use htmlentities instead, so that entities are double-encoded, and decoding restores original values.
         * @see https://core.trac.wordpress.org/ticket/29533#comment:3
         */
        $return = force_balance_tags( wp_specialchars_decode( wp_trim_words( htmlentities( $raw_value ), $max, $more_placeholder ) ) );

        $return = str_replace( $more_placeholder, '&hellip;', $return );

        return self::maybe_urlencode( $field, $return );
    }

    /**
     * GF 2.3 adds GF_Field::get_modifers(), which allows us to check if a field has urlencode applied to it
     *
     * @since 2.0
     *
     * @see GFCommon::replace_field_variable
     *
     * Here's the relevant code:
     *
     * <code>
     * $modifier  = strtolower( rgar( $match, $i ) );
     * $modifiers = array_map( 'trim', explode( ',', $modifier ) );
     * $field->set_modifiers( $modifiers );
     * </code>
     *
     * @param GF_Field|false $field
     * @param string $value
     *
     * @return mixed|string
     */
    private static function maybe_urlencode( $field = false, $value = '' ) {

        $return = $value;

        if ( $field && method_exists( $field, 'get_modifiers' ) ) {

            $modifiers = $field->get_modifiers();

            if ( in_array( 'urlencode', $modifiers ) ) {
                $return = urlencode( $return );
            }
        }

        return $return;
    }


    /**
     * Convert JSON or CSV values into space-separated string
     *
     * Useful for Multiple Select field data, like categories
     *
     * @since 2.0
     *
     * @param mixed $raw_value The raw value submitted for this field. May be CSV or JSON-encoded.
     * @param array $matches Regex matches group
     * @param string $value The value as passed by Gravity Forms
     * @param GF_Field|false $field Gravity Forms field, if any
     *
     * @return string
     */
    private static function modifier_explode( $raw_value, $matches, $value, $field = null ) {

        // For JSON-encoded arrays
        if( $json_array = json_decode( $raw_value, true ) ) {
            return implode( ' ', $json_array );
        }

        return implode( ' ', explode( ',', $raw_value ) );
    }

    /**
     * Process strings with common PHP string manipulations
     *
     * @since 2.0
     *
     * @param mixed $raw_value The raw value submitted for this field. May be CSV or JSON-encoded.
     * @param array $matches Regex matches group
     * @param string $value The value as passed by Gravity Forms
     * @param GF_Field|false $field Gravity Forms field, if any
     *
     * @return string
     */
    private static function modifier_strings( $raw_value, $matches, $value = '', $field = null ) {

        if( empty( $matches[0] ) ) {
            return $raw_value;
        }

        $return = $raw_value;

        switch( $matches[0] ) {
            case 'urlencode':
                $return = urlencode( $raw_value );
                break;
            case 'wpautop':
                $return = trim( wpautop( $raw_value ) );
                break;
            case 'esc_html':
                $return = esc_html( $raw_value );
                break;
            case 'sanitize_html_class':
                $return = function_exists( 'gravityview_sanitize_html_class' ) ? gravityview_sanitize_html_class( $raw_value ) : sanitize_html_class( $raw_value );
                break;
            case 'sanitize_title':
                $return = sanitize_title( $raw_value, '', 'gravityview/merge-tags/modifier' );
                break;
            case 'strtoupper':
                $return = function_exists( 'mb_strtoupper' ) ? mb_strtoupper( $raw_value ) : strtoupper( $raw_value );
                break;
            case 'strtolower':
                $return = function_exists( 'mb_strtolower' ) ? mb_strtolower( $raw_value ) : strtolower( $raw_value );
                break;
            case 'ucwords':
                $return = ucwords( $raw_value );
                break;
            case 'ucfirst':
                $return = ucfirst( $raw_value );
                break;
            case 'wptexturize':
                $return = wptexturize( $raw_value );
                break;
        }

        return $return;
    }

    /**
     * Alias for GFCommon::replace_variables()
     *
     * Before 1.15.3, it would check for merge tags before passing to Gravity Forms to improve speed.
     *
     * @since 1.15.3 - Now that Gravity Forms added speed improvements in 1.9.15, it's more of an alias with a filter
     * to disable or enable replacements.
     * @since 1.8.4 - Moved to GravityView_Merge_Tags
     * @since 1.15.1 - Add support for $url_encode and $esc_html arguments
     * @since 1.22.4 - Added $nl2br, $format, $aux_data args
     *
     * @param  string           $text         Text to replace variables in.
     * @param  array            $form         GF Form array
     * @param  array            $entry        GF Entry array
     * @param  bool             $url_encode   Pass return value through `url_encode()`
     * @param  bool             $esc_html     Pass return value through `esc_html()`
     * @param  bool             $nl2br        Convert newlines to <br> HTML tags
     * @param  string           $format       The format requested for the location the merge is being used. Possible values: html, text or url.
     * @param  array            $aux_data     Additional data to be used to replace merge tags {@see https://www.gravityhelp.com/documentation/article/gform_merge_tag_data/}
     * @return string           Text with variables maybe replaced
     */
    public static function replace_variables( $text, $form = array(), $entry = array(), $url_encode = false, $esc_html = true, $nl2br = true, $format = 'html', $aux_data = array() ) {

        if ( ! is_string( $text ) ) {
            gravityview()->log->notice( '$text is not a string.', array( 'data' => $text ) );
            return $text;
        }

        /**
         * @filter `gravityview_do_replace_variables` Turn off merge tag variable replacements.\n
         * Useful where you want to process variables yourself. We do this in the Math Extension.
         * @since 1.13
         *
         * @param boolean $do_replace_variables True: yes, replace variables for this text; False: do not replace variables.
         * @param string $text       Text to replace variables in
         * @param  array      $form        GF Form array
         * @param  array      $entry        GF Entry array
         */
        $do_replace_variables = apply_filters( 'gravityview/merge_tags/do_replace_variables', true, $text, $form, $entry );

        if ( strpos( $text, '{' ) === false || ! $do_replace_variables ) {
            return $text;
        }

        /**
         * Make sure the required keys are set for GFCommon::replace_variables
         *
         * @internal Reported to GF Support on 12/3/2016
         * @internal Fixed $form['title'] in Gravity Forms
         * @see      https://github.com/gravityforms/gravityforms/pull/27/files
         */
        $form['title']  = isset( $form['title'] ) ? $form['title'] : '';
        $form['id']     = isset( $form['id'] ) ? $form['id'] : '';
        $form['fields'] = isset( $form['fields'] ) ? $form['fields'] : array();

        return GFCommon::replace_variables( $text, $form, $entry, $url_encode, $esc_html, $nl2br, $format, $aux_data );
    }

    /**
     * Run GravityView filters when using GFCommon::replace_variables()
     *
     * Instead of adding multiple hooks, add all hooks into this one method to improve speed
     *
     * @since 1.8.4
     *
     * @param string $text Text to replace
     * @param array|bool $form Gravity Forms form array. When called inside {@see GFCommon::replace_variables()} (now deprecated), `false`
     * @param array|bool $entry Entry array.  When called inside {@see GFCommon::replace_variables()} (now deprecated), `false`
     * @param bool $url_encode Whether to URL-encode output
     * @param bool $esc_html Whether to apply `esc_html()` to output
     *
     * @return mixed
     */
    public static function replace_gv_merge_tags( $text, $form = array(), $entry = array(), $url_encode = false, $esc_html = false ) {

        if ( '' === $text ) {
            return $text;
        }

        /**
         * This prevents the gform_replace_merge_tags filter from being called twice, as defined in:
         * @see GFCommon::replace_variables()
         * @see GFCommon::replace_variables_prepopulate()
         * @todo Remove eventually: Gravity Forms fixed this issue in 1.9.14
         */
        if ( false === $form ) {
            return $text;
        }

        $text = self::replace_is_starred( $text, $form, $entry, $url_encode, $esc_html );

        $text = self::replace_site_url( $text, $form, $entry, $url_encode, $esc_html );

        $text = self::replace_get_variables( $text, $form, $entry, $url_encode );

        $text = self::replace_current_post( $text, $form, $entry, $url_encode, $esc_html );

        $text = self::replace_entry_link( $text, $form, $entry, $url_encode, $esc_html );

        return $text;
    }

    /**
     * Add a {is_starred} Merge Tag
     *
     * @since 2.14
     *
     * @param string $original_text Text to replace
     * @param array $form Gravity Forms form array
     * @param array $entry Entry array
     * @param bool $url_encode Whether to URL-encode output
     * @param bool $esc_html Indicates if the esc_html function should be applied.
     *
     * @return string Original text, if no {site_url} Merge Tags found, otherwise text with Merge Tag replaced
     */
    public static function replace_is_starred( $original_text, $form = array(), $entry = array(), $url_encode = false, $esc_html = false ) {

        if ( false === strpos( $original_text, '{is_starred}' ) ) {
            return $original_text;
        }

        return str_replace( '{is_starred}', rgar( $entry, 'is_starred', '' ), $original_text );
    }

    /**
     * Add a {site_url} Merge Tag
     *
     * @since 2.10.1
     *
     * @param string $original_text Text to replace
     * @param array $form Gravity Forms form array
     * @param array $entry Entry array
     * @param bool $url_encode Whether to URL-encode output
     * @param bool $esc_html Indicates if the esc_html function should be applied.
     *
     * @return string Original text, if no {site_url} Merge Tags found, otherwise text with Merge Tag replaced
     */
    public static function replace_site_url( $original_text, $form = array(), $entry = array(), $url_encode = false, $esc_html = false ) {

        if ( false === strpos( $original_text, '{site_url}' ) ) {
            return $original_text;
        }

        $site_url = get_site_url();

        if( $url_encode ) {
            $site_url = urlencode( $site_url );
        }

        if ( $esc_html ) {
            $site_url = esc_html( $site_url );
        }

        return str_replace( '{site_url}', $site_url, $original_text );
    }

    /**
     * Add a {gv_entry_link} Merge Tag, alias of [gv_entry_link] shortcode in {gv_entry_link:[post id]:[action]} format
     *
     * @param string $original_text Text to replace
     * @param array $form Gravity Forms form array
     * @param array $entry Entry array
     * @param bool $url_encode Whether to URL-encode output
     * @param bool $esc_html Indicates if the esc_html function should be applied.
     *
     * @return string Original text, if no {gv_entry_link} Merge Tags found, otherwise text with Merge Tags replaced
     */
    public static function replace_entry_link( $original_text, $form = array(), $entry = array(), $url_encode = false, $esc_html = false ) {

        // Is there is {gv_entry_link} or {gv_entry_link:[post id]} or {gv_entry_link:[post id]:[action]} merge tag?
        preg_match_all( "/{gv_entry_link(?:\:(\d+)\:?(.*?))?}/ism", $original_text, $matches, PREG_SET_ORDER );

        if( empty( $matches ) ) {
            return $original_text;
        }

        if ( ! class_exists( 'GravityView_Entry_Link_Shortcode' ) ) {
            gravityview()->log->error( 'GravityView_Entry_Link_Shortcode not found' );
            return $original_text;
        }

        $Shortcode = new GravityView_Entry_Link_Shortcode;

        $return = $original_text;

        /**
         * @param array $match {
         *   $match[0] Full tag
         *   $match[1] Post ID (optional)
         *   $match[2] Action (optional)
         * }
         */
        foreach ( $matches as $match ) {
            $full_tag = $match[0];

            $link_args = array(
                'return' => 'url',
                'entry_id' => $entry['id'],
                'post_id' => \GV\Utils::get( $match, 1, null ),
                'action' => \GV\Utils::get( $match, 2, 'read' ),
            );

            $entry_link = $Shortcode->read_shortcode( $link_args, null, 'gv_entry_link_merge_tag' );

            if( $url_encode ) {
                $entry_link = urlencode( $entry_link );
            }

            if ( $esc_html ) {
                $entry_link = esc_html( $entry_link );
            }

            $return = str_replace( $full_tag, $entry_link, $return );
        }

        return $return;
    }

    /**
     * Format Merge Tags using GVCommon::format_date()
     *
     * @uses GVCommon::format_date()
     *
     * @see https://docs.gravityview.co/article/331-date-created-merge-tag for documentation
     * @todo Once Gravity Forms 2.5 becomes the minimum requirement, this is no longer needed.
     *
     * @param string $date_created The Gravity Forms date created format
     * @param string $property Any modifiers for the merge tag (`human`, `format:m/d/Y`)
     *
     * @return int|string If timestamp requested, timestamp int. Otherwise, string output.
     */
    public static function format_date( $date_created = '', $property = '' ) {

        // Expand all modifiers, skipping escaped colons. str_replace worked better than preg_split( "/(?<!\\):/" )
        $exploded = explode( ':', str_replace( '\:', '|COLON|', $property ) );

        $atts = array(
            'format' => self::get_format_from_modifiers( $exploded, false ),
            'human' => in_array( 'human', $exploded ), // {date_created:human}
            'diff' => in_array( 'diff', $exploded ), // {date_created:diff}
            'raw' => in_array( 'raw', $exploded ), // {date_created:raw}
            'timestamp' => in_array( 'timestamp', $exploded ), // {date_created:timestamp}
            'time' => in_array( 'time', $exploded ),  // {date_created:time}
        );

        $formatted_date = GVCommon::format_date( $date_created, $atts );

        return $formatted_date;
    }

    /**
     * If there is a `:format` modifier in a merge tag, grab the formatting
     *
     * The `:format` modifier should always have the format follow it; it's the next item in the array
     * In `foo:format:bar`, "bar" will be the returned format
     *
     * @since 1.16
     *
     * @param array $exploded Array of modifiers with a possible `format` value
     * @param string $backup The backup value to use, if not found
     *
     * @return string If format is found, the passed format. Otherwise, the backup.
     */
    private static function get_format_from_modifiers( $exploded, $backup = '' ) {

        $return = $backup;

        $format_key_index = array_search( 'format', $exploded );

        // If there's a "format:[php date format string]" date format, grab it
        if ( false !== $format_key_index && isset( $exploded[ $format_key_index + 1 ] ) ) {
            // Return escaped colons placeholder
            $return = str_replace( '|COLON|', ':', $exploded[ $format_key_index + 1 ] );
        }

        return $return;
    }

    /**
     * Add a {current_post} Merge Tag for information about the current post (in the loop or singular)
     *
     * {current_post} is replaced with the current post's permalink by default, when no modifiers are passed.
     * Pass WP_Post properties as :modifiers to access.
     *
     * {current_post} is the same as {embed_post}, except:
     *
     * - Adds support for {current_post:permalink}
     * - Works on post archives, as well as singular
     *
     * @see https://www.gravityhelp.com/documentation/article/merge-tags/#embed-post for examples
     * @see GFCommon::replace_variables_prepopulate - Code is there for {custom_field} and {embed_post} Merge Tags
     *
     * @param string $original_text Text to replace
     * @param array $form Gravity Forms form array
     * @param array $entry Entry array
     * @param bool $url_encode Whether to URL-encode output
     * @param bool $esc_html Indicates if the esc_html function should be applied.
     *
     * @return string Original text, if no {current_post} Merge Tags found, otherwise text with Merge Tags replaced
     */
    public static function replace_current_post( $original_text, $form = array(), $entry = array(), $url_encode = false, $esc_html = false ) {

        $return = $original_text;

        // Is there a {current_post} or {current_post:[xyz]} merge tag?
        preg_match_all( "/{current_post(:(.*?))?}/ism", $original_text, $matches, PREG_SET_ORDER );

        // If there are no matches OR the Entry `created_by` isn't set or is 0 (no user)
        if ( empty( $matches ) ) {
            return $original_text;
        }

        $current_post = get_post();

        // WP_Error, arrays and NULL aren't welcome here.
        if ( ! $current_post || ! is_a( $current_post, 'WP_Post' ) ) {
            return $original_text;
        }

        foreach ( (array) $matches as $match ) {
            $full_tag = $match[0];
            $modifier = \GV\Utils::get( $match, 2, 'permalink' );

            $replacement = false;

            if ( 'permalink' === $modifier ) {
                $replacement = get_permalink( $current_post );
            } elseif ( isset( $current_post->{$modifier} ) ) {
                /** @see WP_Post Post properties */
                $replacement = $current_post->{$modifier};
            }

            if ( $replacement ) {

                if ( $esc_html ) {
                    $replacement = esc_html( $replacement );
                }

                if( $url_encode ) {
                    $replacement = urlencode( $replacement );
                }

                $return = str_replace( $full_tag, $replacement, $return );
            }
        }

        return $return;
    }

    /**
     * Allow passing variables via URL to be displayed in Merge Tags
     *
     * Works with `[gvlogic]`:
     *     [gvlogic if="{get:example}" is="false"]
     *          ?example=false
     *     [else]
     *          ?example wasn't "false". It's {get:example}!
     *     [/gvlogic]
     *
     * Supports passing arrays:
     *     URL: `example[]=Example+One&example[]=Example+(with+comma)%2C+Two`
     *     Merge Tag: `{get:example}`
     *     Output: `Example One, Example (with comma), Two`
     *
     * @since 1.15
     * @param string $text Text to replace
     * @param array $form Gravity Forms form array
     * @param array $entry Entry array
     * @param bool $url_encode Whether to URL-encode output
     *
     * @return string Original text, if no Merge Tags found, otherwise text with Merge Tags replaced
     */
    public static function replace_get_variables( $text, $form = array(), $entry = array(), $url_encode = false ) {

        // Is there is {get:[xyz]} merge tag?
        preg_match_all( "/{get:(.*?)}/ism", $text, $matches, PREG_SET_ORDER );

        // If there are no matches OR the Entry `created_by` isn't set or is 0 (no user)
        if( empty( $matches ) ) {
            return $text;
        }

        foreach ( $matches as $match ) {

            $full_tag = $match[0];
            $property = $match[1];

            $value = stripslashes_deep( \GV\Utils::_GET( $property ) );

            /**
             * @filter `gravityview/merge_tags/get/glue/` Modify the glue used to convert an array of `{get}` values from an array to string
             * @since 1.15
             * @param string $glue String used to `implode()` $_GET values Default: ', '
             * @param string $property The current name of the $_GET parameter being combined
             */
            $glue = apply_filters( 'gravityview/merge_tags/get/glue/', ', ', $property );

            $value = is_array( $value ) ? implode( $glue, $value ) : $value;

            $value = $url_encode ? urlencode( $value ) : $value;

            /**
             * @filter `gravityview/merge_tags/get/esc_html/{url parameter name}` Disable esc_html() from running on `{get}` merge tag
             * By default, all values passed through URLs will be escaped for security reasons. If for some reason you want to
             * pass HTML in the URL, for example, you will need to return false on this filter. It is strongly recommended that you do
             * not disable this filter.
             * @since 1.15
             * @param bool $esc_html Whether to esc_html() the value. Default: `true`
             */
            $esc_html = apply_filters('gravityview/merge_tags/get/esc_html/' . $property, true );

            $value = $esc_html ? esc_html( $value ) : $value;

            /**
             * @filter `gravityview/merge_tags/get/esc_html/{url parameter name}` Modify the value of the `{get}` replacement before being used
             * @param string $value Value that will replace `{get}`
             * @param string $text Text that contains `{get}` (before replacement)
             * @param array $form Gravity Forms form array
             * @param array $entry Entry array
             */
            $value = apply_filters('gravityview/merge_tags/get/value/' . $property, $value, $text, $form, $entry );

            $text = str_replace( $full_tag, $value, $text );
        }

        unset( $value, $glue, $matches );

        return $text;
    }
}

new GravityView_Merge_Tags;