submission ); } /** * Searches input for tags {field:FIELD_NAME} and replaces with field values. * Also replaces general tags such as {all_fields}. * * @since 1.0.1 * */ function af_resolve_field_includes( $input, $fields = false ) { // Get fields from the global submission object if fields weren't passed if ( ! $fields && af_has_submission() ) { $fields = AF()->submission['fields']; } // Render all fields as a table if ( preg_match_all( "/{all_fields}/", $input, $matches ) ) { $output = ''; foreach ( $fields as $field ) { if ( 'clone' == $field['type'] ) { foreach ( $field['sub_fields'] as $sub_field ) { $output .= sprintf( '', $sub_field['label'] ); $output .= sprintf( '', _af_render_field_include( $sub_field, $field['value'][ $sub_field['name'] ] ) ); } } else { $output .= sprintf( '', $field['label'] ); $output .= sprintf( '', _af_render_field_include( $field ) ); } } $output .= '

%s
%s
%s
%s

'; $input = str_replace( '{all_fields}', $output, $input ); } // Render single fields individually if ( preg_match_all( "/{field:(.*?)}/", $input, $matches ) ) { foreach ($matches[1] as $i => $field_name ) { $field = af_get_field_object( $field_name ); $rendered_value = _af_render_field_include( $field ); $input = str_replace( $matches[0][$i], $rendered_value, $input ); } } return $input; } /** * Renders a single field include (for emails, success messages etc.) * * @since 1.2.0 * */ function _af_render_field_include( $field, $value = false ) { if ( ! $value ) { $value = $field['value']; } $output = ''; if ( 'repeater' == $field['type'] && is_array( $value ) ) { $output .= ''; // Column headings $output .= ''; foreach ( $field['sub_fields'] as $sub_field ) { $output .= sprintf( '', $sub_field['label'] ); } $output .= ''; // Rows $output .= ''; if ( is_array( $value ) ) { foreach ( $value as $row_values ) { $output .= ''; foreach ( $field['sub_fields'] as $sub_field ) { $output .= sprintf( '', _af_render_field_include( $sub_field, $row_values[ $sub_field['name'] ] ) ); } $output .= ''; } } $output .= ''; $output .= '

%s
%s

'; } elseif ( 'clone' == $field['type'] ) { $output .= ''; foreach ( $field['sub_fields'] as $sub_field ) { $output .= sprintf( '', $sub_field['label'] ); $output .= sprintf( '', _af_render_field_include( $sub_field, $field['value'][ $sub_field['name'] ] ) ); } $output .= '

%s
%s

'; } elseif ( 'true_false' == $field['type'] ) { $true_text = isset( $field['ui_on_text'] ) && ! empty( $field['ui_on_text'] ) ? $field['ui_on_text'] : __( 'Yes', 'advanced-forms' ); $false_text = isset( $field['ui_off_text'] ) && ! empty( $field['ui_off_text'] ) ? $field['ui_off_text'] : __( 'No', 'advanced-forms' ); $output = $value ? $true_text : $false_text; } elseif ( 'image' == $field['type'] ) { $output .= sprintf( '

', esc_attr( $value['sizes']['medium'] ), esc_attr( $value['alt'])); } elseif ( 'file' == $field['type'] ) { $output .= sprintf( '%s', $value['url'], htmlspecialchars( $value['title'] ) ); } else { /** * Handle the different shapes $value may take and create an appropriate string * * WP_Post - post title * WP_User - user first name and last name combined * User array - user first name and last name combined * WP_Term - term name * Array - render each value and join with commas * Other - cast to string * * @since 1.3.0 * */ $rendered_value = ''; if ( $value instanceof WP_Post ) { $rendered_value = $value->post_title; } elseif ( $value instanceof WP_User ) { $rendered_value = sprintf( '%s %s', $value->first_name, $value->last_name ); } elseif ( is_array( $value ) && isset( $value['user_email'] ) ) { $rendered_value = sprintf( '%s %s', $value['user_firstname'], $value['user_lastname'] ); } elseif ( $value instanceof WP_Term ) { $rendered_value = $value->name; } elseif ( is_array( $value ) ) { $rendered_values = array(); foreach ( $value as $single_value ) { $rendered_values[] = _af_render_field_include( $field, $single_value ); } $rendered_value = join( ', ', $rendered_values ); } else { $rendered_value = (string)$value; } // Sanitize output to protect against XSS $output = htmlspecialchars( $rendered_value ); } // Allow third-parties to alter rendered field $output = apply_filters( 'af/field/render_include', $output, $field, $value ); $output = apply_filters( 'af/field/render_include/name=' . $field['name'], $output, $field, $value ); $output = apply_filters( 'af/field/render_include/key=' . $field['key'], $output, $field, $value ); return $output; } /** * Output an "Insert field" button populated with $fields * $floating adds class "floating" to the wrapper making the button float right in an input field * * @since 1.1.1 * */ function _af_field_inserter_button( $form, $type = 'all', $floating = false ) { $fields = af_get_form_fields( $form, $type ); $classses = ( $floating ) ? 'floating' : ''; echo ''; } /** * Generates choices for a form field picker. * Returns an array with field key => field label suitable for usage with an ACF select field. * * $type can be either 'all' or 'regular'. * * @since 1.3.0 * */ function _af_form_field_choices( $form_key, $type = 'all' ) { $form_fields = af_get_form_fields( $form_key, $type ); $choices = array(); if ( ! empty( $form_fields ) ) { foreach ( $form_fields as $field ) { $choices[ $field['key'] ] = $field['label']; } } return $choices; } /** * Retrieves full URL (with trailing slash) to the plugin assets folder * * @since 1.3.0 * */ function af_assets_url( $path = '' ) { return plugin_dir_url( dirname( __FILE__ ) ) . 'assets/' . $path; }