Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2026-01-12 18:46
📁 abstracts	-	2026-01-12 18:46
📁 addon	-	2026-01-12 18:46
📁 calculator	-	2026-01-12 18:46
📄 class-abandonment.php <?php /** * Form Abandonment Feature * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Abandonment * * Handles form abandonment tracking and analytics * * @since 1.47.0 / class Forminator_Abandonment { /* * Get abandoned entries * * @param mixed $module Module or form id. * @param int $abandoned_entries Abandoned entries. * * @return void / public static function get_abandoned_entries( $module, $abandoned_entries = null ) { // Check if abandonment feature is disabled globally. if ( forminator_form_abandonment_disabled() ) { return; } $status = self::get_abandoned_status( $module ); if ( 'active' === $status ) { if ( is_numeric( $module ) ) { $module_id = $module; $amount = $abandoned_entries ?? 0; } else { $module_id = $module['id']; $amount = $module['abandoned'] ?? 0; } echo '<a href="' . esc_url( admin_url( 'admin.php?page=forminator-entries&form_type=forminator_forms&entry_status=abandoned&form_id=' . $module_id ) ) . '" class="forminator-abandoned-submissions">' . esc_html( $amount ) . '</a>'; } else { echo self::get_abandoned_cta_link( $status ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } } /* * Get abandoned status * * @param mixed $module Module or form id. * * @return string Status. / public static function get_abandoned_status( $module ) { // Check if abandonment feature is disabled globally. if ( forminator_form_abandonment_disabled() ) { return 'disabled'; } static $status = null; if ( ! is_null( $status ) ) { return $status; } if ( is_numeric( $module ) ) { $model = Forminator_Form_Model::model()->load( $module ); } else { $model = $module['model']; } if ( self::is_feature_enabled( $model ) ) { return 'active'; } if ( self::is_plugin_active() ) { return 'inactive'; } elseif ( Forminator_Hub_Connector::hub_connector_connected() \|\| FORMINATOR_PRO ) { $status = 'not_installed'; } else { $status = 'not_connected'; } return $status; } /* * Get abandoned CTA link * * @param string $status Status. * @param string $referral Page referral. * * @return string CTA link. / public static function get_abandoned_cta_link( $status, $referral = '' ) { switch ( $status ) { case 'inactive': $cta = '<b>' . esc_html__( 'Inactive', 'forminator' ) . '</b>'; break; case 'not_installed': $cta = '<a class="forminator-icons-inherit" href="' . esc_url( admin_url( 'admin.php?page=forminator-addons&forminator_open_addon=' . Forminator_Admin_Addons_Page::EXTENSION_PACK_PID ) ) . '"' . ' target="_blank"' . '>' . '<i class="sui-icon-unlock sui-sm" aria-hidden="true"></i> ' . esc_html__( 'Get Add-on', 'forminator' ) . '</a>'; break; case 'not_connected': if ( empty( $referral ) ) { $referral = self::get_referral(); } $referral = $referral ? '&page_referral=' . $referral : ''; $url = admin_url( 'admin.php?page=forminator-addons&forminator_open_addon=' . Forminator_Admin_Addons_Page::EXTENSION_PACK_PID . $referral ); $cta = '<a class="forminator-icons-inherit forminator-link-bright-blue sui-tooltip sui-tooltip-constrained" style="--tooltip-width: 180px;"' . ' href="' . esc_url( $url ) . '"' . ' target="_blank"' . ' data-tooltip="' . esc_html__( 'Unlock abandoned form insights to refine your strategy and recover missed leads. Connect your site to install and activate the Forminator Extension Pack Add-on.', 'forminator' ) . '"' . '>' . '<i class="sui-icon-unlock sui-sm" aria-hidden="true"></i> ' . esc_html__( 'Unlock with Free Plan', 'forminator' ) . '</a>'; break; default: $cta = ''; break; } return $cta; } /* * Get referral * * @return string Referral. / public static function get_referral() { $page = filter_input( INPUT_GET, 'page' ); switch ( $page ) { case 'forminator-cform-wizard': return 'form_builder'; case 'forminator-cform': return 'forms_page'; case 'forminator-reports': return 'report_page'; default: return ''; } } /* * Check if plugin is active * * @return bool / public static function is_plugin_active() { return class_exists( 'Forminator_Extension_Pack' ); } /* * Check if the feature is enabled * * @param array $module Module. * @return bool */ public static function is_feature_enabled( $module ) { // Check if abandonment feature is disabled globally. if ( forminator_form_abandonment_disabled() ) { return false; } return self::is_plugin_active() && ! empty( $module->settings['abandonment'] ); } }	4.65 KB	2026-01-12 18:46
📄 class-api.php <?php /** * Forminator API * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * API methods class * * @since 1.2 * @access public / class Forminator_API { const MAX_CUSTOM_FORM_FIELDS_PER_WRAPPER = 4; /* * Initialize * * @param bool $admin_files Admin files?. * @return void / public static function initialize( $admin_files = false ) { // If models are not initialized, init the plugin. if ( ! class_exists( 'Forminator_Form_Model' ) ) { / @noinspection PhpUnusedLocalVariableInspection / $forminator = forminator(); } if ( $admin_files ) { include_once dirname( __DIR__ ) . '/admin/abstracts/class-admin-module.php'; include_once __DIR__ . '/modules/custom-forms/admin/admin-loader.php'; include_once __DIR__ . '/modules/polls/admin/admin-loader.php'; include_once __DIR__ . '/modules/quizzes/admin/admin-loader.php'; } } /* * Returns all form objects. * * @since 1.2.0 * @since 1.5.4 add pagination arguments * @since 1.6 add status arguments * @access public * * @param null\|array $form_ids Form Id. * @param int $page Page number. * @param int $per_page Limit per page. * @param string $status (draft,publish,any). * @param null\|int $pdf_parent_id PDF parent Id. * * @return Forminator_Form_Model[]\|WP_Error / public static function get_forms( $form_ids = null, $page = 1, $per_page = 10, $status = '', $pdf_parent_id = null ) { // Initialize API. self::initialize(); $temp = array(); if ( is_null( $form_ids ) ) { $temp = Forminator_Form_Model::model()->get_all_paged( $page, $per_page, $status, $pdf_parent_id ); if ( isset( $temp['models'] ) && is_array( $temp['models'] ) ) { return $temp['models']; } return array(); } else { if ( ! is_array( $form_ids ) ) { return new WP_Error( 'invalid_arg', esc_html__( 'Invalid Arguments', 'forminator' ) ); } if ( empty( $status ) ) { $status = 'publish'; } foreach ( $form_ids as $form_id ) { $model = self::get_module( $form_id ); if ( ! ( $model instanceof WP_Error ) && ( ( is_array( $status ) && in_array( $model->status, $status, true ) ) \|\| $status === $model->status ) ) { $temp[] = $model; } } } return $temp; } /* * Returns form object by given ID. * * @since 1.2 * @access public * * @param int $form_id ID of the form. * * @return Forminator_Form_Model\|WP_Error Custom Form Model on success or WP_Error otherwise / public static function get_form( $form_id ) { return self::get_module( $form_id ); } /* * Returns module object by given ID. * * @since 1.2 * @access public * * @param int $module_id ID of the module. * * @return Forminator_Base_Form_Model\|WP_Error Module Model on success or WP_Error otherwise / public static function get_module( $module_id ) { // Initialize API. self::initialize(); if ( empty( $module_id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Module ID is required!', 'forminator' ) ); } $model = Forminator_Base_Form_Model::get_model( $module_id ); if ( ! $model instanceof Forminator_Base_Form_Model ) { return new WP_Error( 'module_not_found', esc_html__( 'Module not found!', 'forminator' ) ); } return $model; } /* * Delete form with given ID * * @since 1.2 * @access public * * @param int $form_id ID of the form. / public static function delete_form( $form_id ) { self::delete_module( $form_id ); } /* * Delete module with given ID * * @since 1.14.11 * @access public * * @param int $module_id Module id. / public static function delete_module( $module_id ) { // Initialize API. self::initialize(); Forminator_Admin_Module_Edit_Page::delete_module( $module_id ); } /* * Delete forms with given IDs * * @since 1.2 * @access public * * @param array $form_ids Array of Form IDs. / public static function delete_forms( $form_ids ) { self::delete_modules( $form_ids ); } /* * Delete modules with given IDs * * @since 1.14.11 * @access public * * @param array $module_ids Array of Module IDs. / public static function delete_modules( $module_ids ) { if ( ! is_array( $module_ids ) ) { $module_ids = func_get_args(); } $module_ids = array_map( 'trim', $module_ids ); if ( is_array( $module_ids ) && ! empty( $module_ids ) ) { foreach ( $module_ids as $id ) { self::delete_module( $id ); } return true; } else { return new WP_Error( 'invalid', esc_html__( 'Invalid or empty array with IDs', 'forminator' ) ); } } /* * Add form * * @since 1.2 * @since 1.6 add `status` on param * @access public * * @param string $name Form name. * @param array $wrappers Array with form fields. * @param array $settings Array with form settings. * @param string $status status of form `draft` or `publish`. * * @return int\|WP_Error ID of new form, or WP_Error on failure / public static function add_form( $name, $wrappers = array(), $settings = array(), $status = Forminator_Form_Model::STATUS_PUBLISH ) { // Initialize API. self::initialize( true ); if ( empty( $name ) ) { return new WP_Error( 'missing_name', esc_html__( 'Form name is required!', 'forminator' ) ); } $template = new stdClass(); $template->fields = $wrappers; $template->settings = $settings; $id = Forminator_Custom_Form_Admin::create( $name, $status, $template ); if ( false === $id ) { return new WP_Error( 'form_save_error', esc_html__( 'There was a problem saving the form', 'forminator' ) ); } return $id; } /* * Update form * * @since 1.2 * @since 1.6 add status * @access public * * @param int $id Form ID. * @param array $wrappers Array with form fields. * @param array $settings Array with form settings. * @param string $status status of form `draft`\| `publish` \| `` for keep as it is. * @param array $notifications Array with form notifications. * * @return int\|WP_Error id of updated form, or WP_Error on failure / public static function update_form( $id, $wrappers = array(), $settings = array(), $status = '', $notifications = array() ) { // Initialize API. self::initialize( true ); if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Set the post data. $title = $settings['formName']; $template = new stdClass(); $template->settings = $settings; $template->fields = $wrappers; if ( isset( $notifications ) ) { $template->notifications = $notifications; } $id = Forminator_Custom_Form_Admin::update( $id, $title, $status, $template ); if ( false === $id ) { return new WP_Error( 'form_save_error', esc_html__( 'There was a problem updating the form', 'forminator' ) ); } return $id; } /* * Returns all fields grouped by wrappers for specific form * * @since 1.5.0 * @access public * * @param int $id Form Id. * * @return array\|WP_Error / public static function get_form_wrappers( $id ) { // Initialize API. self::initialize(); if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $fields = $model->get_fields_grouped(); if ( is_array( $fields ) && ! empty( $fields ) ) { return $fields; } return new WP_Error( 'missing_fields', esc_html__( 'Form has no fields', 'forminator' ) ); } /* * Returns specific wrapper by form_id and wrapper_id * * @since 1.5.0 * @access public * * @param int $form_id Form Id. * @param int $id Wrapper Id. * * @return array\|WP_Error / public static function get_form_wrapper( $form_id, $id ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Wrapper ID is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $wrapper = $model->get_wrapper( $id ); if ( ! is_null( $wrapper ) ) { return $wrapper; } return new WP_Error( 'missing_field', esc_html__( 'Wrapper doesn\'t exist', 'forminator' ) ); } /* * Move form wrapper between position * * @since 1.5 * * @param int $form_id Form Id. * @param string $id Wrapper Id. * @param string $new_position negative value or greater than size of wrappers will move it to the end. * if value passed is not `int` it will type cast-ed into `int`. * Start from zero (0). * * @return array\|WP_Error / public static function move_form_wrapper( $form_id, $id, $new_position ) { $wrapper = self::get_form_wrapper( $form_id, $id ); if ( is_wp_error( $wrapper ) ) { return $wrapper; } $wrappers = self::get_form_wrappers( $form_id ); if ( is_wp_error( $wrappers ) ) { return $wrappers; } if ( ! is_int( $new_position ) ) { $new_position = (int) $new_position; } // negative value will move it to the end,. if ( $new_position < 0 \|\| ( $new_position > count( $wrappers ) ) ) { $new_position = ( count( $wrappers ) - 1 ); } $old_position = $wrapper['position']; // unchanged position. if ( $new_position === $old_position ) { return $wrapper; } // remove it, since its not needed for adding fields later. unset( $wrapper['position'] ); $form_model = self::get_module( $form_id ); if ( is_wp_error( $form_model ) ) { return $form_model; } unset( $wrappers[ $old_position ] ); array_splice( $wrappers, $new_position, 0, array( $wrapper ) ); // we need to empty fields cause we will send new data. $form_model->clear_fields(); foreach ( $wrappers as $row ) { foreach ( $row['fields'] as $f ) { // re-set `id`. if ( ! isset( $f['id'] ) \|\| $f['element_id'] !== $f['id'] ) { $f['id'] = $f['element_id']; } $field = new Forminator_Form_Field_Model(); $field->form_id = $row['wrapper_id']; $field->slug = $f['id']; unset( $f['id'] ); $field->parent_group = ! empty( $row['parent_group'] ) ? $row['parent_group'] : ''; $field->import( $f ); $form_model->add_field( $field ); } } $form_id = $form_model->save(); if ( is_wp_error( $form_id ) ) { return $form_id; } if ( false === $form_id ) { return new WP_Error( 'form_save_error', esc_html__( 'There was a problem moving form wrapper', 'forminator' ) ); } return self::get_form_wrapper( $form_id, $id ); } /* * Delete wrapper with all fields inside * * @since 1.5.0 * @access public * * @param int $form_id Form Id. * @param string $id Wrapper Id. * * @return bool\|WP_Error / public static function delete_form_wrapper( $form_id, $id ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Wrapper ID is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $wrapper = $model->get_wrapper( $id ); if ( ! is_null( $wrapper ) ) { $fields = $wrapper['fields']; if ( ! empty( $fields ) ) { foreach ( $fields as $field ) { self::delete_form_field( $form_id, $field['element_id'] ); } } return true; } return new WP_Error( 'missing_field', esc_html__( 'Wrapper doesn\'t exist', 'forminator' ) ); } /* * Returns all fields for specific form * * @since 1.5.0 * @access public * * @param int $id Form Id. * * @return array\|WP_Error / public static function get_form_fields( $id ) { // Initialize API. self::initialize(); if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $fields = $model->get_fields(); if ( is_array( $fields ) && ! empty( $fields ) ) { return $fields; } return new WP_Error( 'missing_fields', esc_html__( 'Form has no fields', 'forminator' ) ); } /* * Returns all fields from specific type * * @since 1.5.0 * @access public * * @param int $id Form Id. * @param string $type Field type. * * @return array\|WP_Error / public static function get_form_fields_by_type( $id, $type ) { // Initialize API. self::initialize(); if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $fields = $model->get_fields_by_type( $type ); if ( is_array( $fields ) && ! empty( $fields ) ) { return $fields; } return new WP_Error( 'missing_fields', esc_html__( 'No fields with that type', 'forminator' ) ); } /* * Returns specific field by form_id and field_id * * @since 1.5.0 * @access public * * @param int $form_id Form id. * @param string $id Wrapper Id. * @param bool $to_array whether to return as array or Forminator_Form_Field_Model. * * @return array\|Forminator_Form_Field_Model\|WP_Error / public static function get_form_field( $form_id, $id, $to_array = true ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Field ID is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $field = $model->get_field( $id, $to_array ); if ( ( is_array( $field ) \|\| is_object( $field ) ) && ! empty( $field ) ) { return $field; } return new WP_Error( 'missing_field', esc_html__( 'Field doesn\'t exist', 'forminator' ) ); } /* * Update form * * @since 1.5 * @access public * * @param int $form_id Form ID. * @param string $id Field ID. * @param array $data Array with field settings. * * @return string\|WP_Error id of updated field, or WP_Error on failure / public static function update_form_field( $form_id, $id, $data = array() ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Field ID is required!', 'forminator' ) ); } if ( empty( $data ) ) { return new WP_Error( 'missing_data', esc_html__( 'Field data is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } $field = $model->get_field( $id, false ); // Escape data. // Remove field type, we can't change field type here. if ( isset( $data['type'] ) ) { unset( $data['type'] ); // remove field type. } // Remove field cols, we can't change field cols here. if ( isset( $data['cols'] ) ) { unset( $data['cols'] ); // remove field type. } // Remove field wrapper, we can't change field wrapper here. if ( isset( $data['form_id'] ) ) { unset( $data['form_id'] ); // remove wrapper id. } // Remove field wrapper, we can't change field wrapper here. if ( isset( $data['wrapper_id'] ) ) { unset( $data['wrapper_id'] ); // remove wrapper id. } // Remove field ID or SLUG, we can't change field ID here. if ( isset( $data['element_id'] ) \|\| isset( $data['slug'] ) ) { if ( isset( $data['element_id'] ) ) { unset( $data['element_id'] ); } if ( isset( $data['slug'] ) ) { unset( $data['slug'] ); } } // Update field. $field->import( $data ); $result = $model->save(); if ( is_wp_error( $result ) ) { return $result; } return $id; } /* * Update form * * @since 1.5 * @access public * * @param int $form_id Form ID. * @param string $type Field Type. * @param array $data Array with field settings. * @param string\|null $wrapper if omitted it will create new wrapper,. * if specified it will check its existence on form, * when its non existence, it will create new wrapper automatically. * * @return string\|WP_Error id of new field, or WP_Error on failure / public static function add_form_field( $form_id, $type, $data = array(), $wrapper = null ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $type ) ) { return new WP_Error( 'missing_type', esc_html__( 'Field Type is required!', 'forminator' ) ); } if ( empty( $data ) ) { return new WP_Error( 'missing_data', esc_html__( 'Field data is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } // Generate field ID. $total_fields_type = self::get_form_fields_by_type( $form_id, $type ); if ( is_wp_error( $total_fields_type ) ) { $total_fields_type = array(); } // Count fields of type. $total_type = count( $total_fields_type ) + 1; // Create field ID. $field_id = $type . '-' . $total_type; // check wrapper existence. if ( ! empty( $wrapper ) ) { $wrapper = (string) $wrapper; $wrapper = self::get_form_wrapper( $form_id, $wrapper ); if ( is_wp_error( $wrapper ) ) { // nullify when not exist, so it will create new wrapper instead. $wrapper = null; } } // Handle wrapper. if ( ! $wrapper ) { $wrapper = uniqid( 'wrapper-' ); } // Create empty field. $field = new Forminator_Form_Field_Model(); // Update field settings. $data['id'] = $field_id; $data['element_id'] = $field_id; $data['type'] = $type; $data['form_id'] = $wrapper; // Bind settings to the fieldget_form_wrapper. $field->import( $data ); // Update field slug. $field->slug = $field_id; // Add the field to form. $model->add_field( $field ); // Update all fields cols in the wrapper. $model->update_fields_by_wrapper( $wrapper ); // Save the form. $result = $model->save(); if ( is_wp_error( $result ) ) { return $result; } return $field_id; } /* * Move Form Field position * * This method able to move field inside it's wrapper * and move field to another wrapper * * @since 1.5 * @access public * * @param int $form_id Form Id. * @param string $id Wrapper Id. * @param null $new_position negative value or greater than size MAX_CUSTOM_FORM_FIELDS_PER_WRAPPER will move it to the end. * if value passed is not `int` it will type cast-ed into `int`. * Start from Zero (0). * @param null\|string\|int $new_wrapper_id optional parameter which identify in which wrapper should the field moved. * If its omitted or `empty` (0,null,false,etc) or same with current wrapper, field will be moved inside its current wrapper. * If its specified, this function will check its existences on form. * When wrapper exist, it will move field to $position inside that $new_wrapper_id, * When wrapper not exist, it will return WP_Error * Negative value will make a new wrapper at bottom, and move field into this newly created wrapper. * * @return array\|WP_Error moved field on success, or WP_Error on failure / public static function move_form_field( $form_id, $id, $new_position, $new_wrapper_id = null ) { $form = self::get_module( $form_id ); if ( is_wp_error( $form ) ) { return $form; } $field = self::get_form_field( $form_id, $id ); if ( is_wp_error( $field ) ) { return $field; } $wrappers = self::get_form_wrappers( $form_id ); if ( is_wp_error( $wrappers ) ) { return $wrappers; } $old_wrapper = self::get_form_wrapper( $form_id, $field['wrapper_id'] ); if ( is_wp_error( $old_wrapper ) ) { return $old_wrapper; } $old_wrapper_id = $field['wrapper_id']; $is_cross_wrapper = false; // $new_wrapper_id specified ? if ( ! empty( $new_wrapper_id ) && ( $old_wrapper_id !== $new_wrapper_id ) ) { // definitely targeted to new wrapper, lets check existence. $is_cross_wrapper = true; // move to new wrapper ? if ( is_int( $new_wrapper_id ) && 0 > $new_wrapper_id ) { // create! $new_wrapper_id = uniqid( 'wrapper-' ); // dummy wrapper struct with empty fields. $new_wrapper = array( 'wrapper_id' => $new_wrapper_id, 'fields' => array(), 'position' => count( $wrappers ), // set at bottom. ); } else { // expected to be existing wrapper. $new_wrapper_id = (string) $new_wrapper_id; $new_wrapper = self::get_form_wrapper( $form_id, $new_wrapper_id ); // nonexistent wrapper. if ( is_wp_error( $new_wrapper ) ) { return $new_wrapper; } } } else { // omitted ? operation will be done inside its current wrapper. $new_wrapper_id = $old_wrapper_id; $new_wrapper = $old_wrapper; } if ( ! is_int( $new_position ) ) { $new_position = (int) $new_position; } // negative value will move it to the end,. if ( $new_position < 0 \|\| ( $new_position > ( self::MAX_CUSTOM_FORM_FIELDS_PER_WRAPPER - 1 ) ) ) { $new_position = ( self::MAX_CUSTOM_FORM_FIELDS_PER_WRAPPER - 1 ); } if ( $is_cross_wrapper && count( $new_wrapper['fields'] ) >= self::MAX_CUSTOM_FORM_FIELDS_PER_WRAPPER ) { return new WP_Error( 'target_wrapper_is_full', esc_html__( 'Target Wrapper is already full.', 'forminator' ), $new_wrapper ); } // validation flag. $found_in_wrapper = false; $old_position = 0; foreach ( $old_wrapper['fields'] as $key => $wrapper_field ) { if ( $field['element_id'] === $wrapper_field['element_id'] ) { $found_in_wrapper = true; $old_position = $key; break; } } // should not be happened ever! unless storage directly modified. // but just in case... to avoid further fields corruption. if ( ! $found_in_wrapper ) { return new WP_Error( 'invalid_field', esc_html__( 'Invalid field', 'forminator' ), $old_wrapper ); } // unchanged position. if ( $new_position === $old_position && $old_wrapper_id === $new_wrapper_id ) { return $field; } // inside its current wrapper. if ( ! $is_cross_wrapper ) { // remove field from old position. unset( $old_wrapper['fields'][ $old_position ] ); $old_wrapper_fields = $old_wrapper['fields']; // move! array_splice( $old_wrapper_fields, $new_position, 0, array( $field ) ); $old_wrapper['fields'] = $old_wrapper_fields; // replace it! $wrappers[ $old_wrapper['position'] ] = $old_wrapper; } else { // remove field from old position. unset( $old_wrapper['fields'][ $old_position ] ); // replace old wrapper. $wrappers[ $old_wrapper['position'] ] = $old_wrapper; $new_wrapper_fields = $new_wrapper['fields']; // Add it. array_splice( $new_wrapper_fields, $new_position, 0, array( $field ) ); $new_wrapper['fields'] = $new_wrapper_fields; // replace it! $wrappers[ $new_wrapper['position'] ] = $new_wrapper; } // reset fields. $form->clear_fields(); foreach ( $wrappers as $row ) { foreach ( $row['fields'] as $f ) { // re-set `id`. if ( ! isset( $f['id'] ) \|\| $f['element_id'] !== $f['id'] ) { $f['id'] = $f['element_id']; } // remove previous wrapper_id if exist. unset( $f['wrapper_id'] ); unset( $f['form_id'] ); $field = new Forminator_Form_Field_Model(); $field->form_id = $row['wrapper_id']; $field->slug = $f['id']; unset( $f['id'] ); $field->parent_group = ! empty( $row['parent_group'] ) ? $row['parent_group'] : ''; $field->import( $f ); $form->add_field( $field ); } } // reset cols. $form->update_fields_by_wrapper( $old_wrapper_id ); $form->update_fields_by_wrapper( $new_wrapper_id ); $form_id = $form->save(); if ( is_wp_error( $form_id ) ) { return $form_id; } return self::get_form_field( $form_id, $id ); } /* * Delete multiple fields from form * * @since 1.5.0 * @access public * * @param int $form_id Form Id. * @param array $field_ids Field Ids. * * @return bool\|WP_Error / public static function delete_form_fields( $form_id, $field_ids ) { // Initialize API. self::initialize(); if ( is_array( $field_ids ) && ! empty( $field_ids ) ) { foreach ( $field_ids as $id ) { self::delete_form_field( $form_id, $id ); } return true; } else { return new WP_Error( 'invalid', esc_html__( 'Invalid or empty array with IDs', 'forminator' ) ); } } /* * Delete field from form * * @since 1.5.0 * @access public * * @param int $form_id Form Id. * @param int $id Field Id. * * @return string\|WP_Error / public static function delete_form_field( $form_id, $id ) { // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); $wrapper = $model->delete_field( $id ); if ( false === $wrapper ) { return new WP_Error( 'missing_field', esc_html__( 'Field doesn\'t exist', 'forminator' ) ); } $model->update_fields_by_wrapper( $wrapper ); // Save the form. $id = $model->save(); if ( is_wp_error( $id ) ) { return $id; } if ( false === $id ) { return new WP_Error( 'form_save_error', esc_html__( 'There was a problem saving the form', 'forminator' ) ); } return $id; } /* * Update form setting * * @since 1.5 * @access public * * @param int $form_id Form ID. * @param string $setting Setting name. * @param mixed $value Setting value. * * @return int\|WP_Error id of form, or WP_Error on failure / public static function update_form_setting( $form_id, $setting, $value ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $setting ) ) { return new WP_Error( 'missing_name', esc_html__( 'Setting name is required!', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } // Set the setting. $model->settings[ $setting ] = sanitize_textarea_field( $value ); // Save data. $id = $model->save(); if ( is_wp_error( $id ) ) { return $id; } return $id; } /* * Update form settings * * @since 1.5 * @access public * * @param int $form_id Form ID. * @param array $settings array of settings and values. * * @return int\|WP_Error id of form, or WP_Error on failure / public static function update_form_settings( $form_id, $settings ) { // Initialize API. self::initialize(); if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( empty( $settings ) ) { return new WP_Error( 'missing_settings', esc_html__( 'No settings', 'forminator' ) ); } // Load form model. $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return new WP_Error( 'missing_object', esc_html__( 'Form model doesn\'t exist', 'forminator' ) ); } // Load all settings. $form_settings = $model->settings; foreach ( $settings as $name => $value ) { // Set the setting. $form_settings[ $name ] = sanitize_textarea_field( $value ); } // Save data. $id = $model->save(); if ( is_wp_error( $id ) ) { return $id; } return $id; } /* * Returns all poll objects. * * @since 1.2.0 * @since 1.5.4 add pagination arguments * @access public * * @param array\|null $poll_ids Poll Ids. * @param int $page Page number. * @param int $per_page Limit per page. * @param string $status (draft,publish,any). * * @return Forminator_Poll_Model[]\|WP_Error / public static function get_polls( $poll_ids = null, $page = 1, $per_page = 10, $status = '' ) { // Initialize API. self::initialize(); $temp = array(); if ( is_null( $poll_ids ) ) { $temp = Forminator_Poll_Model::model()->get_all_paged( $page, $per_page, $status ); if ( isset( $temp['models'] ) && is_array( $temp['models'] ) ) { return $temp['models']; } return array(); } else { if ( ! is_array( $poll_ids ) ) { return new WP_Error( 'invalid_arg', esc_html__( 'Invalid Arguments', 'forminator' ) ); } foreach ( $poll_ids as $poll_id ) { $model = self::get_module( $poll_id ); if ( ! empty( $status ) && ! $model instanceof WP_Error && $status === $model->status ) { $temp[] = $model; } } } return $temp; } /* * Returns poll object by given ID. * * @since 1.2 * @access public * * @param int $poll_id ID of the poll. * * @return Forminator_Poll_Model\|WP_Error Forminator_Poll_Model on success, or WP_Error otherwise / public static function get_poll( $poll_id ) { return self::get_module( $poll_id ); } /* * Delete poll with given ID * * @since 1.2 * @access public * * @param int $poll_id ID of the poll. / public static function delete_poll( $poll_id ) { self::delete_module( $poll_id ); } /* * Delete polls with given IDs * * @since 1.2 * @access public * * @param int $poll_ids Array with IDs. / public static function delete_polls( $poll_ids ) { self::delete_modules( $poll_ids ); } /* * Add a poll * * @since 1.2 * @access public * * @param string $name Poll name. * @param array $fields Array with poll fields. * @param array $settings Array with settings. * @param string $status (draft\|publish), default publish. * * @return int\|WP_Error ID of new Poll on success, or WP_Error otherwise / public static function add_poll( $name, $fields = array(), $settings = array(), $status = Forminator_Poll_Model::STATUS_PUBLISH ) { // Initialize API. self::initialize( true ); if ( empty( $name ) ) { return new WP_Error( 'missing_name', esc_html__( 'Poll name is required!', 'forminator' ) ); } $template = new stdClass(); $template->fields = $fields; $template->settings = $settings; $id = Forminator_Poll_Admin::create( $name, $status, $template ); if ( false === $id ) { return new WP_Error( 'form_save_error', esc_html__( 'There was a problem saving the poll', 'forminator' ) ); } return $id; } /* * Update a poll * * @since 1.2 * @access public * * @param int $id Poll ID. * @param array $fields Array with poll fields. * @param array $settings Array with settings. * @param string $status status of form `draft`\| `publish` \| `` for keep as it is. * * @return int\|WP_Error ID of updated Poll on success, or WP_Error otherwise / public static function update_poll( $id, $fields = array(), $settings = array(), $status = '' ) { // Initialize API. self::initialize( true ); if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Poll ID is required!', 'forminator' ) ); } // Set the post data. $title = $settings['formName']; $template = new stdClass(); $template->settings = $settings; $template->answers = $fields; $id = Forminator_Poll_Admin::update( $id, $title, $status, $template ); if ( false === $id ) { return new WP_Error( 'form_save_error', esc_html__( 'There was a problem saving the poll', 'forminator' ) ); } return $id; } /* * Returns all quiz objects. * * @since 1.2.0 * @since 1.5.4 add pagination arguments * @since 1.6.2 add $status on args * @access public * * @param array\|null $quiz_ids Quiz Ids. * @param int $page Page number. * @param int $per_page Limit per page. * @param string $status Status. * * @return Forminator_Quiz_Model[]\|WP_Error / public static function get_quizzes( $quiz_ids = null, $page = 1, $per_page = 10, $status = '' ) { // Initialize API. self::initialize(); $temp = array(); if ( is_null( $quiz_ids ) ) { $temp = Forminator_Quiz_Model::model()->get_all_paged( $page, $per_page, $status ); if ( isset( $temp['models'] ) && is_array( $temp['models'] ) ) { return $temp['models']; } return array(); } else { if ( ! is_array( $quiz_ids ) ) { return new WP_Error( 'invalid_arg', esc_html__( 'Invalid Arguments', 'forminator' ) ); } foreach ( $quiz_ids as $quiz_id ) { $model = self::get_module( $quiz_id ); if ( ! empty( $status ) && ! $model instanceof WP_Error && $status === $model->status ) { $temp[] = $model; } } } return $temp; } /* * Returns quiz object by given ID. * * @since 1.2 * @access public * * @param int $quiz_id ID of the Quiz. * * @return Forminator_Quiz_Model\|WP_Error, Quiz Object on success, or WP_Error otherwise / public static function get_quiz( $quiz_id ) { return self::get_module( $quiz_id ); } /* * Delete quiz with given ID * * @since 1.2 * @access public * * @param int $quiz_id ID of the quiz. / public static function delete_quiz( $quiz_id ) { self::delete_module( $quiz_id ); } /* * Delete forms with given IDs * * @since 1.2 * @access public * * @param array $quiz_ids Array with IDs. / public static function delete_quizzes( $quiz_ids ) { self::delete_modules( $quiz_ids ); } /* * Add quiz * * @since 1.2 * @since 1.6.2 add new arg : $status * @access public * * @param string $name Quiz name. * @param string $type Quiz type (nowrong\|knowledge). * @param array $questions Array with quiz questions. * @param array $results Array with quiz results. * @param array $settings Array with settings. * @param string $status Status of newly created quiz : draft/publish, default publish. * @param bool $has_leads Is this quiz has Leads or not, default false. * * @return int\|WP_Error ID of new Quiz, or WP_Error otherwise / public static function add_quiz( $name, $type, $questions = array(), $results = array(), $settings = array(), $status = null, $has_leads = false ) { // Initialize API. self::initialize( true ); if ( empty( $name ) ) { return new WP_Error( 'missing_name', esc_html__( 'Quiz name is required!', 'forminator' ) ); } if ( empty( $type ) ) { return new WP_Error( 'missing_type', esc_html__( 'Quiz type is required!', 'forminator' ) ); } $template = new stdClass(); $template->settings = $settings; $template->questions = $questions; $template->results = $results; $template->quiz_type = $type; $template->has_leads = $has_leads; if ( ! $status ) { $status = Forminator_Quiz_Model::STATUS_PUBLISH; } $id = Forminator_Quiz_Admin::create( $name, $status, $template ); if ( false === $id ) { return new WP_Error( 'quiz_save_error', esc_html__( 'There was a problem saving the quiz', 'forminator' ) ); } return $id; } /* * Update quiz * * @since 1.2 * @since 1.6.2 Add $status arg * @access public * * @param int $id Quiz ID. * @param array $questions Array with quiz questions. * @param array $results Array with quiz results. * @param array $settings Array with settings. * @param string $status Update status of quiz, draft/publish. * * @return int\|WP_Error ID of updated Quiz, or WP_Error otherwise / public static function update_quiz( $id, $questions = array(), $results = array(), $settings = array(), $status = null ) { // Initialize API. self::initialize( true ); if ( empty( $id ) ) { return new WP_Error( 'missing_id', esc_html__( 'Quiz ID is required!', 'forminator' ) ); } // Set the post data. $title = $settings['formName']; $template = new stdClass(); $template->settings = $settings; // Bind questions. if ( ! empty( $questions ) ) { $template->questions = $questions; } // Bind results. if ( ! empty( $results ) ) { $template->results = $results; } $id = Forminator_Quiz_Admin::update( $id, $title, $status, $template ); if ( false === $id ) { return new WP_Error( 'quiz_save_error', esc_html__( 'There was a problem saving the quiz', 'forminator' ) ); } return $id; } // ENTRIES. /* * Get entries objects * * @since 1.2 * * @param int $form_id Form ID. * @param int $per_page Limit per page. * @param int $current_page Current page. * * @since 1.38 Added optional param per_page. * @since 1.38 Added optional param current_page. * * @return Forminator_Form_Entry_Model[]\|WP_Error / public static function get_entries( $form_id, $per_page = 0, $current_page = 1 ) { // Initialize API. self::initialize(); // Check if Form ID is set. if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } if ( $per_page ) { $current_page = intval( $current_page ); $current_page = $current_page > 0 ? $current_page : 1; $offset = ( $current_page - 1 ) $per_page; $args = array( 'form_id' => $form_id, 'is_spam' => 0, 'per_page' => $per_page, 'offset' => $offset, ); return Forminator_Form_Entry_Model::query_entries( $args ); } return Forminator_Form_Entry_Model::get_all_entries( $form_id ); } /** * Get entry object * * @since 1.2 * * @param int $form_id Form Id. * @param int $entry_id Entry Id. * * @return Forminator_Form_Entry_Model\|WP_Error / public static function get_entry( $form_id, $entry_id ) { // Initialize API. self::initialize(); // Check if Form ID is set. if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Check if Entry ID is set. if ( empty( $entry_id ) ) { return new WP_Error( 'missing_entry_id', esc_html__( 'Entry ID is required!', 'forminator' ) ); } return new Forminator_Form_Entry_Model( $entry_id ); } /* * Delete entry * * @uses Forminator_Form_Entry_Model::delete_by_entry * * @since 1.2 * * @param int $form_id Form Id. * @param int $entry_id Entry Id. * * @return bool\|WP_Error / public static function delete_entry( $form_id, $entry_id ) { // Initialize API. self::initialize(); // Check if Form ID is set. if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Check if Entry ID is set. if ( empty( $entry_id ) ) { return new WP_Error( 'missing_entry_id', esc_html__( 'Entry ID is required!', 'forminator' ) ); } // Delete entry. Forminator_Form_Entry_Model::delete_by_entry( $entry_id ); return true; } /* * Delete multiple entries * * @uses Forminator_Form_Entry_Model::delete_by_entrys * * @since 1.2 * * @param int $form_id Form Id. * @param mixed $entries_ids Entry Ids. * * @return bool\|WP_Error / public static function delete_entries( $form_id, $entries_ids ) { // Initialize API. self::initialize(); // Check if Form ID is set. if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } // Check if Entry ID is set. if ( empty( $entries_ids ) ) { return new WP_Error( 'missing_entry_id', esc_html__( 'Entry IDs are required!', 'forminator' ) ); } // Check if entries ids are array and convert to string. if ( is_array( $entries_ids ) ) { $entries_ids = implode( ',', $entries_ids ); } // Delete entries. Forminator_Form_Entry_Model::delete_by_entrys( $form_id, $entries_ids ); return true; } /* * Count entries * * @uses Forminator_Form_Entry_Model::count_entries * * @since 1.2 * * @param int $form_id Form Id. * * @return int\|WP_Error / public static function count_entries( $form_id ) { // Initialize API. self::initialize(); // Check if Form ID is set. if ( empty( $form_id ) ) { return new WP_Error( 'missing_form_id', esc_html__( 'Form ID is required!', 'forminator' ) ); } return Forminator_Form_Entry_Model::count_entries( $form_id ); } /* * Get Form entries * * @access public * @since 1.2 * * @param int $form_id Form ID. * * @return Forminator_Form_Entry_Model[]\|WP_Error / public static function get_form_entries( $form_id ) { return self::get_entries( $form_id ); } /* * Get Form entry by Form ID and Entry ID * * @access public * @since 1.2 * * @param int $form_id Form ID. * @param int $entry_id Entry ID. * * @return Forminator_Form_Entry_Model\|WP_Error / public static function get_form_entry( $form_id, $entry_id ) { return self::get_entry( $form_id, $entry_id ); } /* * Delete Form entry * * @access public * @since 1.2 * * @param int $form_id Form Id. * @param int $entry_id Entry Id. * * @return bool\|WP_Error / public static function delete_form_entry( $form_id, $entry_id ) { return self::delete_entry( $form_id, $entry_id ); } /* * Delete Form entries * * @access public * @since 1.2 * * @param int $form_id Form ID. * @param array\|string $entry_ids entry IDs in an array, or string glued with `,`(comma). * * @return bool\|WP_Error / public static function delete_form_entries( $form_id, $entry_ids ) { return self::delete_entries( $form_id, $entry_ids ); } /* * Count form entries * * @access public * @since 1.2 * * @param int $form_id Form Id. * * @return int\|WP_Error / public static function count_form_entries( $form_id ) { return self::count_entries( $form_id ); } /* * Get Poll entries * * @access public * @since 1.2 * * @param int $poll_id Poll ID. * * @return Forminator_Form_Entry_Model[]\|WP_Error / public static function get_poll_entries( $poll_id ) { return self::get_entries( $poll_id ); } /* * Get Poll entry by ID * * @access public * @since 1.2 * * @param int $poll_id Poll ID. * @param int $entry_id Entry ID. * * @return Forminator_Form_Entry_Model\|WP_Error / public static function get_poll_entry( $poll_id, $entry_id ) { return self::get_entry( $poll_id, $entry_id ); } /* * Delete Poll entry * * @access public * @since 1.2 * * @param int $poll_id Poll Id. * @param int $entry_id Entry Id. * * @return bool\|WP_Error / public static function delete_poll_entry( $poll_id, $entry_id ) { return self::delete_entry( $poll_id, $entry_id ); } /* * Delete Poll entries * * @access public * @since 1.2 * * @param int $poll_id Poll Id. * @param array\|string $entry_ids entry IDs in an array, or string separated with `,`(comma). * * @return bool\|WP_Error / public static function delete_poll_entries( $poll_id, $entry_ids ) { return self::delete_entries( $poll_id, $entry_ids ); } /* * Count poll entries * * @access public * @since 1.2 * * @param int $poll_id Poll Id. * * @return int\|WP_Error / public static function count_poll_entries( $poll_id ) { return self::count_entries( $poll_id ); } /* * Get Quiz entries * * @access public * @since 1.2 * * @param int $quiz_id Quiz ID. * * @return Forminator_Form_Entry_Model[]\|WP_Error / public static function get_quiz_entries( $quiz_id ) { return self::get_entries( $quiz_id ); } /* * Get Quiz entry by ID * * @access public * @since 1.2 * * @param int $quiz_id Quiz ID. * @param int $entry_id Entry ID. * * @return Forminator_Form_Entry_Model\|WP_Error / public static function get_quiz_entry( $quiz_id, $entry_id ) { return self::get_entry( $quiz_id, $entry_id ); } /* * Delete Quiz entry * * @access public * @since 1.2 * * @param int $quiz_id Quiz Id. * @param int $entry_id Entry Id. * * @return bool\|WP_Error / public static function delete_quiz_entry( $quiz_id, $entry_id ) { return self::delete_entry( $quiz_id, $entry_id ); } /* * Delete Quiz entries * * @access public * @since 1.2 * * @param int $quiz_id Quiz id. * @param array $entry_ids Entry Ids. * * @return bool\|WP_Error / public static function delete_quiz_entries( $quiz_id, $entry_ids ) { return self::delete_entries( $quiz_id, $entry_ids ); } /* * Count quiz entries * * @access public * @since 1.2 * * @param int $quiz_id Quiz id. * * @return int\|WP_Error / public static function count_quiz_entries( $quiz_id ) { return self::count_entries( $quiz_id ); } /* * Add Form Entry * * @access public * @since 1.5 * * @param int $form_id Form id. * @param array $entry_meta ['name' => 'META_NAME', 'value' => 'META_VALUE']. * * @return int\|WP_Error / public static function add_form_entry( $form_id, $entry_meta ) { // validating form module. $model = self::get_module( $form_id ); if ( is_wp_error( $model ) ) { return $model; } return self::add_entry( $form_id, 'custom-forms', $entry_meta ); } /* * Add Multiple Form Entry * * @access public * @since 1.5 * * @param int $form_id Form Id. * @param array $entry_metas nested array entry meta. * * @see Forminator_API::add_form_entry() * * @return array\|WP_Error array of entry id or WP_Error / public static function add_form_entries( $form_id, $entry_metas ) { // validating form module. $model = self::get_module( $form_id ); if ( is_wp_error( $model ) ) { return $model; } return self::add_entries( $form_id, 'custom-forms', $entry_metas ); } /* * Update form entry * * @access public * @since 1.5 * * @param int $form_id Form id. * @param int $entry_id Entry Id. * @param array $entry_meta ['name' => 'META_NAME', 'value' => 'META_VALUE']. * * @return bool\|WP_Error / public static function update_form_entry( $form_id, $entry_id, $entry_meta ) { // validating form module. $model = self::get_module( $form_id ); if ( is_wp_error( $model ) ) { return $model; } return self::update_entry_meta( $form_id, $entry_id, $entry_meta ); } /* * Add Poll Entry * * @access public * @since 1.5 * * @param int $poll_id Poll Id. * @param array $entry_meta ['name' => 'META_NAME', 'value' => 'META_VALUE']. * * @return int\|WP_Error / public static function add_poll_entry( $poll_id, $entry_meta ) { // validating poll module. $model = self::get_module( $poll_id ); if ( is_wp_error( $model ) ) { return $model; } return self::add_entry( $poll_id, 'poll', $entry_meta ); } /* * Add Multiple Poll Entry * * @access public * @since 1.5 * * @param int $poll_id Poll Id. * @param array $entry_metas nested array entry meta. * * @see Forminator_API::add_form_entry() * * @return array\|WP_Error array of entry id or WP_Error / public static function add_poll_entries( $poll_id, $entry_metas ) { // validating poll module. $model = self::get_module( $poll_id ); if ( is_wp_error( $model ) ) { return $model; } return self::add_entries( $poll_id, 'poll', $entry_metas ); } /* * Update poll entry * * @access public * @since 1.5 * * @param int $poll_id Poll Id. * @param int $entry_id Entry id. * @param array $entry_meta ['name' => 'META_NAME', 'value' => 'META_VALUE']. * * @return bool\|WP_Error / public static function update_poll_entry( $poll_id, $entry_id, $entry_meta ) { // validating poll module. $model = self::get_module( $poll_id ); if ( is_wp_error( $model ) ) { return $model; } return self::update_entry_meta( $poll_id, $entry_id, $entry_meta ); } /* * Add Quiz Entry * * @access public * @since 1.5 * * @param int $quiz_id Quiz Id. * @param array $entry_meta ['name' => 'META_NAME', 'value' => 'META_VALUE']. * * @return int\|WP_Error / public static function add_quiz_entry( $quiz_id, $entry_meta ) { // validating quiz module. $model = self::get_module( $quiz_id ); if ( is_wp_error( $model ) ) { return $model; } return self::add_entry( $quiz_id, 'quizzes', $entry_meta ); } /* * Add Multiple Quiz Entry * * @access public * @since 1.5 * * @param int $quiz_id Quiz Id. * @param array $entry_metas nested array entry meta. * * @see Forminator_API::add_form_entry() * * @return array\|WP_Error array of entry id or WP_Error / public static function add_quiz_entries( $quiz_id, $entry_metas ) { // validating quiz module. $model = self::get_module( $quiz_id ); if ( is_wp_error( $model ) ) { return $model; } return self::add_entries( $quiz_id, 'quizzes', $entry_metas ); } /* * Update quiz entry * * @access public * @since 1.5 * * @param int $quiz_id Quiz Id. * @param int $entry_id Entry Id. * @param array $entry_meta ['name' => 'META_NAME', 'value' => 'META_VALUE']. * * @return bool\|WP_Error / public static function update_quiz_entry( $quiz_id, $entry_id, $entry_meta ) { // validating quiz module. $model = self::get_module( $quiz_id ); if ( is_wp_error( $model ) ) { return $model; } return self::update_entry_meta( $quiz_id, $entry_id, $entry_meta ); } /* * Add Entry * * This function assumed module_id already validated * * @access public * @since 1.5 * * @param int $module_id Module Id. * @param string $entry_type available : `custom-forms`, `poll`, `quizzes`. * @param array $entry_meta Entry meta data. * * @return int\|WP_Error / public static function add_entry( $module_id, $entry_type, $entry_meta ) { // Initialize API. self::initialize(); $entry_types = array( 'custom-forms', 'poll', 'quizzes', ); if ( ! in_array( $entry_type, $entry_types, true ) ) { return new WP_Error( 'invalid_entry_type', esc_html__( 'Invalid entry type.', 'forminator' ) ); } $entry = new Forminator_Form_Entry_Model(); $entry->entry_type = $entry_type; $entry->form_id = $module_id; $entry_saved = $entry->save(); if ( ! $entry_saved \|\| empty( $entry->entry_id ) ) { return new WP_Error( 'save_entry_error', esc_html__( 'Failed to save entry.', 'forminator' ) ); } $meta_saved = $entry->set_fields( $entry_meta ); if ( ! $meta_saved ) { return new WP_Error( 'save_entry_meta_error', esc_html__( 'Failed to save entry meta.', 'forminator' ) ); } return $entry->entry_id; } /* * Add Multiple Entries * * @access public * @since 1.5 * * @param int $module_id Module Id. * @param string $entry_type Entry type. * @param array $entry_metas Nested entry meta. * * @see Forminator_API::add_entry() * * @return array\|WP_Error / public static function add_entries( $module_id, $entry_type, $entry_metas ) { $entry_ids = array(); foreach ( $entry_metas as $entry_meta ) { $entry_id = self::add_entry( $module_id, $entry_type, $entry_meta ); if ( is_wp_error( $entry_id ) ) { // return wp_error with data = entry_ids that already added. $entry_id->add_data( $entry_ids ); return $entry_id; } $entry_ids[] = $entry_id; } return $entry_ids; } /* * Update entry meta * * This function will automatically add new meta(s) if it was previously not exists * and also update meta that its value has changed * * @access public * @since 1.5 * * @param int $module_id Module Id. * @param int $entry_id Entry Id. * @param array $entry_meta Entry Meta. * * @return bool\|Forminator_Form_Entry_Model\|WP_Error */ public static function update_entry_meta( $module_id, $entry_id, $entry_meta ) { // Initialize API. self::initialize(); // basic entry validation. $entry = self::get_entry( $module_id, $entry_id ); if ( is_wp_error( $entry ) ) { return $entry; } if ( empty( $entry->entry_id ) ) { return new WP_Error( 'entry_not_found', esc_html__( 'Entry not found.', 'forminator' ) ); } if ( (int) $module_id !== (int) $entry->form_id ) { return new WP_Error( 'entry_not_valid', esc_html__( 'Entry is not valid for module.', 'forminator' ) ); } $current_meta_data = $entry->meta_data; $update_entry_meta = array(); $new_entry_meta = array(); foreach ( $entry_meta as $item ) { // only process array that has name and value. if ( ! isset( $item['name'] ) \|\| ! isset( $item['value'] ) ) { continue; } $key = $item['name']; $value = $item['value']; // exists on current ? if ( in_array( $key, array_keys( $current_meta_data ), true ) ) { // check if value changed. $current_meta_data_value = $current_meta_data[ $key ]['value']; if ( $current_meta_data_value !== $value ) { $update_entry_meta[] = array( 'id' => $current_meta_data[ $key ]['id'], 'name' => $key, 'value' => $value, ); } } else { // new meta. $new_entry_meta[] = $item; } } // adding new meta. if ( ! empty( $new_entry_meta ) ) { $new_meta_saved = $entry->set_fields( $new_entry_meta ); if ( ! $new_meta_saved ) { return new WP_Error( 'save_new_entry_meta_error', esc_html__( 'Failed to save new entry meta.', 'forminator' ), $new_entry_meta ); } } // updating existing meta. if ( ! empty( $update_entry_meta ) ) { $date_updated = date_i18n( 'Y-m-d H:i:s' ); foreach ( $update_entry_meta as $item ) { $entry->update_meta( $item['id'], $item['name'], $item['value'], $date_updated ); } } return true; } }	54.26 KB	2026-01-12 18:46
📄 class-autofill-loader.php <?php /** * Forminator Autofill Loader * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Autofill_Loader * * @since 1.0.5 / class Forminator_Autofill_Loader { /* * Instance * * @since 1.0.5 * @var self\|null / private static $_instance = null; /* * SEMAPHORE of inited_providers, so it wont inited more than once per app load * * @since 1.0.5 * @var array / private static $inited_providers = array(); /* * In case we want disable addons that have bad pattern or behavior or still in pipeline * * @since 1.0.5 * @example {['BANNED_PROVIDER_SLUG','BANNED_PROVIDER_SLUG_2']} * * @var array / private $_banned_providers = array( 'wp_post', ); /* * Autofill Providers Container * * @since 1.0.5 * @example array(`slug` => INSTANCE); * @var Forminator_Autofill_Provider_Abstract[] / private $autofill_providers = array(); /* * Autofill Providers Container * * @since 1.0.5 * @example array(`slug` => PROVIDER_NAME); * @var array / private $autofill_providers_groups = array(); /* * Autofill Providers Flatten Container * * @since 1.0.5 * @example array( * `slug`.`attribute` => 'translated string' * ) * @var array / private $autofill_providers_names = array(); /* * Forminator_Autofill_Loader instance * * @return Forminator_Autofill_Loader\|null / public static function get_instance() { if ( is_null( self::$_instance ) ) { self::$_instance = new self(); } return self::$_instance; } /* * Register Autofill Provider Class * * @since 1.0.5 * * @param string $class_name Class name. * * @return bool / final public function register( $class_name ) { if ( ! class_exists( $class_name ) ) { return false; } if ( ! is_callable( array( $class_name, 'get_instance' ) ) ) { return false; } $autofill_instance = call_user_func( array( $class_name, 'get_instance' ) ); if ( ! $autofill_instance instanceof Forminator_Autofill_Provider_Abstract ) { return false; } if ( in_array( $autofill_instance->get_slug(), $this->_banned_providers, true ) ) { // debug purpose only. // error_log( 'Autofill Provider for ' . $autofill_instance->get_slug() . ' is banned' );. return false; } $this->autofill_providers[ $autofill_instance->get_slug() ] = $autofill_instance; $this->autofill_providers_groups[ $autofill_instance->get_slug() ] = $autofill_instance->get_name(); return true; } /* * Build Provider names * * @since 1.0.5 * * @example { * 'simple'.'simple_text' => 'Simple Text', * 'PROVIDER_SLUG'.'ATTRIBUTE_SLUG' => 'ATTRIBUTE NICE NAME', * } / private function try_build_autofill_providers_names() { $this->autofill_providers_names = array(); foreach ( $this->autofill_providers as $autofill_instance ) { /* * Forminator_Autofill_Provider_Abstract * * @var Forminator_Autofill_Provider_Abstract $autofill_instance / $attributes_map = $autofill_instance->get_attributes_map(); if ( empty( $attributes_map ) ) { continue; } foreach ( $attributes_map as $attribute => $mapper ) { $name = $autofill_instance->get_slug() . '.' . $attribute; // Dedupe. if ( isset( $this->autofill_providers_names[ $name ] ) ) { continue; } $this->autofill_providers_names[ $name ] = $mapper['name']; } } } /* * Get Providers names, build if its empty * * @since 1.0.5 * @return array / public function get_autofill_providers_names() { if ( empty( $this->autofill_providers_names ) ) { $this->try_build_autofill_providers_names(); } return $this->autofill_providers_names; } /* * Get autofill providers as grouped array * * @since 1.0.5 * * @example * { * `SLUG` => [ * 'name' => `NAME`, * 'attributes' => [ * [`SLUG.ATTRIBUTE` => [name : TRANSLATE_ATTRIBUTE]`, * [`SLUG.ATTRIBUTE` => [name : TRANSLATE_ATTRIBUTE]`, * ] * ] * ...} * * @param array $slug_attributes Slug attributes. * * @return array / public function get_grouped_autofill_providers( $slug_attributes ) { $this->get_autofill_providers_names(); $grouped_autofill_providers = array(); foreach ( $slug_attributes as $slug_attribute ) { $slug_attribute_parts = explode( '.', $slug_attribute ); if ( ! isset( $slug_attribute_parts[0] ) \|\| empty( $slug_attribute_parts[0] ) ) { continue; } $slug = $slug_attribute_parts[0]; if ( ! isset( $this->autofill_providers[ $slug ] ) ) { continue; } if ( ! is_callable( array( $this->autofill_providers[ $slug ], 'get_short_name' ) ) ) { continue; } $provider_instance = $this->autofill_providers[ $slug ]; $provider_short_name = $provider_instance->get_short_name(); $new_attribute = false; if ( isset( $this->autofill_providers_names[ $slug_attribute ] ) && ! empty( $this->autofill_providers_names[ $slug_attribute ] ) ) { $new_attribute = array( 'name' => $this->autofill_providers_names[ $slug_attribute ], ); } if ( ! $new_attribute ) { continue; } if ( ! in_array( $slug, array_keys( $grouped_autofill_providers ), true ) ) { $grouped_autofill_providers[ $slug ] = array( 'name' => $this->autofill_providers_groups[ $slug ], 'attributes' => array(), ); } $grouped_autofill_providers[ $slug ] ['attributes'][ $slug_attribute ] = $new_attribute; } return $grouped_autofill_providers; } /* * Get the provider by its slug * * @since 1.0.5 * * @param string $provider_slug Slug. * * @return Forminator_Autofill_Provider_Abstract\|null / public function get_autofill_provider( $provider_slug ) { if ( isset( $this->autofill_providers[ $provider_slug ] ) ) { return $this->autofill_providers[ $provider_slug ]; } return null; } /* * Call `init` function of provider, if its not `inited` yet * * @since 1.0.5 * * @param string $provider_slug Slug. * * @return Forminator_Autofill_Provider_Abstract\|null / final public function init_provider( $provider_slug ) { $provider = $this->get_autofill_provider( $provider_slug ); if ( ! $provider ) { return null; } if ( in_array( $provider->get_slug(), $this->_banned_providers, true ) ) { // debug purpose only. // error_log( 'Autofill Provider for ' . $autofill_instance->get_slug() . ' is banned' );. return null; } if ( ! in_array( $provider->get_slug(), self::$inited_providers, true ) ) { $provider->init(); self::$inited_providers[] = $provider->get_slug(); return $provider; } return $provider; } /* * Cleanup providers that being inited * * @since 1.6.2 * @internal */ public function cleanup_initied_providers() { self::$inited_providers = array(); } }	6.81 KB	2026-01-12 18:46
📄 class-captcha-verification.php <?php /** * Forminator Captcha Verification * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Captcha_Verification * * Handle Captcha verification * * @since 1.15.5 / class Forminator_Captcha_Verification { /* * Secred Key * * @var string * @since 1.5.3 / private $secret_key = ''; /* * Provider * * @var string * @since 1.15.5 / private $provider = ''; /* * Forminator_Captcha_Verification constructor. * * @since 1.5.3 * * @param string $secret_key Secret Key. * @param string $provider Provider - Added since 1.15.5. / public function __construct( $secret_key, $provider ) { $this->secret_key = $secret_key; $this->provider = $provider; } /* * Verify captcha * * @since 1.5.3 * * @param string $user_response User response. * @param null\|string $remote_ip Remote IP. * @param string $score Score. * * @return bool\|WP_Error (true on success, WP_Error on fail) / public function verify( $user_response, $remote_ip = null, $score = '' ) { $provider = $this->provider; $url = $this->get_verify_endpoint(); $args = array( 'method' => 'POST', 'body' => array( 'secret' => $this->secret_key, 'response' => $user_response, 'remoteip' => $remote_ip ? $remote_ip : Forminator_Geo::get_user_ip(), ), ); $res = wp_remote_request( $url, $args ); if ( is_wp_error( $res ) ) { forminator_maybe_log( __METHOD__, $res ); return $res; } $body = wp_remote_retrieve_body( $res ); if ( empty( $body ) ) { $error = new WP_Error( $provider . '_empty_response', 'Empty response', array( $res ) ); forminator_maybe_log( __METHOD__, $error ); return $error; } $json = json_decode( $body, true ); if ( empty( $json ) ) { $error = new WP_Error( $provider . '_failed_decode', 'Fail to decode', array( $body ) ); forminator_maybe_log( __METHOD__, $error ); return $error; } if ( 'recaptcha' === $provider ) { if ( ! empty( $score ) && ! empty( $json['score'] ) && floatval( $json['score'] ) < floatval( $score ) ) { $error = new WP_Error( 'recaptcha_failed_score', 'Score is lower than expected.', array( $body ) ); forminator_maybe_log( __METHOD__, $error ); return $error; } } elseif ( ! empty( $score ) && ! empty( $json['score'] ) && floatval( $json['score'] ) >= floatval( $score ) ) { $error = new WP_Error( 'hcaptcha_failed_score', 'Score is higher than expected.', array( $body ) ); forminator_maybe_log( __METHOD__, $error ); return $error; } // success verify. if ( isset( $json['success'] ) && true === $json['success'] ) { return true; } // read error. $error = new WP_Error( $provider . '_failed_verify', 'Fail to verify', array( $json ) ); return $error; } /* * Get Recaptcha endpoint to verify user response * * @since 1.5.3 * @since 1.15.5 Added hcaptcha endpoint * * @return string / private function get_verify_endpoint() { $provider = $this->provider; if ( 'recaptcha' === $provider ) { $endpoint = 'https://www.google.com/recaptcha/api/siteverify'; } elseif ( 'turnstile' === $provider ) { $endpoint = 'https://challenges.cloudflare.com/turnstile/v0/siteverify'; } else { $endpoint = 'https://hcaptcha.com/siteverify'; } /* * Filter endpoint to be used for verify captcha * * @since 1.5.3 forminator_recaptcha_verify_endpoint * @since 1.15.5 Added filter for hcaptcha: forminator_hcaptcha_verify_endpoint * * @param string $endpoint * * @return string */ $endpoint = apply_filters( 'forminator_' . $provider . '_verify_endpoint', $endpoint ); return $endpoint; } }	3.65 KB	2026-01-12 18:46
📄 class-core.php <?php /** * Forminator Core * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Core * * @since 1.0 / class Forminator_Core { /* * Forminator_Admin Instance * * @var Forminator_Admin / public $admin; /* * Store modules objects * * @var array / public $modules = array(); /* * Store forms objects * * @var array / public $forms = array(); /* * Store fields objects * * @var array / public $fields = array(); /* * Store PRO fields * * @var array / public $pro_fields = array(); /* * Store field objects * * @var array / private static $field_objects = array(); /* * Plugin instance * * @var null / private static $instance = null; /* * Return the plugin instance * * @since 1.0 * @return Forminator / public static function get_instance() { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Forminator_Core constructor. * * @since 1.0 / public function __construct() { // Include all necessary files. $this->includes(); // First check if upgrade of data is needed. Forminator_Upgrade::init(); if ( is_admin() ) { // Initialize admin core. $this->admin = new Forminator_Admin(); new Forminator_Shortcode_Generator(); add_action( 'wp_head', array( $this, 'localize_pointers' ) ); } Forminator_Hub_Connector::get_instance(); // Get enabled modules. $modules = new Forminator_Modules(); $this->modules = $modules->get_modules(); // Get enabled fields. $fields = new Forminator_Fields(); $this->fields = $fields->get_fields(); $this->set_field_objects(); /* * Filter Pro fields for promotion PRO version * * @since 1.13 * @param array $pro_fields Array of PRO fields e.g. [ 'field_type' => 'test', 'name' => 'test, 'icon' => 'sui-icon-pencil' ]. / $this->pro_fields = apply_filters( 'forminator_pro_fields', array() ); // HACK: Add settings and entries page at the end of the list. if ( is_admin() ) { $this->admin->add_templates_page(); $this->admin->add_entries_page(); if ( Forminator::is_addons_feature_enabled() ) { $this->admin->add_integrations_page(); } if ( forminator_global_tracking() ) { $this->admin->add_reports_page(); } $this->admin->add_settings_page(); if ( ! forminator_addons_disabled() ) { $this->admin->add_addons_page(); } if ( ! FORMINATOR_PRO ) { $this->admin->add_upgrade_page(); } } // Protection management. Forminator_Protection::get_instance(); // Export management. Forminator_Export::get_instance(); if ( forminator_global_tracking() ) { Forminator_Reports::get_instance(); } // Post meta box. add_action( 'init', array( &$this, 'post_field_meta_box' ) ); if ( ! FORMINATOR_PRO ) { add_action( 'init', array( __CLASS__, 'load_cross_sell_module' ) ); } // Clean up Action Scheduler. add_action( 'init', array( $this, 'schedule_action_scheduler_cleanup' ), 999 ); add_action( 'forminator_action_scheduler_cleanup', array( &$this, 'action_scheduler_cleanup' ) ); } /* * Set field objects / private function set_field_objects() { if ( self::$field_objects ) { return; } foreach ( $this->fields as $field_object ) { self::$field_objects[ $field_object->slug ] = $field_object; } } /* * Get field object by field type * * @param string $type Field type. * @return object / public static function get_field_object( $type ) { if ( 'stripe-ocs' === $type ) { $type = 'stripe'; } $object = isset( self::$field_objects[ $type ] ) ? self::$field_objects[ $type ] : null; return $object; } /* * Get field types * * @return array / public static function get_field_types() { $types = array_keys( self::$field_objects ); return $types; } /* * Get field type based on $element_id * * @param string $element_id Field slug. * @return array / public static function get_field_type( $element_id ) { $field_type = ''; $parts = explode( '-', $element_id ); // all avail fields on library. $field_types = self::get_field_types(); if ( in_array( $parts[0], $field_types, true ) ) { $field_type = $parts[0]; } return $field_type; } /* * Initialize Mixpanel tracking. * * @param bool $force Force tracking. * @return void / public static function init_mixpanel( bool $force = false ) { if ( ! forminator_usage_tracking_disabled() && ( ( ! self::is_tracking_active() && ! $force ) \|\| ! is_admin() ) ) { return; } if ( ! class_exists( 'WPMUDEV_Analytics_V4' ) ) { $autoload = plugin_dir_path( __FILE__ ) . 'lib/analytics/autoload.php'; if ( ! file_exists( $autoload ) ) { return; } // Prefixed vendor autoload. include_once $autoload; } include_once plugin_dir_path( __FILE__ ) . 'mixpanel/class-mixpanel.php'; Forminator_Mixpanel::get_instance(); } /* * Check if usage tracking is active. * * @return bool / public static function is_tracking_active() { return get_option( 'forminator_usage_tracking' ); } /* * Includes * * @since 1.0 / private function includes() { // Abstracts. / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-field.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-form-result.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-form-template.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-front-action.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-mail.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-payment-gateway.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-spam-protection.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-user.php'; // Classes. / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-abandonment.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-loader.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-modules.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-form-fields.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-database-tables.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-upgrade.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-geo.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-protection.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-shortcode-generator.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-export-result.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-export.php'; include_once forminator_plugin_dir() . 'library/class-template-api.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-reports.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/render/class-render-form.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/render/class-assets-enqueue.php'; / @noinspection PhpIncludeInspection / if ( version_compare( PHP_VERSION, '5.3.0', 'ge' ) && file_exists( forminator_plugin_dir() . 'library/gateways/class-paypal-express.php' ) ) { include_once forminator_plugin_dir() . 'library/gateways/class-paypal-express.php'; } if ( version_compare( PHP_VERSION, '5.6.0', 'ge' ) && file_exists( forminator_plugin_dir() . 'library/gateways/class-stripe.php' ) ) { / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/gateways/class-stripe.php'; } / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/render/class-widget.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-captcha-verification.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-migration.php'; // Models. / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-form-entry-model.php'; // Helpers. include_once forminator_plugin_dir() . 'library/helpers/encryption.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-core.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-importer.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-modules.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-forms.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-fields.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-google-fonts.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-mail.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-currency.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-autofill.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-calculator.php'; if ( version_compare( PHP_VERSION, '5.6.0', 'ge' ) ) { / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/helpers/helper-payment.php'; } // Model. / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-base-form-model.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-custom-form-model.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-form-field-model.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-poll-form-model.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-quiz-form-model.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/model/class-form-views-model.php'; include_once forminator_plugin_dir() . 'library/model/class-form-reports-model.php'; include_once forminator_plugin_dir() . 'library/class-forminator-hub-connector.php'; $hub_connector_lib = forminator_plugin_dir() . 'library/lib/hub-connector/connector.php'; if ( file_exists( $hub_connector_lib ) ) { include_once $hub_connector_lib; } if ( is_admin() ) { / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'admin/abstracts/class-admin-page.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'admin/abstracts/class-admin-view-page.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'admin/abstracts/class-admin-module-edit-page.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'admin/abstracts/class-admin-module.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'admin/abstracts/class-admin-import-mediator.php'; / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'admin/classes/class-admin.php'; / @noinspection PhpIncludeInspection / if ( ! class_exists( 'WP_List_Table' ) ) { / @noinspection PhpIncludeInspection / require_once ABSPATH . 'wp-admin/includes/class-wp-screen.php';// added. / @noinspection PhpIncludeInspection / require_once ABSPATH . 'wp-admin/includes/screen.php';// added. / @noinspection PhpIncludeInspection / require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php'; / @noinspection PhpIncludeInspection / require_once ABSPATH . 'wp-admin/includes/template.php'; } self::init_mixpanel(); } if ( Forminator::is_internal_page_cache_support_enabled() ) { / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/class-page-cache.php'; } } /* * Sets the Plugins Cross Sell submodule. / public static function load_cross_sell_module() { $cross_sell_path = forminator_plugin_dir() . 'library/lib/plugins-cross-sell-page/plugin-cross-sell.php'; if ( ! file_exists( $cross_sell_path ) ) { return; } static $cross_sell = null; if ( is_null( $cross_sell ) ) { if ( ! class_exists( '\WPMUDEV\Modules\Plugin_Cross_Sell' ) ) { require_once $cross_sell_path; } $submenu_params = array( 'slug' => 'forminator', 'parent_slug' => 'forminator', 'menu_slug' => 'forminator_cross_sell', 'position' => 17, ); $cross_sell = new \WPMUDEV\Modules\Plugin_Cross_Sell( $submenu_params ); } } /* * Start creating meta box for the posts * * @since 1.0 / public function post_field_meta_box() { add_action( 'add_meta_boxes', array( $this, 'setup_post_meta_box' ) ); } /* * Setup the meta box * * @since 1.0 / public function setup_post_meta_box() { global $post; if ( is_object( $post ) ) { $is_forminator_meta = get_post_meta( $post->ID, '_has_forminator_meta', false ); if ( $is_forminator_meta ) { add_meta_box( 'forminator-post-meta-box', esc_html__( 'Post Custom Data', 'forminator' ), array( $this, 'render_post_meta_box' ), $post->post_type, 'normal', 'default' ); } } } /* * Localize pointers * * @return void / public function localize_pointers() { ?> <script type="text/javascript"> var ajaxurl = '<?php echo esc_url( admin_url( 'admin-ajax.php' ) ); ?>'; </script> <?php } /* * Render Meta box * * @param WP_Post $post Post. * * @since 1.0 / public function render_post_meta_box( $post ) { $meta_values = get_post_custom( $post->ID ); ?> <table class="widefat"> <tbody> <?php foreach ( $meta_values as $key => $value ) { if ( '_' === $key[0] ) { continue; } $value = $value[0]; ?> <tr> <th><?php echo esc_html( $key ); ?></th> <td><?php echo esc_html( $value ); ?></td> </tr> <?php } ?> </tbody> </table> <?php } /* * Sanitize * * @param string $key POST key. * @param mixed $default_value Default value. * @return mixed / public static function sanitize_text_field( $key, $default_value = '' ) { if ( ! empty( $_POST[ $key ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing $value = sanitize_text_field( wp_unslash( $_POST[ $key ] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Missing } elseif ( ! empty( $_GET[ $key ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended $value = sanitize_text_field( wp_unslash( $_GET[ $key ] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended } else { $value = $default_value; } if ( 'page' === $key ) { $value = esc_attr( $value ); } return $value; } /* * Recursively sanitize data * * @param array $data Data. * @param string $current_key Current key. * * @return array\|string / public static function sanitize_array( $data, $current_key = '' ) { $data = wp_unslash( $data ); $skipped_keys = array( 'preview_data' ); // TODO: Should skip fields that has its own sanitize function. if ( in_array( $current_key, $skipped_keys, true ) \|\| 0 === strpos( $current_key, 'url-' ) \|\| 0 === strpos( $current_key, 'select-' ) \|\| 0 === strpos( $current_key, 'checkbox-' ) \|\| 0 === strpos( $current_key, 'password-' ) \|\| 0 === strpos( $current_key, 'confirm_password-' ) ) { return $data; } $allow_html = array( 'variations', 'question_description', 'thankyou-message', 'email-thankyou-message', 'manual-thankyou-message', 'user-email-editor', 'admin-email-editor', 'quiz_description', 'question_description', 'email-editor', 'email-editor-method-email', 'email-editor-method-manual', 'msg_count', 'confirm-password-description', 'description', 'consent_description', 'hc_invisible_notice', 'options_bulk_editor', 'label', 'value', 'importable', 'sc_message', 'hidden-registration-form-message', 'hidden-login-form-message', 'footer_value', 'payee_info', 'payer_info', 'payment_note', 'product_value', ); $allow_iframe = array( 'variations' ); if ( in_array( $current_key, $allow_html, true ) \|\| 0 === strpos( $current_key, 'html-' ) \|\| 0 === strpos( $current_key, 'textarea-' ) \|\| 0 === strpos( $current_key, 'radio-' ) \|\| false !== strpos( $current_key, '-post-title' ) \|\| false !== strpos( $current_key, '-post-content' ) \|\| false !== strpos( $current_key, '-post-excerpt' ) ) { if ( in_array( $current_key, $allow_iframe, true ) ) { // To allow iframes in content. add_filter( 'wp_kses_allowed_html', array( __CLASS__, 'maybe_add_iframe_to_kses_allowed_html' ) ); $data = trim( wp_kses_post( $data ) ); remove_filter( 'wp_kses_allowed_html', array( __CLASS__, 'maybe_add_iframe_to_kses_allowed_html' ) ); return $data; } return trim( wp_kses_post( $data ) ); } // Allow line breaks. $allow_linebreaks = array( 'custom_css', 'placeholder', ); if ( in_array( $current_key, $allow_linebreaks, true ) ) { return sanitize_textarea_field( $data ); } // Cannot use esc_url_raw coz it strips curly braces. if ( 'redirect-url' === $current_key \|\| 'formula' === $current_key ) { // Cannot use sanitize_text_field as it removes percentage strings. return trim( wp_strip_all_tags( $data ) ); } if ( ! is_array( $data ) ) { return sanitize_text_field( $data ); } else { foreach ( $data as $key => $value ) { $data[ $key ] = self::sanitize_array( $value, $key ); } return $data; } } /* * Recursively sanitize html data * * @param array $data Data. * * @return array\|string / public static function sanitize_html_array( $data ) { if ( ! is_array( $data ) ) { return esc_html( $data ); } else { foreach ( $data as $key => $value ) { $data[ $key ] = self::sanitize_html_array( $value ); } return $data; } } /* * Shedule the Action Scheduler cleanup every hour. * * @return mixed / public function schedule_action_scheduler_cleanup() { forminator_set_recurring_action( 'forminator_action_scheduler_cleanup', HOUR_IN_SECONDS 2 ); } /** * Delete Action Scheduler actions and logs of Forminator. * * @param null\|string $db_prefix DB Prefix. * * @return void / public static function action_scheduler_cleanup( $db_prefix = null ) { global $wpdb; $is_uninstall = false; // If null, its being called by AS action hook. if ( is_null( $db_prefix ) ) { $db_prefix = $wpdb->prefix; } else { // Plugin is being uninstalled, unschedule all and all forminator scheduled actions. $is_uninstall = true; } $table_actions = $db_prefix . 'actionscheduler_actions'; $table_logs = $db_prefix . 'actionscheduler_logs'; $table_groups = $db_prefix . 'actionscheduler_groups'; $slug = 'forminator'; // Check if all tables exist. if ( ! self::check_action_scheduler_tables( $db_prefix ) ) { return; } $group_id = (int) $wpdb->get_var( $wpdb->prepare( "SELECT group_id FROM {$table_groups} WHERE slug = %s", $slug ) ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.DirectDatabaseQuery.DirectQuery $and = ''; // If not uninstall, do not delete pending tasks. if ( ! $is_uninstall ) { $and = "AND ( as_actions.status = 'complete' \|\| as_actions.status = 'failed' \|\| as_actions.status = 'canceled' )"; } // phpcs:disable WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQL.NotPrepared $query = $wpdb->prepare( "SELECT action_id FROM {$table_actions} as_actions WHERE as_actions.group_id = %s " . $and . ' LIMIT 100', $group_id ); // phpcs:enable WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQL.NotPrepared // Delete all AS forminator actions and logs. while ( $action_ids = $wpdb->get_col( $query ) ) { // phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition, WordPress.DB.PreparedSQL.NotPrepared, WordPress.DB.DirectDatabaseQuery.DirectQuery if ( empty( $action_ids ) ) { break; } $where_in = implode( ', ', array_fill( 0, is_array( $action_ids ) \|\| $action_ids instanceof \Countable ? count( $action_ids ) : 0, '%s' ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery $wpdb->query( // phpcs:disable WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare $wpdb->prepare( "DELETE as_actions, as_logs FROM {$table_actions} as_actions LEFT JOIN {$table_logs} as_logs ON as_actions.action_id = as_logs.action_id WHERE as_actions.action_id IN ( {$where_in} )", $action_ids ) // phpcs:enable WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare ); } } /* * Check if Action Scheduler tables exist. * * @param string $db_prefix DB Prefix. * * @return bool / public static function check_action_scheduler_tables( $db_prefix = null ) { global $wpdb; if ( is_null( $db_prefix ) ) { $db_prefix = $wpdb->prefix; } $table_actions = $db_prefix . 'actionscheduler_actions'; $table_logs = $db_prefix . 'actionscheduler_logs'; $table_groups = $db_prefix . 'actionscheduler_groups'; // Check if all tables exist. $table_count = (int) $wpdb->get_var( // phpcs:ignore WordPress.DB.DirectDatabaseQuery $wpdb->prepare( 'SELECT count() FROM information_schema.tables WHERE table_schema = %s AND table_name IN (%s, %s, %s)', $wpdb->dbname, $table_actions, $table_logs, $table_groups ) ); if ( 3 !== $table_count ) { return false; } return true; } /** * Add iframe to the wp_kses_allowed_html filter for the front end. * It is strongly recommended to call this method via maybe_add_iframe_to_kses_allowed_html unless it's an exceptional case. * * @param array $allowed_html Allowed HTML tags. * @return array / public static function add_iframe_to_kses_allowed_html( $allowed_html ) { $allowed_html['iframe'] = array( 'align' => true, 'width' => true, 'height' => true, 'frameborder' => true, 'name' => true, 'src' => true, 'id' => true, 'class' => true, 'style' => true, 'scrolling' => true, 'marginwidth' => true, 'marginheight' => true, 'allowfullscreen' => true, ); return $allowed_html; } /* * Add iframe on filter wp_kses_allowed_html * * @param array $allowed_html Allowed HTML tags. * @return array */ public static function maybe_add_iframe_to_kses_allowed_html( $allowed_html ) { if ( current_user_can( 'unfiltered_html' ) ) { return self::add_iframe_to_kses_allowed_html( $allowed_html ); } return $allowed_html; } }	23.94 KB	2026-01-12 18:46
📄 class-database-tables.php <?php /** * Forminator Database Tables * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Upgrade * * Handle any installation upgrade or install tasks / class Forminator_Database_Tables { /* * Table name keys / const FORM_ENTRY = 'form_entry'; const FORM_ENTRY_META = 'form_entry_meta'; const FORM_VIEWS = 'form_views'; const FORM_REPORTS = 'form_reports'; /* * Current tables * * @var array / private static $tables = array(); /* * Get all the used table names * * @param bool $db DB. * * @return array * @since 1.0 / private static function table_names( $db = false ) { if ( ! $db ) { global $wpdb; $db = $wpdb; } return array( self::FORM_ENTRY => $db->prefix . 'frmt_form_entry', self::FORM_ENTRY_META => $db->prefix . 'frmt_form_entry_meta', self::FORM_VIEWS => $db->prefix . 'frmt_form_views', self::FORM_REPORTS => $db->prefix . 'frmt_form_reports', ); } /* * Get Table Name * * @param string $name - the name of the table. * * @return string\|bool * @since 1.0 / public static function get_table_name( $name ) { if ( empty( self::$tables ) ) { self::$tables = self::table_names(); } return isset( self::$tables[ $name ] ) ? self::$tables[ $name ] : false; } /* * Set up custom database tables * * @since 1.0 / public static function install_database_tables() { require_once ABSPATH . 'wp-admin/includes/upgrade.php'; global $wpdb; $wpdb->hide_errors(); $max_index_length = 191; $charset_collate = $wpdb->get_charset_collate(); // Form entry. $table_name = self::get_table_name( self::FORM_ENTRY ); if ( $table_name ) { $sql = "CREATE TABLE {$table_name} ( `entry_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, `entry_type` VARCHAR(191) NOT NULL, `draft_id` VARCHAR(12) NULL, `form_id` bigint(20) unsigned NOT NULL, `is_spam` TINYINT(1) NOT NULL DEFAULT 0, `date_created` datetime NOT NULL default '0000-00-00 00:00:00', `status` ENUM('active','spam','draft','abandoned') NOT NULL DEFAULT 'active', PRIMARY KEY (`entry_id`), KEY `entry_is_spam` (`is_spam` ASC ), KEY `entry_status` (`status`), KEY `entry_form_status` (`form_id`, `status`), KEY `entry_type` (`entry_type`($max_index_length)), KEY `entry_form_id` (`form_id`)) $charset_collate;"; dbDelta( $sql ); } // Form entry meta. // Each entry is unique to each form. $table_name = self::get_table_name( self::FORM_ENTRY_META ); if ( $table_name ) { $sql = "CREATE TABLE {$table_name} ( `meta_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, `entry_id` bigint(20) unsigned NOT NULL, `meta_key` VARCHAR(191) default NULL, `meta_value` LONGTEXT NULL, `date_created` datetime NOT NULL default '0000-00-00 00:00:00', `date_updated` datetime NOT NULL default '0000-00-00 00:00:00', PRIMARY KEY (`meta_id`), KEY `meta_key` (`meta_key`($max_index_length)), KEY `meta_entry_id` (`entry_id` ASC ), KEY `meta_key_object` (`entry_id` ASC, `meta_key` ASC)) $charset_collate;"; dbDelta( $sql ); } // Views. $table_name = self::get_table_name( self::FORM_VIEWS ); if ( $table_name ) { $sql = "CREATE TABLE {$table_name} ( `view_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, `form_id` bigint(20) unsigned NOT NULL, `page_id` bigint(20) unsigned NOT NULL, `ip` VARCHAR(191) default NULL, `count` mediumint(8) unsigned not null default 1, `date_created` datetime NOT NULL default '0000-00-00 00:00:00', `date_updated` datetime NOT NULL default '0000-00-00 00:00:00', PRIMARY KEY (`view_id`), KEY `view_form_id` (`form_id` ASC ), KEY `view_ip` (`ip`($max_index_length)), KEY `view_form_object` (`form_id` ASC, `view_id` ASC), KEY `view_form_object_ip` (`form_id` ASC, `view_id` ASC, `ip` ASC)) $charset_collate;"; dbDelta( $sql ); } // Reports table. $table_name = self::get_table_name( self::FORM_REPORTS ); if ( $table_name ) { $sql = "CREATE TABLE {$table_name} ( `report_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, `report_value` LONGTEXT NOT NULL, `status` VARCHAR(200) NOT NULL, `date_created` datetime NOT NULL default '0000-00-00 00:00:00', `date_updated` datetime NOT NULL default '0000-00-00 00:00:00', PRIMARY KEY (`report_id`) ) $charset_collate;"; dbDelta( $sql ); } } /* * Migrate existing entries to the new `status` column. * * - spam -> status = 'spam' * - drafts (draft_id not empty and not null) -> status = 'draft' * - others remain 'active' (default) * * @param string\|null $new_version The new plugin version being upgraded to. * @param string\|null $old_version The previously installed plugin version. * * @return void / public static function maybe_migrate_entry_status( $new_version = null, $old_version = null ) { global $wpdb; $table_name = self::get_table_name( self::FORM_ENTRY ); if ( ! $table_name ) { return; } // If called from versioned hook, ensure we only run for upgrades below the target version. $target_version = '1.48.0'; if ( ! empty( $old_version ) && version_compare( $old_version, $target_version, '>' ) ) { return; } // Check if status column exists. $column = $wpdb->get_var( $wpdb->prepare( "SHOW COLUMNS FROM {$table_name} LIKE %s", 'status' ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.DirectDatabaseQuery.NoCaching if ( empty( $column ) ) { return; } // Only run once per installation/upgrade. $option_key = 'forminator_status_migration_done'; if ( get_option( $option_key ) ) { return; } // phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.DirectDatabaseQuery.NoCaching // Set drafts first without checking spam; spam update below will override when needed. $wpdb->query( "UPDATE {$table_name} SET `status` = 'draft' WHERE (`draft_id` IS NOT NULL AND `draft_id` <> '') AND `status` <> 'draft'" ); // Mark spam second so it always wins over any previous state. $wpdb->query( "UPDATE {$table_name} SET `status` = 'spam' WHERE `is_spam` = 1 AND `status` <> 'spam'" ); // Normalize any null/empty values to 'active' as safety. $wpdb->query( "UPDATE {$table_name} SET `status` = 'active' WHERE (`status` IS NULL OR `status` = '')" ); // phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.DirectDatabaseQuery.NoCaching update_option( $option_key, time() ); } /* * Delete custom tables * * @deprecated on 1.1 use forminator_drop_custom_tables on uninstall.php * @since 1.0 / public static function uninstall_database_tables() { _deprecated_function( __METHOD__, '1.1', 'forminator_drop_custom_tables' ); global $wpdb; $tables = self::table_names( $wpdb ); $wpdb->hide_errors(); foreach ( $tables as $table_name ) { // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- Caching is not required while dropping the table. if ( ( $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $table_name ) ) === $table_name ) ) { $wpdb->query( $wpdb->prepare( 'DROP TABLE %s', $table_name ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.SchemaChange } } } /* * Insert default database entries * * @return void */ public static function insert_default_entries() { Forminator_Form_Reports_Model::get_instance()->default_report_entry(); } }	7.54 KB	2026-01-12 18:46
📄 class-export-result.php <?php /** * Forminator Export Result * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Export_Result * * Export result data struct * * @since 1.5.4 / class Forminator_Export_Result { /* * Export data. * * @var array / public $data = array(); /* * Entries count * * @var int / public $entries_count = 0; /* * New entries count * * @var int / public $new_entries_count = 0; /* * Form Model Instance * * @var Forminator_Base_Form_Model \| null / public $model = null; /* * Latest entry Id * * @var int / public $latest_entry_id = 0; /* * File path * * @var string / public $file_path = ''; /* * Form type * * @var string / public $form_type = ''; /* * Forminator_Export_Result Constructor / public function __construct() { } /* * Parsing filters * * @since 1.5.4 */ public function request_filters() { $data_range = Forminator_Core::sanitize_text_field( 'date_range' ); $search = Forminator_Core::sanitize_text_field( 'search' ); $min_id = Forminator_Core::sanitize_text_field( 'min_id' ); $max_id = Forminator_Core::sanitize_text_field( 'max_id' ); $order_by = Forminator_Core::sanitize_text_field( 'order_by' ); $order = Forminator_Core::sanitize_text_field( 'order' ); $user_stat = Forminator_Core::sanitize_text_field( 'user_status' ); $entry_status = Forminator_Core::sanitize_text_field( 'entry_status' ); $filters = array(); if ( ! empty( $data_range ) ) { $date_ranges = explode( ' - ', $data_range ); if ( is_array( $date_ranges ) && isset( $date_ranges[0] ) && isset( $date_ranges[1] ) ) { $date_ranges[0] = gmdate( 'Y-m-d', strtotime( $date_ranges[0] ) ); $date_ranges[1] = gmdate( 'Y-m-d', strtotime( $date_ranges[1] ) ); forminator_maybe_log( __METHOD__, $date_ranges ); $filters['date_created'] = array( $date_ranges[0], $date_ranges[1] ); } } if ( ! empty( $search ) ) { $filters['search'] = $search; } if ( ! empty( $min_id ) ) { $min_id = intval( $min_id ); if ( $min_id > 0 ) { $filters['min_id'] = $min_id; } } if ( ! empty( $max_id ) ) { $max_id = intval( $max_id ); if ( $max_id > 0 ) { $filters['max_id'] = $max_id; } } if ( $order_by ) { $filters['order_by'] = $order_by; } if ( $order ) { $filters['order'] = $order; } if ( ! empty( $user_stat ) ) { $filters['user_status'] = $user_stat; } if ( $entry_status ) { $filters['entry_status'] = $entry_status; } return $filters; } }	2.57 KB	2026-01-12 18:46
📄 class-export.php <?php /** * Forminator Export * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Export * * Handle data exports * * @since 1.0 / class Forminator_Export { /* * Plugin instance * * @var null / private static $instance = null; /* * Holds fields to be exported * * @since 1.0.5 * * @var array / private $global_fields_to_export = array(); /* * Form registered addon * * @var Forminator_Integration[] / private static $form_registered_addons = array(); /* * Poll registered addon * * @var Forminator_Integration[] / private static $poll_registered_addons = array(); /* * Quiz registered addon * * @var Forminator_Integration[] / private static $quiz_registered_addons = array(); /* * Return the plugin instance * * @return Forminator_Export * * @since 1.0 / public static function get_instance() { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Main constructor * * @since 1.0 / public function __construct() { add_action( 'wp_loaded', array( &$this, 'listen_for_csv_export' ) ); add_action( 'wp_loaded', array( &$this, 'listen_for_saving_export_schedule' ) ); // schedule for check and send export. add_action( 'init', array( &$this, 'schedule_entries_exporter' ) ); add_action( 'forminator_send_export', array( &$this, 'maybe_send_export' ) ); } /* * Set up the schedule * * @since 1.0 * @since 1.27 Change from WP cron to Action Scheduler / public function schedule_entries_exporter() { forminator_set_recurring_action( 'forminator_send_export', MINUTE_IN_SECONDS ); } /* * Listen for export action * * @since 1.0 / public function listen_for_csv_export() { $forminator_export = Forminator_Core::sanitize_text_field( 'forminator_export' ); if ( ! $forminator_export ) { return; } if ( ! forminator_is_user_allowed( 'forminator-entries' ) ) { wp_die( esc_html__( 'You are not allowed to export submissions.', 'forminator' ) ); return; } $nonce = Forminator_Core::sanitize_text_field( '_forminator_nonce' ); if ( ! wp_verify_nonce( $nonce, 'forminator_export' ) ) { wp_die( esc_html__( 'Invalid nonce.', 'forminator' ) ); return; } $form_id = filter_input( INPUT_POST, 'form_id', FILTER_VALIDATE_INT ); $type = Forminator_Core::sanitize_text_field( 'form_type' ); $filter = filter_input( INPUT_POST, 'submission-filter', FILTER_VALIDATE_BOOLEAN ); $form_id = intval( $form_id ); $export_data = $this->prepare_export_data( $form_id, $type, 0, $filter ); if ( ! $export_data instanceof Forminator_Export_Result ) { return; } $data = $export_data->data; $model = $export_data->model; $count = $export_data->entries_count; // save the time for later uses. $logs = get_option( 'forminator_exporter_log', array() ); if ( ! isset( $logs[ $model->id ] ) ) { $logs[ $model->id ] = array(); } $logs[ $model->id ][] = array( 'time' => current_time( 'timestamp' ), // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone. 'count' => $count, ); update_option( 'forminator_exporter_log', $logs ); /* * Action hook to trigger before Manual Export download. * * @param int $form_id Form ID * @param string $form_type Form type(form/quiz/poll) * * @since 1.27.0 / do_action( 'forminator_before_manual_export_download', $form_id, $type ); $fp = fopen( 'php://output', 'w' ); // phpcs:disable WordPress.WP.AlternativeFunctions.file_system_read_fopen -- disable phpcs because it writes memory ob_start(); foreach ( $data as $fields ) { $fields = self::get_formatted_csv_fields( $fields ); fputcsv( $fp, $fields, ',', '"', '\\' ); } $filename = sanitize_title( esc_html__( 'forminator', 'forminator' ) ) . '-' . sanitize_title( $model->name ) . '-' . gmdate( 'ymdHis' ) . '.csv'; $output = ob_get_clean(); header( 'Content-Encoding: UTF-8' ); header( 'Content-type: text/csv; charset=UTF-8' ); header( 'Content-Disposition: attachment; filename="' . $filename . '";' ); // print BOM Char for Excel Compatible. echo chr( 239 ) . chr( 187 ) . chr( 191 ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped // make php send the generated csv lines to the browser. exit( $output ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } /* * Listen for the POST request to store schedule data * * @since 1.0 / public function listen_for_saving_export_schedule() { $action = Forminator_Core::sanitize_text_field( 'action' ); if ( 'forminator_export_entries' === $action ) { $nonce = Forminator_Core::sanitize_text_field( '_forminator_nonce' ); if ( ! $nonce \|\| ! wp_verify_nonce( $nonce, 'forminator_export' ) ) { $redirect = add_query_arg( array( 'err_msg' => rawurlencode( esc_html__( 'Invalid request, you are not allowed to do that action.', 'forminator' ) ), ) ); wp_safe_redirect( $redirect ); exit; } $data = $this->get_entries_export_schedule(); $form_id = filter_input( INPUT_POST, 'form_id', FILTER_VALIDATE_INT ); if ( ! $form_id ) { $redirect = add_query_arg( array( 'err_msg' => rawurlencode( esc_html__( 'Invalid form ID.', 'forminator' ) ), ) ); wp_safe_redirect( $redirect ); exit; } $form_type = Forminator_Core::sanitize_text_field( 'form_type' ); if ( ! $form_type ) { $redirect = add_query_arg( array( 'err_msg' => rawurlencode( esc_html__( 'Invalid form type.', 'forminator' ) ), ) ); wp_safe_redirect( $redirect ); exit; } $enabled = filter_input( INPUT_POST, 'enabled', FILTER_VALIDATE_BOOLEAN ); $email = filter_input( INPUT_POST, 'email', FILTER_VALIDATE_EMAIL, FILTER_REQUIRE_ARRAY ); if ( $enabled && ! $email ) { $redirect = add_query_arg( array( 'err_msg' => rawurlencode( esc_html__( 'Invalid email.', 'forminator' ) ), ) ); wp_safe_redirect( $redirect ); exit; } $key = $form_id . $form_type; $current_form_export = isset( $data[ $key ] ) ? $data[ $key ] : array(); $last_sent = current_time( 'timestamp' ); // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone. $interval = Forminator_Core::sanitize_text_field( 'interval' ); if ( 'daily' === $interval ) { $last_sent = strtotime( '-24 hours', current_time( 'timestamp' ) ); // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone. } $data[ $key ] = array( 'enabled' => $enabled, 'form_id' => $form_id, 'form_type' => $form_type, 'email' => $email ? $email : '', 'interval' => $interval, 'month_day' => Forminator_Core::sanitize_text_field( 'month_day' ), 'day' => Forminator_Core::sanitize_text_field( 'day' ), 'hour' => Forminator_Core::sanitize_text_field( 'hour' ), 'last_sent' => $last_sent, 'if_new' => (bool) filter_input( INPUT_POST, 'if_new', FILTER_VALIDATE_BOOLEAN ), 'last_sent_row_id' => isset( $current_form_export['last_sent_row_id'] ) ? $current_form_export['last_sent_row_id'] : 0, ); forminator_maybe_log( $data[ $key ] ); update_option( 'forminator_entries_export_schedule', $data ); /* * Action hook to trigger after Schedule Export save. * * @param int $form_id Form ID * @param string $form_type Form type(form/quiz/poll) * @param array $data all the export form data * * @since 1.27.0 / do_action( 'forminator_after_export_schedule_save', $form_id, $form_type, $data ); $redirect = remove_query_arg( array( 'err_msg' ) ); $referer = wp_get_referer(); if ( empty( $referer ) ) { // on same request uri `wp_get_referer` return false. $referer = wp_get_raw_referer(); } if ( ! empty( $referer ) && ! headers_sent() ) { // probably header sent so skip this logic to avoid erro. $referer_query = wp_parse_url( $referer, PHP_URL_QUERY ); if ( ! empty( $referer_query ) ) { wp_parse_str( $referer_query, $query_strings ); if ( ! empty( $query_strings ) && isset( $query_strings['page'] ) && 'forminator-entries' === $query_strings['page'] ) { // additional redirect parameter on global entries page. $redirect = add_query_arg( array( 'form_id' => $form_id, ), $redirect ); } } } wp_safe_redirect( $redirect ); exit; } } /* * Try send export * * @since 1.0 * @since 1.5.4 add force param * * @param bool $force force send, ignore last_sent timestamp. / public function maybe_send_export( $force = false ) { $export_schedules = $this->get_entries_export_schedule(); if ( empty( $export_schedules ) ) { return; } $receipts = array(); foreach ( $export_schedules as $row ) { if ( ! isset( $row['enabled'] ) \|\| ( isset( $row['enabled'] ) && ( 'false' === $row['enabled'] \|\| ! $row['enabled'] ) ) \|\| ( isset( $row['email'] ) && empty( $row['email'] ) ) ) { continue; } $last_sent = $row['last_sent']; // check the next sent. $next_sent = null; switch ( $row['interval'] ) { case 'daily': $next_sent = strtotime( '+24 hours', $last_sent ); $next_sent = gmdate( 'Y-m-d', $next_sent ) . ' ' . $row['hour']; break; case 'weekly': $day = isset( $row['day'] ) ? $row['day'] : 'mon'; $next_sent = strtotime( 'next ' . $day, $last_sent ); $next_sent = gmdate( 'Y-m-d', $next_sent ) . ' ' . $row['hour']; break; case 'monthly': $next_sent = $this->get_monthly_export_date( $last_sent, $row ); break; default: break; } $is_send = current_time( 'timestamp' ) > strtotime( $next_sent ); // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone. if ( $force ) { $is_send = true; } if ( $is_send ) { $last_entry_id = isset( $row['last_sent_row_id'] ) ? intval( $row['last_sent_row_id'] ) : 0; // queue to prevent spam. $info = $this->prepare_attachment( $row['form_id'], $row['form_type'], $row['email'], $last_entry_id ); if ( ! $info instanceof Forminator_Export_Result \|\| empty( $info->file_path ) ) { continue; } if ( ! empty( $row['email'] ) ) { $export_email = is_array( $row['email'] ) ? $row['email'] : array( $row['email'] ); foreach ( $export_email as $email ) { if ( ! isset( $receipts[ $email ] ) ) { $receipts[ $email ] = array(); } $receipts[ $email ][] = $info; } } } } $files = array(); // now start to send. foreach ( $receipts as $email => $info ) { $current_files = array(); $export_results = array(); foreach ( $info as $export_result ) { /* * Forminator_Export_Result * * @var Forminator_Export_Result $export_result / $schedule_key = $export_result->model->id . $export_result->form_type; $export_schedule = $this->get_entries_export_schedule( $schedule_key ); $last_row_id = isset( $export_schedule['last_sent_row_id'] ) ? intval( $export_schedule['last_sent_row_id'] ) : 0; $if_new = isset( $export_schedule['if_new'] ) ? filter_var( $export_schedule['if_new'], FILTER_VALIDATE_BOOLEAN ) : false; // update last sent,. // this options need to updated so it marked as email sent, and scheduled for next time. $export_schedules[ $schedule_key ]['last_sent'] = current_time( 'timestamp' ); // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone. $export_schedules[ $schedule_key ]['last_sent_row_id'] = $export_result->latest_entry_id; // only send email when new entry avail. if ( $if_new ) { // skip sending this email. if ( $last_row_id >= $export_result->latest_entry_id ) { forminator_maybe_log( __METHOD__, sprintf( 'Scheduled Export email for %s ID %s skipped, due to no new submissions last_sent_row_id: %s latest_entry_id: %s', $export_result->form_type, $export_result->model->id, $last_row_id, $export_result->latest_entry_id ) ); continue; } } // files reference needed for future deletion. $current_files[] = $export_result->file_path; $export_results[] = $export_result; } $files += $current_files; if ( ! empty( $export_results ) ) { $subject = $this->get_mail_subject( $export_results ); $mail_content = $this->get_mail_content( $export_results ); $mail_headers = $this->get_mail_headers( $email, $export_results ); wp_mail( $email, $subject, $mail_content, $mail_headers, $current_files ); } } $files = array_unique( $files ); foreach ( $files as $file ) { wp_delete_file( $file ); } if ( $receipts ) { update_option( 'forminator_entries_export_schedule', $export_schedules ); } } /* * Prepare export data * * @since 1.0 * @since 1.5 * @since 1.5.4 add `$latest_exported_entry_id` param to get new entries count * * @param int $form_id Form Id. * @param string $type Form type. * @param int $latest_exported_entry_id Entry Id. * @param string $filter Filter. * * @return Forminator_Export_Result / private function prepare_export_data( $form_id, $type, $latest_exported_entry_id = 0, $filter = '' ) { $model = null; $data = array(); $entries = array(); $export_result = new Forminator_Export_Result(); $export_result->form_type = $type; switch ( $type ) { case 'quiz': $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return null; } $mappers = array(); $lead_headers = array(); $export_result->model = $model; if ( ! empty( $filter ) ) { $filters = $export_result->request_filters(); $entries = Forminator_Form_Entry_Model::get_all_entries( $form_id, $filters ); } else { $entries = Forminator_Form_Entry_Model::get_all_entries( $form_id ); } $headers = array( esc_html__( 'Date', 'forminator' ), esc_html__( 'Question', 'forminator' ), esc_html__( 'Answer', 'forminator' ), esc_html__( 'Result', 'forminator' ), ); $has_leads = isset( $model->settings['hasLeads'] ) ? $model->settings['hasLeads'] : false; $leads_id = isset( $model->settings['leadsId'] ) ? $model->settings['leadsId'] : 0; if ( $has_leads && $leads_id ) { $form_model = Forminator_Base_Form_Model::get_model( $leads_id ); if ( is_object( $form_model ) ) { $mappers = $this->get_custom_form_export_mappers( $form_model ); foreach ( $mappers as $mapper ) { if ( 'entry_time_created' === $mapper['type'] ) { continue; } if ( ! isset( $mapper['sub_metas'] ) ) { $lead_headers[ $mapper['meta_key'] ] = $mapper['label']; } else { foreach ( $mapper['sub_metas'] as $sub_meta ) { $lead_headers[ $sub_meta['key'] ] = $sub_meta['label']; } } } $headers = array_merge( $headers, $lead_headers ); } } $addon_header = $this->attach_quiz_addons_on_export_render_title_row( $form_id, $entries ); $headers = array_merge( $headers, $addon_header ); foreach ( $entries as $entry ) { if ( $entry->entry_id > $latest_exported_entry_id ) { ++$export_result->new_entries_count; } $lead_data = $this->get_mapper_export_data( $mappers, $entry ); if ( 'nowrong' === $model->quiz_type ) { $meta = isset( $entry->meta_data['entry']['value'][0]['value'] ) ? $entry->meta_data['entry']['value'][0]['value'] : array(); if ( empty( $meta['answers'] ) && ! empty( $lead_data ) ) { $meta['answers'] = array( array( 'question' => '', 'answer' => '', 'result' => array( 'title' => '', ), ), ); } if ( isset( $meta['answers'] ) ) { $i = 1; foreach ( $meta['answers'] as $answer ) { $row = array(); $row[] = 1 === $i ? $entry->time_created : ''; $row[] = ! empty( $answer['question'] ) ? sprintf( '"%s"', $answer['question'] ) : ''; $row[] = $answer['answer']; if ( isset( $meta['result'] ) && isset( $meta['result']['title'] ) ) { $row[] = $meta['result']['title']; } if ( ! empty( $lead_data ) ) { foreach ( $lead_headers as $headers_id => $lead_header ) { if ( isset( $lead_data[ $headers_id ] ) ) { $row[] = 1 === $i ? $lead_data[ $headers_id ] : ''; } } } $addon_data = $this->attach_quiz_addons_on_export_render_entry_row( $form_id, $entry ); foreach ( $addon_header as $header_id => $item ) { if ( isset( $addon_data[ $header_id ] ) ) { $row[] = 1 === $i ? $addon_data[ $header_id ] : ''; } } $data[] = $row; ++$i; } } } elseif ( 'knowledge' === $model->quiz_type ) { $meta = isset( $entry->meta_data['entry']['value'] ) ? $entry->meta_data['entry']['value'] : array(); if ( empty( $meta ) && ! empty( $lead_data ) ) { $meta = array( array( 'question' => '', 'answer' => '', 'isCorrect' => '', ), ); } if ( ! empty( $meta ) ) { $i = 1; foreach ( $meta as $answer ) { $row = array(); $row[] = 1 === $i ? $entry->time_created : ''; $row[] = ! empty( $answer['question'] ) ? sprintf( '"%s"', $answer['question'] ) : ''; $row[] = $answer['answer']; if ( ! empty( $answer['answer'] ) ) { $row[] = ( ( $answer['isCorrect'] ) ? esc_html__( 'Correct', 'forminator' ) : esc_html__( 'Incorrect', 'forminator' ) ); } else { $row[] = ''; } if ( ! empty( $lead_data ) ) { foreach ( $lead_headers as $headers_id => $lead_header ) { if ( isset( $lead_data[ $headers_id ] ) ) { $row[] = 1 === $i ? $lead_data[ $headers_id ] : ''; } } } $addon_data = $this->attach_quiz_addons_on_export_render_entry_row( $form_id, $entry ); foreach ( $addon_header as $header_id => $item ) { if ( isset( $addon_data[ $header_id ] ) ) { $row[] = 1 === $i ? $addon_data[ $header_id ] : ''; } } $data[] = $row; ++$i; } } } } $data = array_merge( array( $headers ), $data ); $export_result->data = $data; break; case 'poll': $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return null; } $export_result->model = $model; $entries = Forminator_Form_Entry_Model::get_all_entries( $form_id ); foreach ( $entries as $entry ) { if ( $entry->entry_id > $latest_exported_entry_id ) { ++$export_result->new_entries_count; } } $fields_array = $model->get_fields_as_array(); $map_entries = Forminator_Form_Entry_Model::map_polls_entries_for_export( $form_id, $fields_array ); $header = array( esc_html__( 'Date', 'forminator' ), esc_html__( 'Answer', 'forminator' ), esc_html__( 'Extra', 'forminator' ), ); $addon_header = $this->attach_poll_addons_on_export_render_title_row( $form_id, $entries ); $header = array_merge( $header, $addon_header ); $data = array(); $data[] = $header; foreach ( $map_entries as $map_entry ) { $label = $map_entry['meta_value']; $entry = new Forminator_Form_Entry_Model( $map_entry['entry_id'] ); $extra = $entry->get_meta( 'extra', null ); $row = array( $entry->time_created, $label, $extra, ); $addon_data = $this->attach_poll_addons_on_export_render_entry_row( $form_id, $entry ); foreach ( $addon_header as $header_id => $item ) { if ( isset( $addon_data[ $header_id ] ) ) { $row[] = $addon_data[ $header_id ]; } } $data[] = $row; } $export_result->data = $data; break; case 'cform': $model = Forminator_Base_Form_Model::get_model( $form_id ); if ( ! is_object( $model ) ) { return null; } if ( ! empty( $filter ) ) { $filters = $export_result->request_filters(); $entries = Forminator_Form_Entry_Model::get_all_entries( $form_id, $filters ); } else { $entries = Forminator_Form_Entry_Model::get_all_entries( $form_id ); } $mappers = $this->get_custom_form_export_mappers( $model ); $addon_mappers = $this->attach_form_addons_on_export_render_title_row( $form_id, $entries ); $export_result->model = $model; $result = array(); foreach ( $entries as $entry ) { if ( empty( $entry->meta_data ) ) { continue; } if ( $entry->entry_id > $latest_exported_entry_id ) { ++$export_result->new_entries_count; } $data = array(); // traverse from fields to be correctly mapped with updated form fields. foreach ( $mappers as $mapper ) { // its from model's property. if ( isset( $mapper['property'] ) ) { if ( property_exists( $entry, $mapper['property'] ) ) { $property = $mapper['property']; // casting property to string. $data[] = (string) $entry->$property; } else { $data[] = ''; } } else { $data = self::add_meta_value( $data, $mapper, $entry ); } } // Addon columns. $addon_data = $this->attach_form_addons_on_export_render_entry_row( $form_id, $entry ); foreach ( $addon_mappers as $mapper_id => $mapper ) { if ( isset( $addon_data[ $mapper_id ] ) ) { $data[] = $addon_data[ $mapper_id ]; } } $result[ (string) $entry->entry_id ] = $data; } // flatten mappers to headers. $headers = array(); foreach ( $mappers as $mapper ) { if ( ! isset( $mapper['sub_metas'] ) ) { $headers[] = $mapper['label']; } else { foreach ( $mapper['sub_metas'] as $sub_meta ) { $headers[] = $sub_meta['label']; } } } // additional addon headers. foreach ( $addon_mappers as $mapper ) { $headers[] = $mapper; } $data = array_merge( array( 'headers' => $headers ), $result ); $export_result->data = $data; break; default: break; } $export_result->entries_count = count( $entries ); // DESC order, latest entry will be first. if ( isset( $entries[0] ) && $entries[0] instanceof Forminator_Form_Entry_Model ) { $latest_entry = $entries[0]; $export_result->latest_entry_id = $latest_entry->entry_id; } return $export_result; } /* * Add meta value * * @param array $data Saved data. * @param array $mapper Mapper. * @param object $entry Entry object. * @return array Updated data. / private static function add_meta_value( $data, $mapper, $entry ) { $copies = array_filter( $entry->meta_data, function ( $key ) use ( $mapper ) { return strpos( $key, $mapper['meta_key'] . '-' ) === 0 \|\| $mapper['meta_key'] === $key; }, ARRAY_FILTER_USE_KEY ); if ( ! $copies ) { $copies[ $mapper['meta_key'] ] = array(); } $temp_data = array(); foreach ( $copies as $slug => $copy ) { // meta_key based. $meta_value = $entry->get_meta( $slug, '' ); if ( ! isset( $mapper['sub_metas'] ) ) { if ( 'rating' === $mapper['type'] ) { $meta_value = preg_replace_callback( '/(\d+)\/(\d+)/', function ( $matches ) { return sprintf( / Translators: 1. Rating value, 2. Maximum rating / esc_html__( ' %1$d out of %2$d', 'forminator' ), $matches[1], $matches[2] ); }, $meta_value ); } $temp_data[ $mapper['type'] ][] = Forminator_Form_Entry_Model::meta_value_to_string( $mapper['type'], $meta_value ); } else { // sub_metas available. foreach ( $mapper['sub_metas'] as $sub_meta ) { $sub_key = $sub_meta['key']; if ( ! empty( $meta_value[ $sub_key ] ) ) { $value = $meta_value[ $sub_key ]; $field_type = $mapper['type'] . '.' . $sub_key; $temp_data[ $sub_key ][] = Forminator_Form_Entry_Model::meta_value_to_string( $field_type, $value ); } else { $temp_data[ $sub_key ][] = ''; } } } } foreach ( $temp_data as $t_data ) { $data[] = implode( ' / ', $t_data ); } return $data; } /* * Prepare mail attachment * * @since 1.0 * @since 1.5.4 add `$last_entry_id` to calculate new entries count * * @param int $form_id Form id. * @param string $type Form type. * @param string $email Email. * @param int $last_entry_id Entry Id. * * @return Forminator_Export_Result\|boolean / private function prepare_attachment( $form_id, $type, $email, $last_entry_id = 0 ) { $export_result = $this->prepare_export_data( $form_id, $type, $last_entry_id ); if ( ! $export_result instanceof Forminator_Export_Result ) { return false; } $model = $export_result->model; $data = $export_result->data; $upload_dirs = wp_upload_dir(); // temp write to uploads. $tmp_path = $upload_dirs['basedir'] . '/forminator/'; require_once ABSPATH . 'wp-admin/includes/file.php'; /* * WP_Filesystem_Base * * @var WP_Filesystem_Base $wp_filesystem / global $wp_filesystem; WP_Filesystem(); if ( ! $wp_filesystem->is_dir( $tmp_path ) ) { $wp_filesystem->mkdir( $tmp_path ); } $filename = sanitize_title( $model->name ) . '-' . gmdate( 'ymdHis' ) . '.csv'; $tmp_path = $tmp_path . $filename; $mode = defined( 'FS_CHMOD_FILE' ) ? FS_CHMOD_FILE : false; if ( ! $wp_filesystem->put_contents( $tmp_path, $this->csvstr( $data ), $mode ) ) { if ( is_wp_error( $wp_filesystem->errors ) ) { forminator_maybe_log( __METHOD__, $wp_filesystem->errors->get_error_message() ); } return false; } $export_result->file_path = $tmp_path; return $export_result; } /* * CSVString * * @param mixed $fields Fields. * @return bool\|string / private function csvstr( $fields ) { if ( ! is_array( $fields ) ) { return false; } $output = array(); foreach ( $fields as $value ) { $f = fopen( 'php://memory', 'r+' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fopen -- fputcsv() works with file pointers and the WordPress filesystem API does not directly support working with file pointers. $value = self::get_formatted_csv_fields( $value ); $put = fputcsv( $f, $value, ',', '"', '\\' ); if ( false === $put ) { return false; } rewind( $f ); $csv_line = stream_get_contents( $f ); $output[] = rtrim( $csv_line ); } // prepend BOM Character for excel compatible. return chr( 239 ) . chr( 187 ) . chr( 191 ) . implode( PHP_EOL, $output ); } /* * Get monthly export date * * @param string $last_sent Last sent. * @param mixed $settings Settings. * @return string / private function get_monthly_export_date( $last_sent, $settings ) { $month_date = isset( $settings['month_day'] ) ? $settings['month_day'] : 1; $hour = isset( $settings['hour'] ) ? $settings['hour'] : '00:00'; // Maybe $month_date will be in the future this month. $next_sent = strtotime( gmdate( "Y-m-{$month_date} {$hour}", $last_sent ) ); if ( $last_sent >= $next_sent ) { // If not - next month. $next_sent = strtotime( '+1 month', $next_sent ); while ( gmdate( 'm', $next_sent ) > gmdate( 'm', $last_sent ) + 1 ) { // remove 1 day if 31, 30, 29 day doesn't exist in this month. $next_sent = strtotime( '-1 day', $next_sent ); } } return gmdate( 'Y-m-d H:i:s', $next_sent ); } /* * Get data mappers for retrieving entries meta * * @example { * [ * 'meta_key' => 'FIELD_ID', * 'label' => 'LABEL', * 'type' => 'TYPE', * 'sub_metas' => [ * [ * 'key' => 'SUFFIX', * 'label' => 'LABEL', * ] * ], * ]... * } * * @since 1.0.5 * * @param Forminator_Form_Model\|Forminator_Base_Form_Model $model Form model. * * @return array / private function get_custom_form_export_mappers( $model ) { /* * Forminator_Form_Model * * @var Forminator_Form_Model $model / $fields = $model->get_grouped_real_fields(); $field_mappers = self::get_mappers( $fields, $model ); $mappers = array_merge( array( array( // read form model's property. 'property' => 'time_created', // must be on export. 'label' => esc_html__( 'Submission Time', 'forminator' ), 'type' => 'entry_time_created', ), ), $field_mappers ); /* * Filter column mappers to be used on export custom form * * @since 1.6.3 * * @param array $mappers * @param int $form_id * @param Forminator_Form_Model $model * * @return array / $mappers = apply_filters( 'forminator_custom_form_export_mappers', $mappers, $model->id, $model ); return $mappers; } /* * Get mappers * * @param array $fields Fields array. * @param object $model Model object. * @param null\|object $group_field Group field. * @return array / private static function get_mappers( $fields, $model, $group_field = null ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput -- Sanitized in Forminator_Core::sanitize_array. $visible_fields = isset( $_GET['field'] ) ? Forminator_Core::sanitize_array( $_GET['field'] ) : array(); $mappers = array(); foreach ( $fields as $field ) { $field_type = $field->__get( 'type' ); if ( ! empty( $visible_fields ) ) { if ( ! in_array( $field->slug, $visible_fields, true ) ) { continue; } } // base mapper for every field. $mapper = array(); $mapper['meta_key'] = $field->slug; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- false positive. $mapper['label'] = $field->get_label_for_entry(); $mapper['type'] = $field_type; if ( $group_field ) { $mapper['label'] = $group_field->get_label_for_entry() . ' - ' . $mapper['label']; } // fields that should be displayed as multi column (sub_metas). if ( 'name' === $field_type ) { $is_multiple_name = filter_var( $field->__get( 'multiple_name' ), FILTER_VALIDATE_BOOLEAN ); if ( $is_multiple_name ) { $prefix_enabled = filter_var( $field->__get( 'prefix' ), FILTER_VALIDATE_BOOLEAN ); $first_name_enabled = filter_var( $field->__get( 'fname' ), FILTER_VALIDATE_BOOLEAN ); $middle_name_enabled = filter_var( $field->__get( 'mname' ), FILTER_VALIDATE_BOOLEAN ); $last_name_enabled = filter_var( $field->__get( 'lname' ), FILTER_VALIDATE_BOOLEAN ); // at least one sub field enabled. if ( $prefix_enabled \|\| $first_name_enabled \|\| $middle_name_enabled \|\| $last_name_enabled ) { // sub metas. $mapper['sub_metas'] = array(); if ( $prefix_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'prefix' ); $label = $field->__get( 'prefix_label' ); $mapper['sub_metas'][] = array( 'key' => 'prefix', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $first_name_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'first-name' ); $label = $field->__get( 'fname_label' ); $mapper['sub_metas'][] = array( 'key' => 'first-name', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $middle_name_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'middle-name' ); $label = $field->__get( 'mname_label' ); $mapper['sub_metas'][] = array( 'key' => 'middle-name', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $last_name_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'last-name' ); $label = $field->__get( 'lname_label' ); $mapper['sub_metas'][] = array( 'key' => 'last-name', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } } else { // if no subfield enabled when multiple name remove mapper (means dont show it on export). $mapper = array(); } } } elseif ( 'address' === $field_type ) { $street_enabled = filter_var( $field->__get( 'street_address' ), FILTER_VALIDATE_BOOLEAN ); $line_enabled = filter_var( $field->__get( 'address_line' ), FILTER_VALIDATE_BOOLEAN ); $city_enabled = filter_var( $field->__get( 'address_city' ), FILTER_VALIDATE_BOOLEAN ); $state_enabled = filter_var( $field->__get( 'address_state' ), FILTER_VALIDATE_BOOLEAN ); $zip_enabled = filter_var( $field->__get( 'address_zip' ), FILTER_VALIDATE_BOOLEAN ); $country_enabled = filter_var( $field->__get( 'address_country' ), FILTER_VALIDATE_BOOLEAN ); if ( $street_enabled \|\| $line_enabled \|\| $city_enabled \|\| $state_enabled \|\| $zip_enabled \|\| $country_enabled ) { $mapper['sub_metas'] = array(); if ( $street_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'street_address' ); $label = $field->__get( 'street_address_label' ); $mapper['sub_metas'][] = array( 'key' => 'street_address', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $line_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'address_line' ); $label = $field->__get( 'address_line_label' ); $mapper['sub_metas'][] = array( 'key' => 'address_line', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $city_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'city' ); $label = $field->__get( 'address_city_label' ); $mapper['sub_metas'][] = array( 'key' => 'city', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $state_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'state' ); $label = $field->__get( 'address_state_label' ); $mapper['sub_metas'][] = array( 'key' => 'state', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $zip_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'zip' ); $label = $field->__get( 'address_zip_label' ); $mapper['sub_metas'][] = array( 'key' => 'zip', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } if ( $country_enabled ) { $default_label = Forminator_Form_Entry_Model::translate_suffix( 'country' ); $label = $field->__get( 'address_country_label' ); $mapper['sub_metas'][] = array( 'key' => 'country', 'label' => $mapper['label'] . ' - ' . ( $label ? $label : $default_label ), ); } } else { // if no subfield enabled when multiple name remove mapper (means dont show it on export). $mapper = array(); } } elseif ( 'stripe' === $field_type \|\| 'stripe-ocs' === $field_type \|\| 'paypal' === $field_type ) { $mapper['sub_metas'] = array(); $mapper['sub_metas'][] = array( 'key' => 'mode', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Mode', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'product_name', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Product / Plan Name', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'payment_type', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Payment type', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'amount', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Amount', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'currency', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Currency', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'quantity', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Quantity', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'transaction_id', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Transaction ID', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'status', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Status', 'forminator' ), ); $mapper['sub_metas'][] = array( 'key' => 'subscription_id', 'label' => $mapper['label'] . ' - ' . esc_html__( 'Manage', 'forminator' ), ); } elseif ( 'group' === $field_type ) { $group_fields = $model->get_grouped_real_fields( $field->slug ); $group_mappers = self::get_mappers( $group_fields, $model, $field ); $mappers = array_merge( $mappers, $group_mappers ); continue; } if ( ! empty( $mapper ) ) { $mappers[] = $mapper; } } return $mappers; } /* * Additional Column on Title(first) Row of Export data from Addon [Form] * * @see Forminator_Integration_Form_Hooks::on_export_render_title_row() * * @since 1.1 * @since 1.5.3 add $entries param to find addons that probably is/was connected * @since 1.6.1 rename to attach_form_addons_on_export_render_title_row * * @param int $form_id Form Id. * @param Forminator_Form_Entry_Model[] $entries Form entry model. * * @return array / private function attach_form_addons_on_export_render_title_row( $form_id, $entries = array() ) { $additional_headers = array(); // find all registered addons, so history can be shown even for deactivated addons. $registered_addons = $this->get_form_registered_addons( $form_id, $entries ); foreach ( $registered_addons as $registered_addon ) { try { $form_hooks = $registered_addon->get_addon_hooks( $form_id, 'form' ); $addon_headers = $form_hooks->on_export_render_title_row(); $addon_headers = $this->format_addon_additional_headers( $registered_addon, $addon_headers ); $additional_headers = array_merge( $additional_headers, $addon_headers ); } catch ( Exception $e ) { forminator_addon_maybe_log( $registered_addon->get_slug(), 'failed to on_export_render_title_row', $e->getMessage() ); } } return $additional_headers; } /* * Format additional header given by addon * Format used is `forminator_addon_export_title_{$addon_slug}_{$title_id_data_from_addon}` * * @since 1.1 * * @param Forminator_Integration $addon Forminator Integration. * @param array $addon_headers Addon headers. * * @return array / private function format_addon_additional_headers( Forminator_Integration $addon, $addon_headers ) { $formatted_headers = array(); if ( ! is_array( $addon_headers ) \|\| empty( $addon_headers ) ) { return $formatted_headers; } foreach ( $addon_headers as $title_id => $title ) { if ( ! is_scalar( $title ) \|\| empty( $title ) ) { continue; // skip on empty title. } // avoid collistion with other addon ids. $title_id = 'forminator_addon_export_title_' . $addon->get_slug() . '_' . $title_id; $formatted_headers[ $title_id ] = $title; } return $formatted_headers; } /* * Add addons export render entry row [Form] * * @see Forminator_Integration_Form_Hooks::on_export_render_entry() * @since 1.1 * @since 1.6.1 rename to attach_form_addons_on_export_render_entry_row * * @param int $form_id Form Id. * @param Forminator_Form_Entry_Model $entry_model Form entry Model. * * @return array / private function attach_form_addons_on_export_render_entry_row( $form_id, Forminator_Form_Entry_Model $entry_model ) { $additional_data = array(); // find all registered addons, so history can be shown even for deactivated addons. $registered_addons = $this->get_form_registered_addons( $form_id ); foreach ( $registered_addons as $registered_addon ) { try { $form_hooks = $registered_addon->get_addon_hooks( $form_id, 'form' ); $meta_data = forminator_find_addon_meta_data_from_entry_model( $registered_addon, $entry_model ); $addon_data = $form_hooks->on_export_render_entry( $entry_model, $meta_data ); $addon_data = $this->format_addon_additional_data( $registered_addon, $addon_data ); $additional_data = array_merge( $additional_data, $addon_data ); } catch ( Exception $e ) { forminator_addon_maybe_log( $registered_addon->get_slug(), 'failed to on_export_render_entry', $e->getMessage() ); } } return $additional_data; } /* * Format addional data form addons to match requirement of export * Format used is `forminator_addon_export_title_{$addon_slug}_{$title_id_data_from_addon}` * * @since 1.1 * * @param Forminator_Integration $addon Forminator Integration. * @param array $addon_data Addon data. * * @return array / private function format_addon_additional_data( Forminator_Integration $addon, $addon_data ) { $formatted_data = array(); if ( ! is_array( $addon_data ) \|\| empty( $addon_data ) ) { return $formatted_data; } foreach ( $addon_data as $title_id => $value ) { $value = Forminator_Form_Entry_Model::meta_value_to_string( 'addon_' . $addon->get_slug(), $value ); // avoid collistion with other addon ids. $title_id = 'forminator_addon_export_title_' . $addon->get_slug() . '_' . $title_id; $formatted_data[ $title_id ] = $value; } return $formatted_data; } /* * Get Globally Registered Addons for form_id, avoid overhead for checking registerd addons many times [Form] * * @since 1.5.3 * @since 1.6.1 rename to get_form_registered_addons * * @param int $form_id Form Id. * @param Forminator_Form_Entry_Model[] $entries Form entry model. * * @return array\|Forminator_Integration[] / public function get_form_registered_addons( $form_id, $entries = array() ) { if ( empty( self::$form_registered_addons ) ) { self::$form_registered_addons = array(); $registered_addons = forminator_get_registered_addons(); foreach ( $entries as $entry ) { // find registered addon by slug pattern. $entry_addon_slugs = forminator_find_addon_slugs_from_entry_model( $entry ); foreach ( $entry_addon_slugs as $entry_addon_slug ) { // check if this slug globally registered. if ( in_array( $entry_addon_slug, array_keys( $registered_addons ), true ) ) { // check if already in static $registered_addons. if ( ! in_array( $entry_addon_slug, array_keys( self::$form_registered_addons ), true ) ) { $addon = forminator_get_addon( $entry_addon_slug ); if ( $addon instanceof Forminator_Integration ) { try { $form_hooks = $addon->get_addon_hooks( $form_id, 'form' ); if ( $form_hooks instanceof Forminator_Integration_Form_Hooks ) { self::$form_registered_addons[ $addon->get_slug() ] = $addon; } } catch ( Exception $e ) { forminator_addon_maybe_log( $addon->get_slug(), 'failed to get_addon_hooks one export', $e->getMessage() ); } } } } } } } return self::$form_registered_addons; } /* * Get Entries Export Schedule * * Basic checking for export schedule * * @since 1.1 * @since 1.5.4 add $schedule_key param * * @param null\|string $schedule_key Schedule key. * * @return array / public function get_entries_export_schedule( $schedule_key = null ) { $opt = get_option( 'forminator_entries_export_schedule', array() ); $validated_opt = $opt; foreach ( $validated_opt as $key => $value ) { if ( ! $value['form_id'] \|\| ! $value['form_type'] ) { // unschedule no form id exist. unset( $validated_opt[ $key ] ); } } if ( $validated_opt !== $opt ) { update_option( 'forminator_entries_export_schedule', $validated_opt ); } if ( ! empty( $schedule_key ) ) { if ( isset( $validated_opt[ $schedule_key ] ) && is_array( $validated_opt[ $schedule_key ] ) ) { return $validated_opt[ $schedule_key ]; } return array(); } return $validated_opt; } /* * Get email headers * * @since 1.5.4 * * @param string $email Email. * @param Forminator_Export_Result[] $export_results Export results. * * @return array / public function get_mail_headers( $email = '', $export_results = array() ) { $from_address = get_global_sender_email_address(); $from_name = get_global_sender_name(); $mail_headers = array( 'From: ' . $from_name . ' <' . $from_address . '>', 'Content-Type: text/html; charset=UTF-8', ); /* * Filter header for export mails * * @since 1.5.4 * * @param array $mail_headers Mail headers. * @param string $email email address which export mail will be sent. * @param Forminator_Export_Result[] $export_results export results @see Forminator_Export_Result. / $mail_headers = apply_filters( 'forminator_export_email_headers', $mail_headers, $email, $export_results ); return $mail_headers; } /* * Get compiled mail subject for scheduled export * * @since 1.5.4 * * @param Forminator_Export_Result[] $export_results Export result. * * @return string / public function get_mail_subject( $export_results ) { $form_names = array(); foreach ( $export_results as $export_result ) { if ( isset( $export_result->model->settings['formName'] ) ) { $form_names[] = $export_result->model->settings['formName']; } else { $form_names[] = $export_result->model->name; } } / translators: %s is form name. / $subject = sprintf( esc_html__( 'Submissions data for %s', 'forminator' ), implode( ', ', $form_names ) ); /* * Filter mail subject used for scheduled export email * * @since 1.5.4 * * @param string $subject Subject. * @param array $form_names Form names. * @param Forminator_Export_Result[] $export_results Export results @see Forminator_Export_Result. * * @return string / $subject = apply_filters( 'forminator_export_email_subject', $subject, $form_names, $export_results ); return $subject; } /* * Get compiled mail content for scheduled export * * @since 1.5.4 * * @param Forminator_Export_Result[] $export_results Export result. * * @return string / public function get_mail_content( $export_results ) { $submissions_link_format = admin_url( 'admin.php?page=forminator-entries&form_type=%1$s&form_id=%2$d' ); $entries_counts = array(); $new_entries_counts = array(); $form_names = array(); $submission_links = array(); foreach ( $export_results as $export_result ) { if ( isset( $export_result->model->settings['formName'] ) ) { $form_names[] = $export_result->model->settings['formName']; } else { $form_names[] = $export_result->model->name; } $entries_counts[] = $export_result->entries_count; $new_entries_counts[] = $export_result->new_entries_count; $form_type = 'forminator_forms'; switch ( $export_result->form_type ) { case 'cform': $form_type = 'forminator_forms'; break; case 'poll': $form_type = 'forminator_polls'; break; case 'quiz': $form_type = 'forminator_quizzes'; break; default: break; } $submission_links[] = sprintf( $submissions_link_format, $form_type, (int) $export_result->model->id ); } $blog_name = get_option( 'blogname' ); $total_entries = array_sum( $entries_counts ); $total_new_entries = array_sum( $new_entries_counts ); / translators: %s is Blog name. / $mail_content = '<p>' . sprintf( esc_html__( 'Hi %s,', 'forminator' ), $blog_name ) . '</p>' . PHP_EOL; $mail_content .= '<p>' . sprintf( / translators: 1$s is total new submission(s), %2$s is total submissions. / esc_html__( 'Your scheduled exports have arrived! Forminator has captured %1$s new submission(s) and packaged %2$s total submissions from %3$s since the last scheduled export sent.', 'forminator' ), '<strong>' . (int) $total_new_entries . '</strong>', '<strong>' . (int) $total_entries . '</strong>', implode( ', ', $form_names ) ) . '</p>' . PHP_EOL; $mail_content .= '<ul>' . PHP_EOL; foreach ( $submission_links as $key => $submission_link ) { $mail_content .= sprintf( '<li><strong>%1$s</strong>: <ul> <li>%2$s : %3$d</li> <li>%4$s : %5$d</li> <li><a href="%6$s">%7$s</a></li> </ul> </li>', $form_names[ $key ], esc_html__( 'New Submissions', 'forminator' ), (int) $new_entries_counts[ $key ], esc_html__( 'Total Submissions', 'forminator' ), (int) $entries_counts[ $key ], $submission_links[ $key ], esc_html__( 'View Submissions', 'forminator' ) ) . PHP_EOL; } $mail_content .= '</ul>' . PHP_EOL; $mail_content .= '<p>' . esc_html__( 'Cheers,', 'forminator' ) . '</p>' . PHP_EOL; $mail_content .= '<p>' . esc_html__( 'Forminator', 'forminator' ) . '</p>'; /* * Filter mail content used for scheduled export email * * @since 1.5.4 * * @param string $mail_content html formatted mail content. * @param array $form_names form names. * @param Forminator_Export_Result[] $export_results Export results @see Forminator_Export_Result. * * @return string / $mail_content = apply_filters( 'forminator_export_email_content', $mail_content, $form_names, $export_results ); return $mail_content; } /* * Escape a string to be used in a CSV context * * Taken from WooCommerce CSV Exporter * * @see https://github.com/woocommerce/woocommerce/blob/master/includes/export/abstract-wc-csv-exporter.php * * @since 1.6 * * Malicious input can inject formulas into CSV files, opening up the possibility * for phishing attacks and disclosure of sensitive information. * * Additionally, Excel exposes the ability to launch arbitrary commands through * the DDE protocol. * * @see http://www.contextis.com/resources/blog/comma-separated-vulnerabilities/ * @see https://hackerone.com/reports/72785 * * @since 3.1.0 * * @param string $data CSV field to escape. * * @return string / public static function escape_csv_data( $data ) { $active_content_triggers = array( '=', '+', '-', '@' ); if ( in_array( mb_substr( $data, 0, 1 ), $active_content_triggers, true ) ) { $data = "'" . $data . "'"; } return $data; } /* * Format csv fields * * @since 1.6 * * @param mixed $fields Fields. * * @return array\|string / public static function get_formatted_csv_fields( $fields ) { if ( empty( $fields ) \|\| ! is_array( $fields ) ) { return $fields; } $formatted_fields = array(); foreach ( $fields as $field ) { if ( ! is_scalar( $field ) ) { $formatted_fields[] = ''; continue; } if ( is_scalar( $field ) ) { $formatted_fields[] = self::escape_csv_data( $field ); } } return $formatted_fields; } /* * Get Globally Registered Addons for form_id, avoid overhead for checking registered addons many times [Poll] * * @since 1.6.1 * * @param int $poll_id Poll Id. * @param Forminator_Form_Entry_Model[] $entries Entries. * * @return array\|Forminator_Integration[] / public function get_poll_registered_addons( $poll_id, $entries = array() ) { if ( empty( self::$poll_registered_addons ) ) { self::$poll_registered_addons = array(); $registered_addons = forminator_get_registered_addons(); foreach ( $entries as $entry ) { // find registered addon by slug pattern. $entry_addon_slugs = forminator_find_addon_slugs_from_entry_model( $entry ); foreach ( $entry_addon_slugs as $entry_addon_slug ) { // check if this slug globally registered. if ( in_array( $entry_addon_slug, array_keys( $registered_addons ), true ) ) { // check if already in static $registered_addons. if ( ! in_array( $entry_addon_slug, array_keys( self::$poll_registered_addons ), true ) ) { $addon = forminator_get_addon( $entry_addon_slug ); if ( $addon instanceof Forminator_Integration ) { try { $poll_hooks = $addon->get_addon_hooks( $poll_id, 'poll' ); if ( $poll_hooks instanceof Forminator_Integration_Poll_Hooks ) { self::$poll_registered_addons[ $addon->get_slug() ] = $addon; } } catch ( Exception $e ) { forminator_addon_maybe_log( $addon->get_slug(), 'failed to get_addon_hooks on export', $e->getMessage() ); } } } } } } } return self::$poll_registered_addons; } /* * Additional Column on Title(first) Row of Export data from Addon [Poll] * * @see Forminator_Integration_Poll_Hooks::on_export_render_title_row() * * @since 1.6.1 * * @param int $poll_id Poll Id. * @param Forminator_Form_Entry_Model[] $entries Entries. * * @return array / private function attach_poll_addons_on_export_render_title_row( $poll_id, $entries = array() ) { $additional_headers = array(); // find all registered addons, so history can be shown even for deactivated addons. $registered_addons = $this->get_poll_registered_addons( $poll_id, $entries ); foreach ( $registered_addons as $registered_addon ) { try { $poll_hooks = $registered_addon->get_addon_hooks( $poll_id, 'poll' ); $addon_headers = $poll_hooks->on_export_render_title_row(); $addon_headers = $this->format_addon_additional_headers( $registered_addon, $addon_headers ); $additional_headers = array_merge( $additional_headers, $addon_headers ); } catch ( Exception $e ) { forminator_addon_maybe_log( $registered_addon->get_slug(), 'failed to attach_poll_addons_on_export_render_title_row', $e->getMessage() ); } } return $additional_headers; } /* * Add addons export render entry row [Poll] * * @see Forminator_Integration_Poll_Hooks::on_export_render_entry() * @since 1.6.1 * * @param int $form_id Form Id. * @param Forminator_Form_Entry_Model $entry_model Form entry model. * * @return array / private function attach_poll_addons_on_export_render_entry_row( $form_id, Forminator_Form_Entry_Model $entry_model ) { $additional_data = array(); // find all registered addons, so history can be shown even for deactivated addons. $registered_addons = $this->get_poll_registered_addons( $form_id ); foreach ( $registered_addons as $registered_addon ) { try { $poll_hooks = $registered_addon->get_addon_hooks( $form_id, 'poll' ); $meta_data = forminator_find_addon_meta_data_from_entry_model( $registered_addon, $entry_model ); $addon_data = $poll_hooks->on_export_render_entry( $entry_model, $meta_data ); $addon_data = $this->format_addon_additional_data( $registered_addon, $addon_data ); $additional_data = array_merge( $additional_data, $addon_data ); } catch ( Exception $e ) { forminator_addon_maybe_log( $registered_addon->get_slug(), 'failed to attach_poll_addons_on_export_render_entry_row', $e->getMessage() ); } } return $additional_data; } /* * Get Globally Registered Addons for form_id, avoid overhead for checking registered addons many times [Quiz] * * @since 1.6.2 * * @param int $quiz_id Quiz Id. * @param Forminator_Form_Entry_Model[] $entries Form entry model. * * @return array\|Forminator_Integration[] / public function get_quiz_registered_addons( $quiz_id, $entries = array() ) { if ( empty( self::$quiz_registered_addons ) ) { self::$quiz_registered_addons = array(); $registered_addons = forminator_get_registered_addons(); foreach ( $entries as $entry ) { // find registered addon by slug pattern. $entry_addon_slugs = forminator_find_addon_slugs_from_entry_model( $entry ); foreach ( $entry_addon_slugs as $entry_addon_slug ) { // check if this slug globally registered. if ( in_array( $entry_addon_slug, array_keys( $registered_addons ), true ) ) { // check if already in static $registered_addons. if ( ! in_array( $entry_addon_slug, array_keys( self::$quiz_registered_addons ), true ) ) { $addon = forminator_get_addon( $entry_addon_slug ); if ( $addon instanceof Forminator_Integration ) { try { $quiz_hooks = $addon->get_addon_hooks( $quiz_id, 'quiz' ); if ( $quiz_hooks instanceof Forminator_Integration_Quiz_Hooks ) { self::$quiz_registered_addons[ $addon->get_slug() ] = $addon; } } catch ( Exception $e ) { forminator_addon_maybe_log( $addon->get_slug(), 'failed to get_addon_hooks on export', $e->getMessage() ); } } } } } } } return self::$quiz_registered_addons; } /* * Additional Column on Title(first) Row of Export data from Addon [Quiz] * * @see Forminator_Integration_Quiz_Hooks::on_export_render_title_row() * * @since 1.6.2 * * @param int $quiz_id Quiz Id. * @param Forminator_Form_Entry_Model[] $entries Entries. * * @return array / private function attach_quiz_addons_on_export_render_title_row( $quiz_id, $entries = array() ) { $additional_headers = array(); // find all registered addons, so history can be shown even for deactivated addons. $registered_addons = $this->get_quiz_registered_addons( $quiz_id, $entries ); foreach ( $registered_addons as $registered_addon ) { try { $quiz_hooks = $registered_addon->get_addon_hooks( $quiz_id, 'quiz' ); $addon_headers = $quiz_hooks->on_export_render_title_row(); $addon_headers = $this->format_addon_additional_headers( $registered_addon, $addon_headers ); $additional_headers = array_merge( $additional_headers, $addon_headers ); } catch ( Exception $e ) { forminator_addon_maybe_log( $registered_addon->get_slug(), 'failed to attach_quiz_addons_on_export_render_title_row', $e->getMessage() ); } } return $additional_headers; } /* * Add addons export render entry row [Quiz] * * @see Forminator_Integration_Quiz_Hooks::on_export_render_entry() * @since 1.6.2 * * @param int $form_id Form Id. * @param Forminator_Form_Entry_Model $entry_model Form entry model. * * @return array / private function attach_quiz_addons_on_export_render_entry_row( $form_id, Forminator_Form_Entry_Model $entry_model ) { $additional_data = array(); // find all registered addons, so history can be shown even for deactivated addons. $registered_addons = $this->get_quiz_registered_addons( $form_id ); foreach ( $registered_addons as $registered_addon ) { try { $quiz_hooks = $registered_addon->get_addon_hooks( $form_id, 'quiz' ); $meta_data = forminator_find_addon_meta_data_from_entry_model( $registered_addon, $entry_model ); $addon_data = $quiz_hooks->on_export_render_entry( $entry_model, $meta_data ); $addon_data = $this->format_addon_additional_data( $registered_addon, $addon_data ); $additional_data = array_merge( $additional_data, $addon_data ); } catch ( Exception $e ) { forminator_addon_maybe_log( $registered_addon->get_slug(), 'failed to attach_quiz_addons_on_export_render_entry_row', $e->getMessage() ); } } return $additional_data; } /* * Get mapper data * * @param array $mappers Mappers. * @param string $entry Entry. * * @return array */ public function get_mapper_export_data( $mappers, $entry ) { $data = array(); if ( ! empty( $mappers ) ) { // traverse from fields to be correctly mapped with updated form fields. foreach ( $mappers as $mapper ) { if ( 'entry_time_created' === $mapper['type'] ) { continue; } // its from model's property. if ( isset( $mapper['property'] ) ) { if ( property_exists( $entry, $mapper['property'] ) ) { $property = $mapper['property']; // casting property to string. $data[] = (string) $entry->$property; } else { $data[] = ''; } } else { // meta_key based. $meta_value = $entry->get_meta( $mapper['meta_key'], '' ); if ( ! isset( $mapper['sub_metas'] ) ) { $data[ $mapper['meta_key'] ] = Forminator_Form_Entry_Model::meta_value_to_string( $mapper['type'], $meta_value ); } else { // sub_metas available. foreach ( $mapper['sub_metas'] as $sub_meta ) { $sub_key = $sub_meta['key']; if ( isset( $meta_value[ $sub_key ] ) && ! empty( $meta_value[ $sub_key ] ) ) { $value = $meta_value[ $sub_key ]; $field_type = $mapper['type'] . '.' . $sub_key; $data[ $sub_key ] = Forminator_Form_Entry_Model::meta_value_to_string( $field_type, $value ); } else { $data[ $sub_key ] = ''; } } } } } } return $data; } }	60.95 KB	2026-01-12 18:46
📄 class-form-fields.php <?php /** * Forminator Fields * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Fields * * @since 1.0 / class Forminator_Fields { /* * Store fields objects * * @var array / public $fields = array(); /* * Forminator_Fields constructor. * * @since 1.0 / public function __construct() { $this->load_forminator_autofill_providers(); $this->maybe_load_external_autofill_providers(); $loader = new Forminator_Loader(); $fields = $loader->load_files( 'library/fields', array( 'stripe.php' => array( 'php' => '5.6.0', ), ) ); /* * Filters the form fields / $this->fields = apply_filters( 'forminator_fields', $fields ); add_action( 'init', array( &$this, 'schedule_forminator_daily_cron' ) ); add_action( 'forminator_daily_cron', array( &$this, 'cron_init' ) ); add_action( 'forminator_update_version', array( &$this, 'upgrade_actions' ), 10, 2 ); } /* * Retrieve fields objects * * @since 1.0 * @return array / public function get_fields() { return $this->fields; } /* * Load autofill providers requirements * * @since 1.0.5 / public function load_forminator_autofill_providers() { include_once forminator_plugin_dir() . 'library/class-autofill-loader.php'; $required_files = array( // load contracts. forminator_plugin_dir() . 'library/field-autofill-providers/contracts/class-autofill-provider-interface.php', forminator_plugin_dir() . 'library/field-autofill-providers/contracts/class-autofill-provider-abstract.php', // load Forminator provider autoload. forminator_plugin_dir() . 'library/field-autofill-providers/autoload.php', ); $required_files_exists = true; foreach ( $required_files as $required_file ) { if ( ! file_exists( $required_file ) ) { $required_files_exists = false; break; } } if ( $required_files_exists ) { foreach ( $required_files as $required_file ) { / @noinspection PhpIncludeInspection / include_once $required_file; } } } /* * Load member's autofill provider * * @since 1.0.5 / public function maybe_load_external_autofill_providers() { // See samples/forminator-simple-autofill-plugin for example how to use it. do_action( 'forminator_register_autofill_provider' ); } /* * Set up the schedule delete file * * @since 1.13 * @since 1.27 Change from WP cron to Action Scheduler / public function schedule_forminator_daily_cron() { forminator_set_recurring_action( 'forminator_daily_cron', DAY_IN_SECONDS ); } /* * Forminator Cron * * @since 1.13 / public function cron_init() { $this->schedule_delete_temp_files(); } /* * Schedule delete temp file * * @since 1.13 / public function schedule_delete_temp_files() { $temp_path = forminator_upload_root_temp(); if ( is_wp_error( $temp_path ) ) { return; } $temp_path = $temp_path . '/'; $handle = @opendir( $temp_path ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged if ( $handle ) { // Check if the dir exist before opening it. if ( is_dir( $temp_path ) ) { $handle = opendir( $temp_path ); if ( $handle ) { while ( false !== ( $file = readdir( $handle ) ) ) { // phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition -- false positive if ( ! empty( $file ) && ! in_array( $file, array( '.', '..' ), true ) ) { $temp_file = $temp_path . $file; $file_time = filemtime( $temp_file ); if ( file_exists( $temp_file ) && ( time() - $file_time ) >= 60 60 * 12 ) { wp_delete_file( $temp_file ); } } } closedir( $handle ); } } } } /** * Upgrade actions / public function upgrade_actions() { if ( ! forminator_create_index_file_disabled() ) { $this->add_security_files(); } $this->delete_old_temp_dir(); } /* * Delete old temp dir * * @return void\|null / public function delete_old_temp_dir() { $dir = wp_upload_dir(); $temp_path = trailingslashit( $dir['basedir'] ) . 'forminator_temp'; if ( $dir['error'] \|\| ! is_dir( $temp_path ) ) { return null; } // Ensure the WP_Filesystem is initialized. if ( ! function_exists( 'wp_filesystem' ) ) { require_once ABSPATH . 'wp-admin/includes/file.php'; } WP_Filesystem(); // Global $wp_filesystem should be available now. global $wp_filesystem; // remove `css` folder. if ( $wp_filesystem->is_dir( $temp_path ) ) { $wp_filesystem->rmdir( $temp_path ); } } /* * Adds index files to the upload root for security. * * @return void */ public function add_security_files() { $upload_root = forminator_upload_root(); if ( is_wp_error( $upload_root ) \|\| ! is_dir( $upload_root ) ) { return; } Forminator_Field::check_upload_root_index_file(); if ( ! file_exists( $upload_root . 'css/index.php' ) ) { Forminator_Field::add_index_file( $upload_root . 'css/index.php' ); } if ( ! file_exists( $upload_root . 'signatures/index.php' ) ) { Forminator_Field::add_index_file( $upload_root . 'signatures/index.php' ); } } }	5.05 KB	2026-01-12 18:46
📄 class-forminator-hub-connector.php <?php /** * Forminator Hub Connector * * @package Forminator / /* * Class Forminator_Hub_Connector * Handles the functionality related to the Hub Connector module. / class Forminator_Hub_Connector { /* * The identifier for the Forminator plugin in the Hub. * * @const string / public const PLUGIN_IDENTIFIER = 'forminator'; /* * The action name used for the Hub connection. * * @const string / public const CONNECTION_ACTION = 'hub_connection'; /* * The instance of this class. * * @var Forminator_Hub_Connector\|null / private static $instance; /* * Forminator_Hub_Connector constructor. / private function __construct() { if ( forminator_cloud_templates_disabled() ) { return; } $this->init(); add_filter( 'forminator_data', array( __CLASS__, 'add_hub_connector_data' ) ); add_filter( 'wpmudev_hub_connector_localize_text_vars', array( __CLASS__, 'customize_text_vars' ), 10, 2 ); } /* * Get instance of this class * * @return Forminator_Hub_Connector / public static function get_instance(): Forminator_Hub_Connector { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Checks if Hub Connector is connected. If Dash plugin is not installed Hub connector can take over. * * @return bool / public static function hub_connector_connected(): bool { static $connected = null; if ( is_null( $connected ) ) { if ( class_exists( 'WPMUDEV_Dashboard' ) ) { $connected = self::get_dashboard_api()->has_key(); } elseif ( ! FORMINATOR_PRO ) { $connected = self::hub_connector_logged_in(); } else { $connected = false; // Pro version should use WPMUDEV Dashboard. } } return $connected; } /* * Returns WPMUDEV Dashboard API object * * @return \WPMUDEV_Dashboard_Api\|null / public static function get_dashboard_api(): ?\WPMUDEV_Dashboard_Api { if ( class_exists( 'WPMUDEV_Dashboard' ) && ! empty( \WPMUDEV_Dashboard::$api ) ) { return \WPMUDEV_Dashboard::$api; } return null; } /* * Checks if Hub Connector is logged in. * * @return bool / public static function hub_connector_logged_in(): bool { return ! forminator_cloud_templates_disabled() && \WPMUDEV\Hub\Connector\API::get()->is_logged_in(); } /* * Adds the Hub connector data to the Forminator data. * * @param array $data The Forminator data. * * @return array The Forminator data with the Hub connector data. / public static function add_hub_connector_data( array $data ): array { $data['isHubConnected'] = self::hub_connector_connected(); $data['hubConnectLogo'] = esc_attr( self::get_hub_connect_logo() ); $data['hubConnectTitle'] = esc_html( self::get_hub_connect_title() ); $data['hubConnectDescription'] = esc_html( self::get_hub_connect_description() ); $data['hubConnectUrl'] = esc_url( self::get_hub_connect_url() ); $data['hubConnectPresetTemplateUrl'] = esc_url( self::get_hub_connect_url( 'preset-template' ) ); $data['hubConnectButton'] = esc_html( self::get_hub_connect_cta_text() ); return $data; } /* * Modify text string vars. * * @param array $texts Vars. * @param string $plugin Plugin identifier. * * @return array / public static function customize_text_vars( $texts, $plugin ): array { if ( self::PLUGIN_IDENTIFIER === $plugin ) { $feature = filter_input( INPUT_GET, 'feature' ); if ( 'preset-template' === $feature ) { $feature_name = esc_html__( 'Preset Templates', 'forminator' ); } elseif ( 'extension-pack' === $feature ) { $feature_name = esc_html__( 'Extension Pack Add-on', 'forminator' ); } else { $feature_name = esc_html__( 'Cloud Templates', 'forminator' ); } $texts['create_account_desc'] = sprintf( / translators: 1. Opened tag. 2. Closed tag. 3. Opened tag. 4. Closed tag. / esc_html__( 'Create a free account to connect your site to WPMU DEV and activate %1$sForminator - %5$s%2$s. %3$sIt`s fast, seamless, and free%4$s.', 'forminator' ), '<strong>', '</strong>', '<i>', '</i>', $feature_name ); $texts['login_desc'] = sprintf( / translators: %s: Feature name. / esc_html__( 'Log in with your WPMU DEV account credentials to activate %s.', 'forminator' ), $feature_name ); } return $texts; } /* * Initialize the Hub Connector module and set its options. * * The `extra/hub-connector/connector.php` file is required, and the options are set for the Hub Connector module. * * @return void / public function init() { if ( class_exists( 'WPMUDEV\Hub\Connector' ) ) { $page = filter_input( INPUT_GET, 'page' ); $feature = filter_input( INPUT_GET, 'feature' ); $from = filter_input( INPUT_GET, 'from' ); $page_referral = filter_input( INPUT_GET, 'page_referral' ); if ( $page && false !== strpos( $page, 'forminator-cform-wizard' ) ) { $utm_campaign = 'forminator_form-builder-wizard_hub-connector_cloud-templates'; } elseif ( 'new-features-modal' === $from ) { $utm_campaign = 'forminator_upgrade_modal_hub-connector_preset-templates_connector'; } elseif ( $page && false !== strpos( $page, 'forminator-templates' ) ) { if ( 'wp-dashboard' === $page_referral ) { $utm_campaign = 'forminator_global-notice_hub-connector'; } elseif ( 'preset-template' === $feature ) { $utm_campaign = 'forminator_template-page_preset-templates_hub-connector'; } else { $utm_campaign = 'forminator_template-page_cloud-templates_hub-connector'; } } elseif ( 'preset-template' === $feature ) { $utm_campaign = 'forminator_form-builder_hub-connector_preset-templates_connector'; } elseif ( 'extension-pack' === $feature ) { switch ( $page_referral ) { case 'form_builder': $page_referral = 'forminator_form-builder_form-abandonment'; break; case 'forms_page': $page_referral = 'forminator_form-page_form-overview'; break; case 'report_page': $page_referral = 'forminator_form-report-page_report-overview'; break; case 'report_widget': $page_referral = 'forminator_form-report-page_form-abandonment-widget'; break; default: $page_referral = 'forminator_addons-page'; break; } $utm_campaign = $page_referral . '-free-addon_hub-connector'; } else { $utm_campaign = 'forminator_form-builder_hub-connector_cloud-templates_connector'; } $options = array( 'screens' => array( 'forminator_page_forminator-templates', 'forminator-pro_page_forminator-templates', 'forminator_page_forminator-addons', 'forminator-pro_page_forminator-addons', 'forminator_page_forminator-cform', 'forminator-pro_page_forminator-cform', 'forminator_page_forminator-cform-wizard', 'forminator-pro_page_forminator-cform-wizard', 'toplevel_page_forminator', ), 'extra_args' => array( 'register' => array( 'utm_medium' => 'plugin', 'utm_campaign' => $utm_campaign, 'utm_content' => 'hub-connector', 'utm_source' => self::PLUGIN_IDENTIFIER, ), ), ); \WPMUDEV\Hub\Connector::get()->set_options( self::PLUGIN_IDENTIFIER, $options ); } } /* * Check if WPMUDEV Dashboard is installed * * @return bool / public static function is_wpmudev_dashboard_installed(): bool { return self::get_dashboard_api() instanceof WPMUDEV_Dashboard_Api; } /* * Get Hub connect URL * * @param string $feature Feature name, default is 'cloud'. * @return string / public static function get_hub_connect_url( $feature = 'cloud' ): string { $page = filter_input( INPUT_GET, 'page' ); if ( empty( $page ) ) { $page = 'forminator-templates'; } if ( self::is_wpmudev_dashboard_installed() ) { return add_query_arg( array( 'page' => 'wpmudev', 'utm_source' => self::PLUGIN_IDENTIFIER, 'utm_medium' => 'plugin', 'utm_campaign' => $page, ), network_admin_url() ); } elseif ( FORMINATOR_PRO ) { return 'https://wpmudev.com/project/wpmu-dev-dashboard/'; } $args = array( 'page' => $page, 'feature' => $feature, ); if ( 'wp-dashboard-preset-template' === $feature ) { $args['feature'] = 'preset-template'; $args['page_referral'] = 'wp-dashboard'; } $tab = filter_input( INPUT_GET, 'tab' ); if ( $tab ) { $args['tab'] = $tab; } $id = filter_input( INPUT_GET, 'id' ); if ( $id ) { $args['id'] = $id; } $page_referral = filter_input( INPUT_GET, 'page_referral' ); if ( $page_referral ) { $args['page_referral'] = $page_referral; } $args['page_action'] = self::CONNECTION_ACTION; return add_query_arg( $args, admin_url( 'admin.php' ) ); } /* * Get Hub connect CTA text * * @return string / public static function get_hub_connect_cta_text(): string { if ( self::is_wpmudev_dashboard_installed() ) { return __( 'LOG IN TO WPMU DEV', 'forminator' ); } elseif ( FORMINATOR_PRO ) { return __( 'Install Plugin', 'forminator' ); } return __( 'Connect site', 'forminator' ); } /* * Get Hub connect title * * @return string / public static function get_hub_connect_title(): string { if ( FORMINATOR_PRO && ! self::is_wpmudev_dashboard_installed() ) { return __( 'Install WPMU DEV Dashboard', 'forminator' ); } return __( 'Save Forms as Templates', 'forminator' ); } /* * Get Hub connect description * * @return string / public static function get_hub_connect_description(): string { if ( FORMINATOR_PRO && ! self::is_wpmudev_dashboard_installed() ) { return __( 'You don\'t have the WPMU DEV Dashboard plugin, which you\'ll need to access Pro preset templates. Install and log in to the dashboard to unlock the complete list of preset templates.', 'forminator' ); } return __( 'Save your forms as templates in the Hub cloud to easily reuse them on any sites you manage via the Hub. Customize once and reuse on different sites with one click.', 'forminator' ); } /* * Get Hub connect logo * * @return string */ public static function get_hub_connect_logo(): string { if ( FORMINATOR_PRO && ! self::is_wpmudev_dashboard_installed() ) { return 'wpmudev-logo'; } return 'forminator-templates'; } }	10.18 KB	2026-01-12 18:46
📄 class-geo.php <?php /** * Forminator Geo * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Geo * * Handle geo-location data * * @since 1.0 / class Forminator_Geo { /* * Validates that the IP that made the request is from cloudflare * * @since 1.0 * @param string $ip - the ip to check. * * @return bool / private static function validate_cloudflare_ip( $ip ) { $cloudflare_ips = array( '199.27.128.0/21', '173.245.48.0/20', '103.21.244.0/22', '103.22.200.0/22', '103.31.4.0/22', '141.101.64.0/18', '108.162.192.0/18', '190.93.240.0/20', '188.114.96.0/20', '197.234.240.0/22', '198.41.128.0/17', '162.158.0.0/15', '104.16.0.0/12', ); $is_cf_ip = false; foreach ( $cloudflare_ips as $cloudflare_ip ) { if ( self::cloudflare_ip_in_range( $ip, $cloudflare_ip ) ) { $is_cf_ip = true; break; } } return $is_cf_ip; } /* * Check if the cloudflare IP is in range * * @since 1.0 * @param string $ip - the current IP. * @param string $range - the allowed range of cloudflare ips. * * @return bool / private static function cloudflare_ip_in_range( $ip, $range ) { if ( strpos( $range, '/' ) === false ) { $range .= '/32'; } // $range is in IP/CIDR format eg 127.0.0.1/24. list( $range, $netmask ) = explode( '/', $range, 2 ); $range_decimal = ip2long( $range ); $ip_decimal = ip2long( $ip ); $wildcard_decimal = pow( 2, ( 32 - $netmask ) ) - 1; $netmask_decimal = ~$wildcard_decimal; return ( ( $ip_decimal & $netmask_decimal ) === ( $range_decimal & $netmask_decimal ) ); } /* * Check if there are any cloudflare headers in the request * * @since 1.0 * @return bool / private static function cloudflare_requests_check() { $flag = true; if ( ! isset( $_SERVER['HTTP_CF_CONNECTING_IP'] ) ) { $flag = false; } if ( ! isset( $_SERVER['HTTP_CF_IPCOUNTRY'] ) ) { $flag = false; } if ( ! isset( $_SERVER['HTTP_CF_RAY'] ) ) { $flag = false; } if ( ! isset( $_SERVER['HTTP_CF_VISITOR'] ) ) { $flag = false; } return $flag; } /* * Check if the request is from cloudflare. If it is, we get the IP * * @since 1.0 * @return bool / private static function is_cloudflare() { $ip = ''; if ( isset( $_SERVER['HTTP_CLIENT_IP'] ) ) { $ip = sanitize_text_field( wp_unslash( $_SERVER['HTTP_CLIENT_IP'] ) ); } elseif ( isset( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) { $ip = sanitize_text_field( wp_unslash( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ); } elseif ( isset( $_SERVER['REMOTE_ADDR'] ) ) { $ip = sanitize_text_field( wp_unslash( $_SERVER['REMOTE_ADDR'] ) ); } if ( ! empty( $ip ) ) { $request_check = self::cloudflare_requests_check(); if ( ! $request_check ) { return false; } $ip_check = self::validate_cloudflare_ip( $ip ); return $ip_check; } return false; } /* * A shorhand function to get user IP * * @since 1.0 * @return mixed\|string */ public static function get_user_ip() { $client = isset( $_SERVER['HTTP_CLIENT_IP'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_CLIENT_IP'] ) ) : null; $forward = isset( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) : null; $is_cf = self::is_cloudflare(); // Check if request is from CloudFlare. if ( $is_cf ) { $cf_ip = isset( $_SERVER['HTTP_CF_CONNECTING_IP'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_CF_CONNECTING_IP'] ) ) : null; // We already make sure this is set in the checks. if ( filter_var( $cf_ip, FILTER_VALIDATE_IP ) ) { return apply_filters( 'forminator_user_ip', $cf_ip ); } } else { $remote = isset( $_SERVER['REMOTE_ADDR'] ) ? sanitize_text_field( wp_unslash( $_SERVER['REMOTE_ADDR'] ) ) : null; } $client_real = isset( $_SERVER['HTTP_X_REAL_IP'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_X_REAL_IP'] ) ) : null; $user_ip = $remote; if ( filter_var( $client, FILTER_VALIDATE_IP ) ) { $user_ip = $client; } elseif ( filter_var( $client_real, FILTER_VALIDATE_IP ) ) { $user_ip = $client_real; } elseif ( ! empty( $forward ) ) { $forward = explode( ',', $forward ); $ip = array_shift( $forward ); $ip = trim( $ip ); if ( filter_var( $ip, FILTER_VALIDATE_IP ) ) { $user_ip = $ip; } } return apply_filters( 'forminator_user_ip', $user_ip ); } }	4.38 KB	2026-01-12 18:46
📄 class-integration-loader.php <?php /** * Forminator Integration Loader * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } / @noinspection PhpIncludeInspection / require_once forminator_plugin_dir() . 'library/addon/class-integration-exception.php'; require_once forminator_plugin_dir() . 'library/addon/class-forminator-integration-settings-exception.php'; require_once forminator_plugin_dir() . 'library/addon/class-addon-container.php'; require_once forminator_plugin_dir() . 'library/addon/contracts/interface-integration.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-settings.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-form-settings.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-hooks.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-form-hooks.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-poll-settings.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-poll-hooks.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-quiz-settings.php'; require_once forminator_plugin_dir() . 'library/addon/class-integration-quiz-hooks.php'; require_once forminator_plugin_dir() . 'library/addon/admin/class-integration-admin-ajax.php'; /* * Class Forminator_Integration_Loader * Responsible for registering addon and hold its information throughout application * * @since 1.1 / class Forminator_Integration_Loader { /* * WP option name of activated addons * * @since 1.1 * @var string / private static $_active_addons_option = 'forminator_activated_addons'; /* * Forminator_Integration_Loader instance * * @since 1.1 * @var self / private static $instance = null; /* * Get instance of loader * * @since 1.1 * @return Forminator_Integration_Loader / public static function get_instance() { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Define pre_activated addons here * * @since 1.1 * @var array / private static $pre_activated_addons = array(); /* * Array Access-able of Registered Integrations * * @since 1.1 * @var Forminator_Addon_Container / private $addons; /* * Array of slug activated addons * * @since 1.1 * @var array / private $activated_addons = array(); /* * Default addon error messages * will be used when error happened and loader cant get addon error messages * * @since 1.1 * @var array / private $default_addon_error_messages = array(); /* * Last Error Message on loader * * @since 1.1 * @var string / private $last_error_message = ''; /* * Flag when options of `forminator_activated_addons` not exist on database * When its true, Loader will assume, user is first time updated to 1.1 * And will try to activate @see Forminator_Integration_Loader::$pre_activated_addons * * @since 1.1 * @var bool / private $is_non_exist_activated_option = false; /* * Flag when options of `forminator_activated_addons` exist but empty on database * When its true, Loader will assume, user is already have 1.1, * but no addons are currently activated * * @since 1.1 * @var bool / private $is_empty_activated_option = false; /* * Forminator_Integration_Loader constructor. * * @since 1.1 / public function __construct() { $this->addons = new Forminator_Addon_Container(); /* * Initiate activated addons / $active_addons = get_option( self::$_active_addons_option, false ); if ( false === $active_addons ) { $this->is_non_exist_activated_option = true; $active_addons = array(); } elseif ( empty( $active_addons ) ) { $active_addons = array(); $this->is_empty_activated_option = true; } $active_addons = array_unique( $active_addons ); $this->activated_addons = $active_addons; if ( in_array( 'zapier', $active_addons, true ) ) { add_action( 'forminator_addons_loaded', array( $this, 'update_zapier_to_webhook' ) ); } /* * Initiate standard default error messages / $this->default_addon_error_messages = array( 'activate' => esc_html__( 'Failed to activate addon', 'forminator' ), 'deactivate' => esc_html__( 'Failed to deactivate addon', 'forminator' ), 'update_settings' => esc_html__( 'Failed to update settings', 'forminator' ), 'update_form_settings' => esc_html__( 'Failed to update form settings', 'forminator' ), ); // Only enable wp_ajax hooks. Forminator_Integration_Admin_Ajax::get_instance(); } /* * Load default addon files * * @param string $addon_slug Integration slug. * @return void / private static function load_default_files( $addon_slug ) { $files = array( '', '-settings-trait', '-form-settings', '-poll-settings', '-quiz-settings', '-form-hooks', '-poll-hooks', '-quiz-hooks', ); foreach ( $files as $file ) { $file_path = forminator_plugin_dir() . 'addons/pro/' . $addon_slug . '/class-forminator-addon-' . $addon_slug . $file . '.php'; if ( file_exists( $file_path ) ) { require_once $file_path; } } } /* * Register new Integration * * @since 1.1 * * @param Forminator_Integration\|string $class_name instance of Integration or its classname. * * @return bool / public function register( $class_name ) { try { /* * Fires immediately after an addon registering. * * This action executed before whole process of registering addon. * Validation and requirement check has not been done, * so its possible the addon will not registered in the end, * when validation fail or requirement not set @see Forminator_Integration_Loader::register() * * @since 1.1 * * @param Forminator_Integration\|string $class_name instance of Integration or its class name. / do_action( 'forminator_before_addon_registered', $class_name ); if ( $class_name instanceof Forminator_Integration ) { $addon_class = $class_name; } else { if ( ! strpos( $class_name, '_' ) ) { // Integration slug is passed. $class_slug = $class_name; $class_name = 'Forminator_' . ucfirst( $class_name ); self::load_default_files( $class_slug ); } $addon_class = $this->validate_addon_class( $class_name ); } $registered_addons = $this->addons; /* * Filter addon instance. * * Its possible to replace / modify addon instance when its registered * Keep in mind instance that returned by this filter will be used throughout app * Return must be instance of @see Forminator_Integration. * It will be then validated by @see Forminator_Integration_Loader::validate_addon_instance() * * @since 1.1 * * @param Forminator_Integration $addon_class Current Integration class instance. * @param array $registered_addons Current registered addons. / $addon_class = apply_filters( 'forminator_addon_instance', $addon_class, $registered_addons ); $addon = $this->validate_addon_instance( $addon_class ); $this->addons[ $addon->get_slug() ] = $addon; if ( $this->is_non_exist_activated_option && self::$pre_activated_addons ) { if ( in_array( $addon->get_slug(), self::$pre_activated_addons, true ) ) { $this->activate_addon( $addon->get_slug() ); } } /* * Fires after addon successfully registered * * When addon registered, this action will be fire * If addon not registered because one or other things, * this action will not executed * * @since 1.1 * * @param Forminator_Integration $addon Current addon that successfully registered. / do_action( 'forminator_after_addon_registered', $addon ); return true; } catch ( Forminator_Integration_Exception $e ) { forminator_addon_maybe_log( __METHOD__, $class_name, $e->getMessage() ); return false; } } /* * Validate Integration by its class name * * @since 1.1 * * @param string $class_name Class Name. * * @return Forminator_Integration * @throws Forminator_Integration_Exception When there is an addon error. / private function validate_addon_class( $class_name ) { if ( ! class_exists( $class_name ) ) { throw new Forminator_Integration_Exception( esc_html( 'Integration with ' . $class_name . ' does not exist' ) ); } if ( ! is_callable( array( $class_name, 'get_instance' ) ) ) { throw new Forminator_Integration_Exception( esc_html( 'Integration with ' . $class_name . ' does not have get_instance method' ) ); } $addon_class = call_user_func( array( $class_name, 'get_instance' ) ); return $addon_class; } /* * Valdate addon instance * * @since 1.1 * * @param Forminator_Integration $instance Forminator_Integration. * * @return Forminator_Integration * @throws Forminator_Integration_Exception When there is an addon error. / private function validate_addon_instance( Forminator_Integration $instance ) { /* * Forminator_Integration * * @var Forminator_Integration $addon_class / $addon_class = $instance; $class_name = get_class( $instance ); if ( ! $addon_class instanceof Forminator_Integration ) { throw new Forminator_Integration_Exception( esc_html( 'Integration with ' . $class_name . ' is not instanceof Forminator_Integration' ) ); } $slug = $addon_class->get_slug(); $version = $addon_class->get_version(); if ( empty( $slug ) ) { throw new Forminator_Integration_Exception( esc_html( 'Integration with ' . $class_name . ' does not have slug' ) ); } // FIFO. if ( isset( $this->addons[ $slug ] ) ) { throw new Forminator_Integration_Exception( esc_html( 'Integration with slug ' . $slug . ' already exist' ) ); } if ( empty( $version ) ) { throw new Forminator_Integration_Exception( esc_html( 'Integration with slug ' . $slug . ' does not have valid version' ) ); } // check version changed if active. if ( $this->addon_is_active( $slug ) ) { try { // silent. if ( $addon_class->is_version_changed() ) { $addon_class->version_changed( $addon_class->get_installed_version(), $addon_class->get_installed_version() ); } } catch ( Exception $e ) { forminator_addon_maybe_log( $addon_class->get_slug(), 'failed to trigger version_changed', $e->getMessage() ); } } return $addon_class; } /* * Get Integration Instance * * @since 1.1 * * @param string $slug Slug. * * @return Forminator_Integration\|null / public function get_addon( $slug ) { return $this->addons[ $slug ]; } /* * Get All registered Integrations * * @since 1.1 * @return Forminator_Addon_Container / public function get_addons() { return $this->addons; } /* * Check if addon is active * * @since 1.1 * * @param string $slug Slug. * * @return bool / public function addon_is_active( $slug ) { if ( in_array( $slug, $this->activated_addons, true ) ) { return true; } return false; } /* * Deactivate Integration * This function will call `deactivate` function of addon class if available * * @since 1.1 * * @param string $slug Slug. * * @return bool / public function deactivate_addon( $slug ) { $addon = $this->get_addon( $slug ); if ( is_null( $addon ) ) { $this->last_error_message = esc_html__( 'Integration not found', 'forminator' ); return false; } if ( ! $this->addon_is_active( $slug ) ) { $this->last_error_message = esc_html__( 'Integration was not activated before', 'forminator' ); return false; } $deactivated = $addon->deactivate(); if ( ! $deactivated ) { $error_message = $addon->get_deactivation_error_message(); if ( empty( $error_message ) ) { $error_message = $this->default_addon_error_messages['deactivate']; } $this->last_error_message = $error_message; return false; } $this->force_remove_activated_addons( $slug ); /* * Fires after addon successfully deactivated * * Keep in mind that addon is already deactivated here, * So mostly `$addon` method will fail if it requires `$addon` to be active * * @since 1.1 * * @param Forminator_Integration $addon Current deactivated addon. / do_action( 'forminator_after_addon_deactivated', $addon ); return true; } /* * Add activated addons to wp options * * @since 1.1 * * @param string $slug Slug. / private function add_activated_addons( $slug ) { $addon = $this->get_addon( $slug ); $this->activated_addons[] = $slug; update_option( self::$_active_addons_option, $this->activated_addons ); // take from __get version since its new addon. update_option( $addon->get_version_options_name(), $addon->get_version() ); } /* * Force Remove activated addons * remove activated addons from wp options, without calling deactivate on addon function * * @since 1.1 * * @param string $slug Slug. / public function force_remove_activated_addons( $slug ) { $addon = $this->get_addon( $slug ); $options = array(); $setting_form_meta_name = 'forminator_addon_' . $slug . '_form_settings'; if ( $addon ) { $version_options_name = $addon->get_version_options_name(); $settions_options_name = $addon->get_settings_options_name(); $options = get_option( $settions_options_name ); if ( is_array( $options ) ) { unset( $options[ $addon->multi_global_id ] ); update_option( $settions_options_name, $options ); } $setting_form_meta_name .= '_' . $addon->multi_global_id; } else { // probably just want to remove the options. $version_options_name = 'forminator_addon_' . $slug . '_version'; $settions_options_name = 'forminator_addon_' . $slug . '_settings'; } if ( empty( $options ) ) { // delete version. delete_option( $version_options_name ); // delete general settings. delete_option( $settions_options_name ); $index = array_search( $slug, $this->activated_addons, true ); if ( false !== $index ) { unset( $this->activated_addons[ $index ] ); // reset keys. $this->activated_addons = array_values( $this->activated_addons ); update_option( self::$_active_addons_option, $this->activated_addons ); } } // Delete post meta. delete_post_meta_by_key( $setting_form_meta_name ); /* * Fires when activated addons removed from wp options * * @since 1.1 * * @param string $slug addon `slug` removed. * @param Forminator_Integration\|null Integration instance or null when addon instance unavailable / do_action( 'forminator_after_activated_addons_removed', $slug, $addon ); } /* * Activate Integration * This function will call `activate` function on addon if available * * @since 1.1 * * @param string $slug Slug. * * @return bool / public function activate_addon( $slug ) { $addon = $this->get_addon( $slug ); /* * Fires before Integration activated * * @since 1.1 * * @param string $slug Slug of addon that will be activated. * @param Forminator_Integration\|null $addon addon instance or null, when its not unavailable. / do_action( 'forminator_before_addon_activated', $slug, $addon ); if ( is_null( $addon ) ) { $this->last_error_message = esc_html__( 'Integration not found', 'forminator' ); return false; } if ( $this->addon_is_active( $slug ) ) { $this->last_error_message = esc_html__( 'Integration already activated before', 'forminator' ); return false; } if ( ! $addon->is_activable() ) { $this->last_error_message = esc_html__( 'Integration is not activable', 'forminator' ); return false; } $activated = $addon->activate(); if ( ! $activated ) { $error_message = $addon->get_activation_error_message(); if ( empty( $error_message ) ) { $error_message = $this->default_addon_error_messages['activate']; } $this->last_error_message = $error_message; return false; } $this->add_activated_addons( $slug ); /* * Fires when an Integration activated * * @since 1.1 * * @param Forminator_Integration $addon Current activated addon. / do_action( 'forminator_after_addon_activated', $addon ); return true; } /* * Get Last error message * * @since 1.1 * @return string / public function get_last_error_message() { $last_error_message = $this->last_error_message; /* * Filter Last error message of the addon loader * * @since 1.1 * * @param string $last_error_message Current last error message. / $last_error_message = apply_filters( 'forminator_addon_loader_last_error_message', $last_error_message ); return $last_error_message; } /* * Get default messages provided by loader * * @since 1.1 * @return array / public function get_default_messages() { $default_addon_error_messages = $this->default_addon_error_messages; /* * Filter default addon error messages. * * @since 1.1 * * @param array $default_addon_error_messages Default addon error messages that created by loader and used if Integration not specify any. / $default_addon_error_messages = apply_filters( 'forminator_addon_loader_default_messages', $default_addon_error_messages ); return $default_addon_error_messages; } /* * Cleanup probably addons that activated before but not it doesnt exist or become invalid * * CAUTION : only call this when all addons already registered * * @since 1.1 / public function cleanup_activated_addons() { $this->activated_addons = array_unique( $this->activated_addons ); $unavailable_addons = array_diff( $this->activated_addons, $this->addons->get_slugs() ); foreach ( $unavailable_addons as $unavailable_addon ) { $this->force_remove_activated_addons( $unavailable_addon ); } } /* * Update old Zapier Integration to new Webhook Integration / public function update_zapier_to_webhook() { // Activate Webhook Integration. $this->add_activated_addons( 'webhook' ); // Rename module Zapier settings. global $wpdb; // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- false positive $wpdb->query( "UPDATE $wpdb->postmeta SET meta_key = 'forminator_addon_webhook_form_settings' WHERE meta_key = 'forminator_addon_zapier_form_settings'" ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- false positive $wpdb->query( "UPDATE $wpdb->postmeta SET meta_key = 'forminator_addon_webhook_poll_settings' WHERE meta_key = 'forminator_addon_zapier_poll_settings'" ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- false positive $wpdb->query( "UPDATE $wpdb->postmeta SET meta_key = 'forminator_addon_webhook_quiz_settings' WHERE meta_key = 'forminator_addon_zapier_quiz_settings'" ); $this->force_remove_activated_addons( 'zapier' ); } /* * No activated addons = true, otherwise is false * * @since 1.1 * * @return bool / public function is_empty_activated_option() { return $this->is_empty_activated_option; } /* * First install = true, otherwise false * * @since 1.1 * @return bool / public function is_non_exist_activated_option() { return $this->is_non_exist_activated_option; } /* * Get Activated addons slug * * @since 1.1 * @return array */ public function get_activated_addons() { return $this->activated_addons; } }	19.33 KB	2026-01-12 18:46
📄 class-loader.php <?php /** * Forminator Loader * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Loader / class Forminator_Loader { /* * Files * * @var array / public $files = array(); /* * Forminator_Loader constructor. / public function __construct() {} /* * Retrieve data * * @since 1.0 * @since 1.7 add $requirements * * @param string $dir Directory name. * @param array $requirements Requirements. * * @return mixed / public function load_files( $dir, $requirements = array() ) { $files = scandir( forminator_plugin_dir() . $dir ); foreach ( $files as $file ) { if ( in_array( $file, array( 'paypal.php', 'stripe.php', 'stripe-payment-element.php' ), true ) && forminator_payments_disabled() ) { continue; } $path = forminator_plugin_dir() . $dir . '/' . $file; if ( $this->is_php( $file ) && is_file( $path ) ) { // check requirement. if ( ! empty( $requirements ) ) { if ( in_array( $file, array_keys( $requirements ), true ) ) { if ( ! $this->is_requirement_fulfilled( $requirements[ $file ] ) ) { continue; } } } // Get class name. $class_name = str_replace( '.php', '', $file ); // Include file. include_once $path; // Init class. $object = $this->init( $class_name ); $this->files[] = $object; } } return $this->files; } /* * Check if PHP file * * @since 1.0 * @param string $file Filename. * * @return bool / public function is_php( $file ) { $check = substr( $file, - 4 ); if ( '.php' === $check ) { return true; } return false; } /* * Normalize class name * * @since 1.0 * @param string $name Name. * * @return mixed\|string / public function normalize( $name ) { $name = str_replace( '-', '_', $name ); $name = ucwords( $name ); return $name; } /* * Init class * * @since 1.0 * @param string $name Name. * * @return mixed / private function init( $name ) { $class = 'Forminator_' . $this->normalize( $name ); if ( class_exists( $class ) ) { $object = new $class(); return $object; } } /* * Check if requirement fulfilled by system * * @since 1.7 * * @param array $requirement Requirement. * * @return bool */ private function is_requirement_fulfilled( $requirement ) { // check php version. if ( isset( $requirement['php'] ) ) { $version = $requirement['php']; if ( version_compare( PHP_VERSION, $version, 'lt' ) ) { return false; } } return true; } }	2.54 KB	2026-01-12 18:46
📄 class-migration.php <?php /** * Forminator Migration * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Migration / class Forminator_Migration { /* * Static method to combine all settings migrations * * @param mixed $settings Settings. * @param array $fields Fields. * * @since 1.6 * * @return mixed / public static function migrate_custom_form_settings( $settings, $fields ) { $version = self::get_version( $settings ); if ( ! is_array( $settings ) ) { return $settings; } // skip alpha/beta ... from migration. if ( version_compare( $version, '1.6-alpha.1', 'lt' ) ) { /* * Migrate pagination settings * * @since 1.6 / $settings = self::migrate_pagination_settings_1_6( $settings ); /* * Migrate submit data * * @since 1.6 / $settings = self::migrate_submit_props_1_6( $settings ); /* * Migrate padding & border settings * * @since 1.6 / $settings = self::migrate_padding_border_settings_1_6( $settings ); /* * Migrate custom font settings * * @since 1.6 / $settings = self::migrate_custom_fonts_1_6( $settings ); } if ( version_compare( $version, '1.6.1.alpha-1', 'lt' ) ) { /* * Migrate padding & border settings * * @since 1.6 / $settings = self::migrate_padding_border_settings_1_6_1( $settings ); } /* * Migrate Page break settings * * @since 1.7.4 / $settings = self::migrate_pagination_form_settings( $settings, $fields ); if ( version_compare( $version, '1.37', 'lt' ) ) { /* * Migrate Data Storage settings * * @since 1.15.12 / $settings = self::migrate_data_storage_settings( $settings ); } /* * Migrate behaviour settings * * @since 1.15.12 / $settings = self::migrate_data_behaviour_settings( $settings, $fields ); if ( version_compare( $version, '1.37', 'lt' ) ) { /* * Migrate appearance settings. * * @since 1.36 / $settings = self::migrate_appearance_settings( $settings ); } return $settings; } /* * Static method to combine all field migrations * * @param array $field Field. * @param string $settings Settings. * * @since 1.6 * * @return mixed / public static function migrate_field( $field, $settings ) { if ( isset( $settings['version'] ) ) { $version = $settings['version']; } else { $version = FORMINATOR_VERSION; } // Fallback if field type is undefined. if ( ! isset( $field['type'] ) ) { return $field; } // Skip alpha/beta ... from migration. if ( version_compare( $version, '1.6-alpha.1', 'lt' ) ) { /* * Migrate to new field types * * @since 1.6 / $field = self::migrate_field_types_1_6( $field ); /* * Migrate invisible captcha * * @since 1.6 / $field = self::migrate_invisible_captcha_1_6( $field ); /* * Migrate email validation * * @since 1.6 / $field = self::migrate_email_validation_1_6( $field ); /* * Migrate name field required * * @since 1.6 / $field = self::migrate_multiple_required_1_6( $field ); /* * Migrate section border * * @since 1.6 / $field = self::migrate_section_border_1_6( $field, $settings ); /* * Migrate phone field validation * * @since 1.6 / $field = self::migrate_phone_validation_1_6( $field ); /* * Migrate conditions * * @since 1.6 / $field = self::migrate_field_conditions_1_6( $field ); /* * Migrate text_limit on `text` field * * @since 1.6 / $field = self::migrate_text_limit_1_6( $field ); } if ( version_compare( $version, '1.7.alpha-1', 'lt' ) ) { return $field; } /* * Migrate Phone validation * * @since 1.14 / $field = self::migrate_phone_validation_field( $field ); /* * Migrate Page_break field border * * @since 1.7.4 / $field = self::migrate_page_break_pagination_field( $field ); /* * Migrate text_limit on `text` field * * @since 1.6 / $field = self::migrate_date_limit_1_13( $field ); /* * Migrate Payment plan on `stripe` field * * @since 1.15 / $field = self::migrate_payment_plan_field( $field ); /* * Migrate captcha provider field * * @since 1.15.8 / $field = self::migrate_captcha_provider_field( $field ); return $field; } /* * Static method to combine all settings migrations * * @param array $settings Settings. * * @since 1.6.1 * * @return mixed / public static function migrate_polls_settings( $settings ) { $version = self::get_version( $settings ); if ( ! is_array( $settings ) ) { return $settings; } if ( version_compare( $version, '1.6.1.alpha-1', 'lt' ) ) { /* * Migrate colors settings * * @since 1.6.1 / $settings = self::migrate_colors_settings_1_6_1( $settings ); /* * Migrate padding & border settings * * @since 1.6.1 / $settings = self::migrate_padding_border_settings_1_6_1( $settings ); } if ( version_compare( $version, '1.37', 'lt' ) ) { /* * Migrate Data Storage settings * * @since 1.15.12 / $settings = self::migrate_data_storage_settings( $settings ); } return $settings; } /* * Static method to combine all settings migrations * * @param array $settings Settings. * * @since 1.6.1 * * @return mixed / public static function migrate_quizzes_settings( $settings ) { $version = self::get_version( $settings ); if ( ! is_array( $settings ) ) { return $settings; } if ( version_compare( $version, '1.6.2.alpha-1', 'lt' ) ) { /* * Migrate colors settings * * @since 1.6.2 / $settings = self::migrate_share_settings_1_6_2( $settings ); } if ( version_compare( $version, '1.37', 'lt' ) ) { /* * Migrate Data Storage settings * * @since 1.15.12 / $settings = self::migrate_data_storage_settings( $settings ); } return $settings; } /* * Migrate Leads Forms (change their post_status) / public static function migrate_leads_forms() { $args = array( 'post_type' => 'forminator_forms', 'post_status' => 'any', 'fields' => 'ids', 'numberposts' => -1, 'meta_key' => 'forminator_form_meta', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key 'meta_value' => 'form-type";s:5:"leads"', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value 'meta_compare' => 'LIKE', ); $leads_forms = get_posts( $args ); foreach ( $leads_forms as $id ) { wp_update_post( array( 'ID' => $id, 'post_status' => 'leads', ) ); } } /* * Migrate new field types from 1.6 version * * @param array $field Field. * * @since 1.6 * * @return mixed / public static function migrate_field_types_1_6( $field ) { // Migrate text to textarea. if ( 'text' === $field['type'] && isset( $field['input_type'] ) && 'paragraph' === $field['input_type'] ) { $field['type'] = 'textarea'; } // Migrate text to textarea. if ( 'select' === $field['type'] && isset( $field['value_type'] ) && 'radio' === $field['value_type'] ) { $field['type'] = 'radio'; } // Migrate multi select to select. if ( 'checkbox' === $field['type'] && ( isset( $field['value_type'] ) && 'multiselect' === $field['value_type'] ) ) { $field['type'] = 'select'; } return $field; } /* * Migrate invisible captcha from 1.6 version * * @param array $field Field. * * @since 1.6 * * @return mixed / public static function migrate_invisible_captcha_1_6( $field ) { if ( 'captcha' === $field['type'] ) { $is_invisible_captcha = isset( $field['invisible_captcha'] ) ? filter_var( $field['invisible_captcha'], FILTER_VALIDATE_BOOLEAN ) : false; if ( $is_invisible_captcha ) { $field['captcha_type'] = 'invisible'; } unset( $field['invisible_captcha'] ); } return $field; } /* * Migrate email validation * * @param array $field Field. * * @since 1.6 * * @return mixed / public static function migrate_email_validation_1_6( $field ) { // Migrate email validation message. if ( 'email' === $field['type'] ) { $validation_text = isset( $field['validation_text'] ) ? $field['validation_text'] : ''; if ( ! empty( $validation_text ) ) { $field['validation_message'] = $validation_text; } unset( $field['validation_text'] ); } return $field; } /* * Migration section border settings * * @param array $field Field. * @param array $settings Settings. * * @since 1.6 * * @return mixed / public static function migrate_section_border_1_6( $field, $settings ) { if ( 'section' === $field['type'] ) { $has_border = $field['section_border']; $has_border = filter_var( $has_border, FILTER_VALIDATE_BOOLEAN ); // Check if we need migration. if ( $has_border && ! isset( $field['border_width'] ) && ! isset( $field['border_color'] ) ) { $field['section_border'] = 'solid'; $field['border_width'] = '1'; $field['border_color'] = $settings['cform-section-border-color']; } } return $field; } /* * Migrate phone field validation * * @param array $field Field. * * @since 1.6 * * @return mixed / public static function migrate_phone_validation_1_6( $field ) { if ( isset( $field['validation'] ) ) { if ( true === $field['validation'] ) { $field['validation'] = 'true'; } else { $field['validation'] = 'false'; } } return $field; } /* * Migrate multiple fields required * * @param array $field Field. * * @since 1.6 * * @return mixed / public static function migrate_multiple_required_1_6( $field ) { // migrate name required to multi. if ( 'name' === $field['type'] ) { $is_multi = isset( $field['multiple_name'] ) ? filter_var( $field['multiple_name'], FILTER_VALIDATE_BOOLEAN ) : false; $is_old_required = isset( $field['required'] ) ? filter_var( $field['required'], FILTER_VALIDATE_BOOLEAN ) : false; if ( $is_multi && $is_old_required ) { $field['prefix_required'] = true; $field['fname_required'] = true; $field['mname_required'] = true; $field['lname_required'] = true; unset( $field['required'] ); } } // migrate address required to multi. if ( 'address' === $field['type'] ) { $is_old_required = isset( $field['required'] ) ? filter_var( $field['required'], FILTER_VALIDATE_BOOLEAN ) : false; if ( $is_old_required ) { $field['street_address_required'] = true; $field['address_line_required'] = true; $field['address_city_required'] = true; $field['address_state_required'] = true; $field['address_zip_required'] = true; $field['address_country_required'] = true; unset( $field['required'] ); } } return $field; } /* * Migrate new pagination settings * * @param array $settings Settings. * * @since 1.6 * * @return mixed / public static function migrate_pagination_settings_1_6( $settings ) { if ( isset( $settings['pagination-header-design'] ) ) { if ( 'bar' === $settings['pagination-header-design'] \|\| 'nav' === $settings['pagination-header-design'] ) { $settings['pagination-header'] = $settings['pagination-header-design']; $settings['pagination-header-design'] = 'show'; } } else { $settings['pagination-header-design'] = 'off'; } if ( isset( $settings['pagination-footer-button'] ) \|\| isset( $settings['pagination-right-button'] ) ) { $settings['pagination-labels'] = 'custom'; } return $settings; } /* * Migrate new padding settings * * @param array $settings Settings. * * @since 1.6 * * @return mixed / public static function migrate_padding_border_settings_1_6( $settings ) { if ( ! isset( $settings['form-padding'] ) ) { $settings['form-padding'] = 'custom'; } if ( ! isset( $settings['form-border'] ) ) { $settings['form-border'] = 'custom'; } return $settings; } /* * Migrate new padding settings * * @param array $settings Settings. * * @since 1.6.1 * * @return mixed / public static function migrate_padding_border_settings_1_6_1( $settings ) { if ( ! isset( $settings['poll-padding'] ) ) { $settings['poll-padding'] = 'custom'; } if ( ! isset( $settings['poll-border'] ) ) { $settings['poll-border'] = 'custom'; } return $settings; } /* * Migrate new padding settings * * @param array $settings Settings. * * @since 1.6.1 * * @return mixed / public static function migrate_colors_settings_1_6_1( $settings ) { if ( ! isset( $settings['poll-colors'] ) ) { $settings['poll-colors'] = 'true'; } return $settings; } /* * Migrate custom font settings * * @param array $settings Settings. * * @since 1.6 * * @return mixed / public static function migrate_custom_fonts_1_6( $settings ) { if ( ! isset( $settings['form-font-family'] ) ) { $needs_migration = false; // List of old font toggles. $old_settings = array( 'cform-label-font-settings', 'cform-input-font-settings', 'cform-radio-font-settings', 'cform-select-font-settings', 'cform-dropdown-font-settings', 'cform-button-font-settings', 'cform-timeline-font-settings', 'cform-pagination-font-settings', ); // Check if we have enabled custom font settings. foreach ( $old_settings as $prop ) { if ( isset( $settings[ $prop ] ) && $settings[ $prop ] ) { $needs_migration = true; } } // We need to migrate. if ( $needs_migration ) { // Update new property. $settings['form-font-family'] = 'custom'; // Unset all old properties. foreach ( $old_settings as $prop ) { unset( $settings[ $prop ] ); } } } return $settings; } /* * Migrate submit data * * @param array $settings Settings. * * @since 1.6 * * @return mixed / public static function migrate_submit_props_1_6( $settings ) { if ( ! isset( $settings['submitData'] ) ) { $settings['submitData'] = array(); } if ( isset( $settings['use-custom-submit'] ) && $settings['use-custom-submit'] && isset( $settings['custom-submit-text'] ) ) { $settings['submitData']['custom-submit-text'] = $settings['custom-submit-text']; } unset( $settings['use-custom-submit'] ); unset( $settings['custom-submit-text'] ); if ( isset( $settings['use-custom-invalid-form'] ) && $settings['use-custom-invalid-form'] && isset( $settings['custom-invalid-form-message'] ) ) { $settings['submitData']['custom-invalid-form-message'] = $settings['custom-invalid-form-message']; } unset( $settings['use-custom-invalid-form'] ); unset( $settings['custom-invalid-form-message'] ); return $settings; } /* * Check if migration is needed * * @param string $version Version. * * @since 1.6 * * @return bool / public static function skip_migration( $version ) { if ( FORMINATOR_VERSION === $version ) { return true; } return false; } /* * Get form version * * @param array $settings Settings. * * @since 1.6 * * @return string / public static function get_version( $settings ) { if ( isset( $settings['version'] ) && ! empty( $settings['version'] ) ) { return $settings['version']; } return '1.0'; } /* * Migrate conditions struct * * @since 1.6 * * @param array $field Field. * * @return mixed / public static function migrate_field_conditions_1_6( $field ) { if ( isset( $field['use_conditions'] ) ) { $use_condition = filter_var( $field['use_conditions'], FILTER_VALIDATE_BOOLEAN ); if ( ! $use_condition ) { unset( $field['conditions'] ); } unset( $field['use_conditions'] ); } return $field; } /* * Migrate `text_limit` to `limit` * * @param array $field Field. * * @since 1.6 * * @return mixed / public static function migrate_text_limit_1_6( $field ) { // Migrate text_limit to limit. // text area added here because its executed after types migrated. if ( 'text' === $field['type'] \|\| 'textarea' === $field['type'] ) { if ( isset( $field['text_limit'] ) ) { $has_limit = filter_var( $field['text_limit'], FILTER_VALIDATE_BOOLEAN ); if ( ! $has_limit ) { unset( $field['limit'] ); } unset( $field['text_limit'] ); } } return $field; } /* * Migrate share settings * * @param array $settings Settings. * * @since 1.6.2 * * @return mixed / public static function migrate_share_settings_1_6_2( $settings ) { if ( isset( $settings['facebook'] ) \|\| isset( $settings['twitter'] ) \|\| isset( $settings['google'] ) \|\| isset( $settings['linkedin'] ) ) { $settings['enable-share'] = 'on'; } return $settings; } /* * Migrate Pagination settings * * @param array $field Field. * * @since 1.7.4 * * @return mixed / public static function migrate_page_break_pagination_field( $field ) { // Migrate page break. if ( 'pagination' === $field['type'] ) { $field['type'] = 'page-break'; $element_id = $field['element_id']; $element_num = explode( '-', $element_id ); if ( isset( $element_num[1] ) ) { $element_id = $field['type'] . '-' . $element_num[1]; } $field['element_id'] = $element_id; } return $field; } /* * Migrate Date limit * * @param array $field Field. * * @since 1.13 * * @return mixed / public static function migrate_date_limit_1_13( $field ) { // Migrate page break. if ( 'date' === $field['type'] ) { if ( isset( $field['howto-restrict'] ) && 'custom' === $field['howto-restrict'] ) { $field['howto-restrict'] = 'all'; $disable_date = array(); if ( isset( $field['date_multiple'] ) && ! empty( $field['date_multiple'] ) ) { foreach ( $field['date_multiple'] as $key => $date ) { $disable_date[] = gmdate( 'm/d/Y', strtotime( $date['value'] ) ); } $field['disabled-dates'] = $disable_date; } } if ( isset( $field['min_year'] ) && ! empty( $field['min_year'] ) && ! isset( $field['start-date'] ) ) { $field['start-date'] = 'specific'; $field['start-specific-date'] = date_i18n( 'm/d/Y', strtotime( '1/1/' . $field['min_year'] ) ); } if ( isset( $field['max_year'] ) && ! empty( $field['max_year'] ) && ! isset( $field['end-date'] ) ) { $field['end-date'] = 'specific'; $field['end-specific-date'] = date_i18n( 'm/d/Y', strtotime( '12/31/' . $field['max_year'] ) ); } } return $field; } /* * Pagination settings migrations * * @param array $settings Settings. * @param array $fields Fields. * * @since 1.7.4 * * @return mixed / public static function migrate_pagination_form_settings( $settings, $fields ) { if ( empty( $settings ) \|\| ! is_array( $settings ) ) { return $settings; } if ( empty( $fields ) ) { return $settings; } foreach ( $fields as $field ) { if ( isset( $field['type'] ) && 'pagination' === $field['type'] ) { $element_id = $field['element_id']; $element_num = explode( '-', $element_id ); if ( isset( $element_num[1] ) ) { $element_id = 'page-break-' . $element_num[1]; } if ( isset( $field['pagination-label'] ) ) { $settings['paginationData'][ $element_id . '-steps' ] = $field['pagination-label']; } if ( isset( $field['pagination-labels'] ) && 'custom' === $field['pagination-labels'] ) { $settings['paginationData']['pagination-labels'] = $field['pagination-labels']; } if ( isset( $field['pagination-footer-button-text'] ) ) { $settings['paginationData'][ $element_id . '-previous' ] = $field['pagination-footer-button-text']; } if ( ! isset( $settings['paginationData'][ $element_id . '-next' ] ) && isset( $field['pagination-right-button-text'] ) ) { $settings['paginationData'][ $element_id . '-next' ] = $field['pagination-right-button-text']; } } } if ( ! isset( $settings['paginationData']['pagination-header-design'] ) && isset( $settings['pagination-header-design'] ) ) { $settings['paginationData']['pagination-header-design'] = $settings['pagination-header-design']; } if ( ! isset( $settings['paginationData']['pagination-header'] ) && isset( $settings['pagination-header'] ) ) { $settings['paginationData']['pagination-header'] = $settings['pagination-header']; } return $settings; } /* * Static method to combine all notification migrations * * @param array $notifications Notifications. * @param array $settings Settings. * @param array $forms Forms. * * @since 1.6 * * @return mixed / public static function migrate_custom_form_notifications( $notifications, $settings, $forms ) { if ( ! isset( $forms['notifications'] ) ) { if ( isset( $settings['use-admin-email'] ) && ! empty( $settings['use-admin-email'] ) ) { $admin_args = array( 'slug' => 'notification-1111-2222', 'label' => 'Admin Email', 'email-recipients' => 'default', 'email-attachment' => 'false', ); if ( ! empty( $settings['admin-email-recipients'] ) ) { $admin_args['recipients'] = implode( ',', $settings['admin-email-recipients'] ); } if ( ! empty( $settings['admin-email-cc-address'] ) ) { $admin_args['cc-email'] = implode( ',', $settings['admin-email-cc-address'] ); } if ( ! empty( $settings['admin-email-bcc-address'] ) ) { $admin_args['bcc-email'] = implode( ',', $settings['admin-email-bcc-address'] ); } if ( ! empty( $settings['admin-email-from-name'] ) ) { $admin_args['from-name'] = $settings['admin-email-from-name']; } if ( ! empty( $settings['admin-email-from-address'] ) ) { $admin_args['form-email'] = $settings['admin-email-from-address']; } if ( ! empty( $settings['admin-email-reply-to-address'] ) ) { $admin_args['replyto-email'] = $settings['admin-email-reply-to-address']; } if ( ! empty( $settings['admin-email-title'] ) ) { $admin_args['email-subject'] = $settings['admin-email-title']; } if ( ! empty( $settings['admin-email-editor'] ) ) { $admin_args['email-editor'] = nl2br( $settings['admin-email-editor'] ); } $notifications[] = $admin_args; } if ( isset( $settings['use-user-email'] ) && ! empty( $settings['use-user-email'] ) ) { $user_args = array( 'slug' => 'notification-3333-4444', 'label' => 'Confirmation Email', 'email-recipients' => 'default', ); if ( ! empty( $settings['user-email-recipients'] ) ) { $user_args['recipients'] = implode( ',', $settings['user-email-recipients'] ); } if ( ! empty( $settings['user-email-cc-address'] ) ) { $user_args['cc-email'] = implode( ',', $settings['user-email-cc-address'] ); } if ( ! empty( $settings['user-email-bcc-address'] ) ) { $user_args['bcc-email'] = implode( ',', $settings['user-email-bcc-address'] ); } if ( ! empty( $settings['user-email-from-name'] ) ) { $user_args['from-name'] = $settings['user-email-from-name']; } if ( ! empty( $settings['user-email-from-address'] ) ) { $user_args['form-email'] = $settings['user-email-from-address']; } if ( ! empty( $settings['user-email-reply-to-address'] ) ) { $user_args['replyto-email'] = $settings['user-email-reply-to-address']; } if ( ! empty( $settings['user-email-title'] ) ) { $user_args['email-subject'] = $settings['user-email-title']; } if ( ! empty( $settings['user-email-editor'] ) ) { $user_args['email-editor'] = nl2br( $settings['user-email-editor'] ); } $notifications[] = $user_args; } } return $notifications; } /* * Static method to combine all quizzes notification migrations * * @param array $notifications Notifications. * @param array $settings Settings. * @param array $forms Forms. * * @since 1.6 * * @return mixed / public static function migrate_quizzes_notifications( $notifications, $settings, $forms ) { if ( ! isset( $forms['notifications'] ) \|\| empty( $forms['notifications'] ) ) { if ( isset( $settings['use-admin-email'] ) && ! empty( $settings['use-admin-email'] ) ) { $admin_args = array( 'slug' => 'notification-1111-2222', 'label' => 'Admin Email', ); if ( ! empty( $settings['admin-email-recipients'] ) ) { $admin_args['recipients'] = implode( ',', $settings['admin-email-recipients'] ); } if ( ! empty( $settings['admin-email-cc-address'] ) ) { $admin_args['cc-email'] = implode( ',', $settings['admin-email-cc-address'] ); } if ( ! empty( $settings['admin-email-bcc-address'] ) ) { $admin_args['bcc-email'] = implode( ',', $settings['admin-email-bcc-address'] ); } if ( ! empty( $settings['admin-email-from-name'] ) ) { $admin_args['from-name'] = $settings['admin-email-from-name']; } if ( ! empty( $settings['admin-email-from-address'] ) ) { $admin_args['form-email'] = $settings['admin-email-from-address']; } if ( ! empty( $settings['admin-email-reply-to-address'] ) ) { $admin_args['replyto-email'] = $settings['admin-email-reply-to-address']; } if ( ! empty( $settings['admin-email-title'] ) ) { $admin_args['email-subject'] = $settings['admin-email-title']; } if ( ! empty( $settings['admin-email-editor'] ) ) { $admin_args['email-editor'] = nl2br( $settings['admin-email-editor'] ); } $notifications[] = $admin_args; } } return $notifications; } /* * Migrate phone validation * * @param array $field Field. * * @return mixed / public static function migrate_phone_validation_field( $field ) { if ( 'phone' === $field['type'] ) { if ( isset( $field['validation'] ) ) { if ( 'true' === $field['validation'] && ! empty( $field['phone_validation_type'] ) ) { $field['validation'] = $field['phone_validation_type']; } if ( 'false' === $field['validation'] ) { $field['validation'] = 'none'; } } } return $field; } /* * Migrate payment plan * * @param array $field Field. * * @return mixed / public static function migrate_payment_plan_field( $field ) { if ( ( 'stripe' === $field['type'] \|\| 'stripe-ocs' === $field['type'] ) && empty( $field['payments'] ) ) { $payment_plan = array( 'plan_name' => esc_html__( 'Plan 1', 'forminator' ), 'payment_method' => 'single', 'amount_type' => isset( $field['amount_type'] ) ? $field['amount_type'] : 'fixed', 'subscription_amount_type' => 'fixed', 'quantity_type' => 'fixed', 'quantity' => '1', 'bill_input' => '1', ); if ( isset( $field['amount'] ) ) { $payment_plan['amount'] = $field['amount']; } if ( isset( $field['variable'] ) ) { $payment_plan['variable'] = $field['variable']; } $field['payments'][] = $payment_plan; } return $field; } /* * Migrate captcha field * * @param array $field Field. * * @return mixed / public static function migrate_captcha_provider_field( $field ) { if ( 'captcha' === $field['type'] ) { if ( ! isset( $field['captcha_provider'] ) ) { $field['captcha_provider'] = 'recaptcha'; } } return $field; } /* * Migrate Data storage setting - Enabled by default * * @param array $settings Settings. * * @since 1.15.12 * * @return mixed / public static function migrate_data_storage_settings( $settings ) { if ( ( ! isset( $settings['store'] ) && ! isset( $settings['store_submissions'] ) ) \|\| ( isset( $settings['store'] ) && ! filter_var( $settings['store'], FILTER_VALIDATE_BOOLEAN ) ) ) { $settings['store_submissions'] = '1'; } elseif ( isset( $settings['store'] ) && filter_var( $settings['store'], FILTER_VALIDATE_BOOLEAN ) ) { $settings['store_submissions'] = ''; } unset( $settings['store'] ); return $settings; } /* * Migrate Behaviour data * * @param array $settings Settings. * @param array $fields Fields. * * @return mixed / public static function migrate_data_behaviour_settings( $settings, $fields ) { if ( empty( $fields ) ) { return $settings; } foreach ( $fields as $field ) { if ( isset( $field['type'] ) && ( 'stripe' === $field['type'] \|\| 'stripe-ocs' === $field['type'] ) ) { $settings['enable-ajax'] = 'true'; break; } } return $settings; } /* * Migrate appearance settings * * @param array $settings Settings. * * @since 1.36 * * @return mixed */ public static function migrate_appearance_settings( $settings ) { $form_style = $settings['form-style'] ?? 'default'; if ( isset( $settings['form-substyle'] ) \|\| in_array( $form_style, array( 'basic', 'none' ), true ) ) { return $settings; } $settings['form-substyle'] = $form_style; $settings['form-style'] = 'default'; return $settings; } }	28.51 KB	2026-01-12 18:46
📄 class-modules.php <?php /** * Forminator Modules * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Core / class Forminator_Modules { /* * Store modules objects * * @var array / public $modules = array(); /* * Forminator_Modules constructor. * * @since 1.0 / public function __construct() { $this->includes(); $this->load_modules(); } /* * Includes * * @since 1.0 / private function includes() { / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/abstracts/abstract-class-module.php'; } /* * Load modules * * @since 1.0 / private function load_modules() { /* * Filters modules list / $modules = apply_filters( 'forminator_modules', array( 'custom_forms' => array( 'class' => 'Custom_Forms', 'slug' => 'custom-forms', 'label' => esc_html__( 'Custom Forms', 'forminator' ), ), 'polls' => array( 'class' => 'Polls', 'slug' => 'polls', 'label' => esc_html__( 'Polls', 'forminator' ), ), 'quizzes' => array( 'class' => 'Quizzes', 'slug' => 'quizzes', 'label' => esc_html__( 'Quizzes', 'forminator' ), ), ) ); array_walk( $modules, array( $this, 'load_module' ) ); } /* * Load module * * @since 1.0 * @param array $data Data. * @param int $id Id. / public function load_module( $data, $id ) { $module_class = 'Forminator_' . $data['class']; $module_slug = $data['slug']; $module_label = $data['label']; // Include module. $path = forminator_plugin_dir() . 'library/modules/' . $module_slug . '/loader.php'; if ( file_exists( $path ) ) { include_once $path; } if ( class_exists( $module_class ) ) { $module_object = new $module_class( $id, $module_label ); $this->modules[ $id ] = $module_object; } } /* * Retrieve modules objects * * @since 1.0 * @return array */ public function get_modules() { return $this->modules; } }	1.98 KB	2026-01-12 18:46
📄 class-page-cache.php <?php /** * Forminator Page Cache * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Page_Cache * * Forminator Page cache buster * * @since 1.6.1 / class Forminator_Page_Cache { /* * Instance * * @var self\|null / private static $instance = null; /* * Get Instance * * @return Forminator_Page_Cache\|null / public static function get_instance() { if ( empty( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Forminator_Page_Cache constructor / public function __construct() { add_action( 'clean_post_cache', array( $this, 'on_clean_post_cache' ), 99, 2 ); // publish action triggered by this. add_action( 'transition_post_status', array( $this, 'on_transition_post_status' ), 99, 3 ); } /* * Fired when `clean_post_cache` action * * @param int $post_id Post ID. * @param WP_Post $post WP Post. / public function on_clean_post_cache( $post_id, $post ) { forminator_maybe_log( __METHOD__, $post_id ); $this->execute_page_caches( $post_id, $post ); } /* * Fired when `transition_post_status` action * * @param string $new_status New status. * @param string $old_status Old status. * @param WP_Post $post WP Post. / public function on_transition_post_status( $new_status, $old_status, $post ) { // no status changed. if ( $new_status === $old_status ) { return; } $post_id = null; if ( $post instanceof WP_Post ) { $post_id = $post->ID; forminator_maybe_log( __METHOD__, $post_id ); } $this->execute_page_caches( $post_id, $post ); } /* * Main logic on how to handle page caches busting * * @param int $post_id Post ID. * @param WP_Post $post WP Post. / public function execute_page_caches( $post_id, $post ) { // Get fresh post. $wp_post = get_post( $post_id ); // This is deleted / invalid post. if ( ! $wp_post instanceof WP_Post ) { $this->remove_forminator_module_from_posts_map( $post_id ); $this->remove_post_from_posts_map( $post_id ); return; } if ( 'auto-draft' === $wp_post->post_status ) { return; } if ( 'revision' === $wp_post->post_type ) { return; } $forminator_post_types = $this->get_forminator_post_types(); if ( in_array( $post->post_type, $forminator_post_types, true ) ) { $this->maybe_bust_cache_posts( $post_id ); } else { $this->maybe_update_posts_map_option( $post_id, $post ); } } /* * Get internal forminator post types * * @return array / public function get_forminator_post_types() { $post_types = array( Forminator_Form_Model::model()->get_post_type(), Forminator_Poll_Model::model()->get_post_type(), Forminator_Quiz_Model::model()->get_post_type(), ); /* * Filter forminator post types that used as reference on page cache buster * * @since 1.6 * * @param array $post_types * * @return array / $post_types = apply_filters( 'forminator_page_cache_get_forminator_post_types', $post_types ); return $post_types; } /* * Bust cache of post which have forminator inside it * * @param int $post_id Post Id. / public function maybe_bust_cache_posts( $post_id ) { forminator_maybe_log( __METHOD__, $post_id ); $module_id = (int) $post_id; $option = get_option( 'forminator_posts_map', array() ); $to_bust_cache_post_ids = isset( $option[ $module_id ] ) ? $option[ $module_id ] : array(); foreach ( $to_bust_cache_post_ids as $to_bust_cache_post_id ) { $this->bust_cache_post( $to_bust_cache_post_id ); } } /* * Update posts map * * @param int $post_id Post ID. * @param WP_Post $post WP Post. / public function maybe_update_posts_map_option( $post_id, $post ) { forminator_maybe_log( __METHOD__, $post_id ); $posts_map_option = get_option( 'forminator_posts_map', array() ); $post_id = (int) $post_id; $content = $post->post_content; if ( has_shortcode( $content, 'forminator_form' ) \|\| has_shortcode( $content, 'forminator_poll' ) \|\| has_shortcode( $content, 'forminator_quiz' ) ) { $module_ids = array(); $shortcode_regex = get_shortcode_regex( array( 'forminator_form', 'forminator_poll', 'forminator_quiz' ) ); preg_match_all( '/' . $shortcode_regex . '/', $content, $matches, PREG_SET_ORDER ); if ( empty( $matches ) ) { return; } foreach ( $matches as $match ) { $shortcode_attr_text = isset( $match[3] ) ? $match[3] : ''; if ( empty( $shortcode_attr_text ) ) { continue; } $attr = shortcode_parse_atts( $shortcode_attr_text ); if ( isset( $attr['id'] ) ) { $module_ids[] = (int) $attr['id']; } } $module_ids = array_unique( $module_ids, SORT_NUMERIC ); // Add. foreach ( $module_ids as $module_id ) { $module_id = (int) $module_id; if ( ! isset( $posts_map_option[ $module_id ] ) ) { $posts_map_option[ $module_id ] = array(); } $module_posts_map = $posts_map_option[ $module_id ]; if ( ! in_array( $post_id, $module_posts_map, true ) ) { $module_posts_map[] = $post_id; sort( $module_posts_map ); $posts_map_option[ $module_id ] = $module_posts_map; } } // Cleanup. foreach ( $posts_map_option as $module_id => $saved_post_ids ) { foreach ( $saved_post_ids as $saved_post_id ) { if ( $post_id === $saved_post_id ) { $saved_module_id = (int) $module_id; // this post does not have `saved_module_id` anymore. if ( ! in_array( $saved_module_id, $module_ids, true ) ) { $post_ids = array_diff( $saved_post_ids, array( $post_id ) ); sort( $post_ids ); if ( empty( $post_ids ) ) { unset( $posts_map_option[ $module_id ] ); } else { $posts_map_option[ $module_id ] = $post_ids; } } } } } } else { // Cleanup. foreach ( $posts_map_option as $module_id => $saved_post_ids ) { foreach ( $saved_post_ids as $saved_post_id ) { if ( $post_id === $saved_post_id ) { // this post does not have `forminator` anymore. $post_ids = array_diff( $saved_post_ids, array( $post_id ) ); sort( $post_ids ); if ( empty( $post_ids ) ) { unset( $posts_map_option[ $module_id ] ); } else { $posts_map_option[ $module_id ] = $post_ids; } } } } } update_option( 'forminator_posts_map', $posts_map_option ); } /* * Remove forminator module from posts_map * * @param int $module_id Module Id. / public function remove_forminator_module_from_posts_map( $module_id ) { $module_id = (int) $module_id; $option = get_option( 'forminator_posts_map', array() ); if ( isset( $option[ $module_id ] ) ) { if ( is_array( $option[ $module_id ] ) ) { $to_bust_cache_post_ids = $option[ $module_id ]; foreach ( $to_bust_cache_post_ids as $to_bust_cache_post_id ) { $this->bust_cache_post( $to_bust_cache_post_id ); } } } unset( $option[ $module_id ] ); update_option( 'forminator_posts_map', $option ); } /* * Remove post from posts map * * @param int $post_id_to_remove Post ID. / public function remove_post_from_posts_map( $post_id_to_remove ) { $post_id_to_remove = (int) $post_id_to_remove; $option = get_option( 'forminator_posts_map', array() ); foreach ( $option as $module_id => $post_ids ) { if ( in_array( $post_id_to_remove, $post_ids, true ) ) { $post_ids = array_diff( $post_ids, array( $post_id_to_remove ) ); sort( $post_ids ); if ( empty( $post_ids ) ) { unset( $option[ $module_id ] ); } else { $option[ $module_id ] = $post_ids; } } } update_option( 'forminator_posts_map', $option ); } /* * Bust cache * * @param int $to_bust_cache_post_id Post ID. */ public function bust_cache_post( $to_bust_cache_post_id ) { if ( function_exists( 'clean_post_cache' ) ) { forminator_maybe_log( 'clean_post_cache exists' ); // w3-total-cache use `clean_post_cache`. clean_post_cache( $to_bust_cache_post_id ); } // hummingbird. do_action( 'wphb_clear_page_cache', $to_bust_cache_post_id ); } } // Init. Forminator_Page_Cache::get_instance();	8.05 KB	2026-01-12 18:46
📄 class-protection.php <?php /** * Forminator Protection * * @package Forminator / /* * Class Forminator_Protection * Loas all protection modules if vailable / class Forminator_Protection { /* * Plugin instance * * @var null / private static $instance = null; /* * Return the plugin instance * * @since 1.0 * @return Forminator_Protection / public static function get_instance() { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Main constructor * * @since 1.0 / public function __construct() { $this->include_in_built(); $this->init_modules(); } /* * Load our in-built spam protectors * * @since 1.0 / private function include_in_built() { / @noinspection PhpIncludeInspection / include_once forminator_plugin_dir() . 'library/protection/class-akismet.php'; } /* * Initialise spam modules * * @since 1.0 */ public function init_modules() { Forminator_Akismet::get_instance(); do_action( 'fominator_init_spam_modules' ); } }	1.03 KB	2026-01-12 18:46
📄 class-reports.php <?php /** * Forminator Reports * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Reports * * Handle data exports * * @since 1.0 / class Forminator_Reports { /* * Plugin instance * * @since 1.20.0 * @access private * @var null / private static $instance = null; /* * Report instance * * @var null / public $report_instance = null; /* * Return the plugin instance * * @return Forminator_Reports\|null / public static function get_instance() { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Main constructor * * @since 1.0 / public function __construct() { add_action( 'init', array( &$this, 'schedule_reports' ) ); add_action( 'forminator_process_report', array( &$this, 'process_report' ) ); } /* * Set up the schedule * * @since 1.0 / public function schedule_reports() { forminator_set_recurring_action( 'forminator_process_report', MINUTE_IN_SECONDS ); } /* * Process report. * * @since 1.20.0 / public function process_report() { $report_model = Forminator_Form_Reports_Model::get_instance(); $report_data = $report_model->fetch_all_report(); if ( empty( $report_data ) ) { return; } foreach ( $report_data as $report ) { $report_value = Forminator_Core::sanitize_array( maybe_unserialize( $report->report_value ) ); if ( 'active' !== $report->status \|\| empty( $report_value ) ) { continue; } $report_schedule = $report_value['schedule']; $last_sent = strtotime( $report->date_updated ); $current_time = current_time( 'timestamp' ); // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone. // check the next sent. $next_sent = null; $frequency = ! empty( $report_schedule['frequency'] ) ? $report_schedule['frequency'] : 'daily'; switch ( $frequency ) { case 'daily': $next_sent = strtotime( '+24 hours', $last_sent ); $next_sent = date_i18n( 'Y-m-d', $next_sent ) . ' ' . $report_schedule['time']; break; case 'weekly': $day = isset( $report_schedule['weekDay'] ) ? $report_schedule['weekDay'] : 'monday'; $next_sent = strtotime( 'next ' . $day, $last_sent ); $next_sent = date_i18n( 'Y-m-d', $next_sent ) . ' ' . $report_schedule['weekTime']; break; case 'monthly': $next_sent = $this->get_monthly_report_date( $last_sent, $report_schedule ); break; default: break; } if ( $current_time > strtotime( trim( $next_sent ) ) ) { $this->send_email_report( $report_value ); $report_model->report_update_date( $report->report_id ); } } } /* * Get monthly report * * @param string $last_sent Last sent date. * @param array $settings Settings. * * @return false\|string / private function get_monthly_report_date( $last_sent, $settings ) { $month_date = isset( $settings['monthDay'] ) ? $settings['monthDay'] : 1; $hour = isset( $settings['monthTime'] ) ? date_i18n( 'H:i', strtotime( $settings['monthTime'] ) ) : '00:00'; $next_sent = strtotime( date_i18n( "Y-m-{$month_date} {$hour}", $last_sent ) ); if ( $last_sent >= $next_sent ) { // If not - next month. $next_sent = strtotime( '+1 month', $next_sent ); } return date_i18n( 'Y-m-d H:i:s', $next_sent ); } /* * Send out an email report. * * @param array $options Options. * * @since 1.20.0 * * @return bool\|mixed\|void / protected function send_email_report( $options ) { if ( empty( $options['recipients'] ) \|\| empty( $options['settings'] ) ) { return; } $mail_sent = false; $report_data = $this->forminator_email_report_data( $options['settings'] ); if ( empty( $report_data ) ) { return; } foreach ( $options['recipients'] as $recipient ) { $params = array( 'label' => ! empty( $options['settings']['label'] ) ? $options['settings']['label'] : '', 'module' => ! empty( $options['settings']['module'] ) ? $options['settings']['module'] : 'forms', 'site_url' => site_url(), 'site_name' => get_bloginfo( 'name' ), 'settings' => $options['settings'], 'recipient' => $recipient, 'schedule' => forminator_get_schedule_time( $options['schedule'] ), 'reports' => $report_data, ); $email_subject = sanitize_text_field( $this->get_subject() ); $email_content = self::report_email_html( $params ); // Change nl to br. $email_content = stripslashes( $email_content ); $no_reply_email = 'noreply@' . wp_parse_url( get_site_url(), PHP_URL_HOST ); $headers = array( 'From: Forminator <' . $no_reply_email . '>', 'Content-Type: text/html; charset=UTF-8', ); $mail_sent = wp_mail( $recipient['email'], $email_subject, $email_content, $headers ); } return $mail_sent; } /* * Set report email subject. * * @return string * @since 1.20.0 / public function get_subject() { return sprintf( / translators: %s: Url for site / __( 'Here\'s your latest report for %s', 'forminator' ), site_url() ); } /* * Email HTML * * @param array $params Params. * * @return mixed\|string / public function report_email_html( $params ) { return forminator_template( 'common/reports/email-report', $params ); } /* * Email report data * * @param array $settings Settings. * * @return array / public function forminator_email_report_data( $settings ) { $email_report = array(); $module = isset( $settings['module'] ) ? $settings['module'] : 'forms'; $module_type = isset( $settings[ $module . '_type' ] ) ? $settings[ $module . '_type' ] : 'all'; if ( 'selected' === $module_type ) { $module_ids = isset( $settings[ 'selected_' . $module ] ) ? $settings[ 'selected_' . $module ] : array(); } else { $method = 'get_' . $module; $modules = Forminator_API::$method( null, 1, 999, 'publish' ); $module_ids = array_map( function ( $ar ) { return $ar->id; }, $modules ); } if ( ! empty( $module_ids ) ) { foreach ( $module_ids as $m => $module_id ) { $views = Forminator_Form_Views_Model::get_instance()->count_views( $module_id ); $submission = Forminator_Form_Entry_Model::count_report_entries( $module_id ); $abandoned = Forminator_Form_Entry_Model::count_report_entries( $module_id, '', '', 'abandoned' ); $based_on = $submission + $abandoned; $dropoff = 0 < $based_on ? number_format( ( $abandoned 100 ) / $based_on, 1 ) : 0; $conversion = 0 < $views ? number_format( ( $submission * 100 ) / $views, 1 ) : 0; $email_report[ $m ] = array( 'title' => forminator_get_form_name( $module_id ), 'views' => $views, 'submission' => $submission, 'abandoned' => $abandoned, 'conversion' => ! empty( $conversion ) ? $conversion . '%' : '', 'dropoff' => ! empty( $dropoff ) ? $dropoff . '%' : '', 'payments' => null, ); if ( Forminator_Form_Entry_Model::has_live_payment( $module_id ) ) { $payment_data = Forminator_Form_Entry_Model::payment_amount( $module_id ); $sum_value = null; if ( ! empty( $payment_data ) ) { $payment_value = array_map( function ( $payment ) { return maybe_unserialize( $payment->meta_value ); }, $payment_data ); $sum_value = ! empty( $payment_value ) ? array_sum( array_column( $payment_value, 'amount' ) ) : 0; } $email_report[ $m ]['payments'] = 0 !== $sum_value ? '$' . $sum_value : 0; } } } return $email_report; } }	7.53 KB	2026-01-12 18:46
📄 class-shortcode-generator.php <?php /** * Forminator Shortcode Generator * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Shortcode_Generator / class Forminator_Shortcode_Generator { /* * Forminator_Shortcode_Generator constructor. * * @since 1.0 / public function __construct() { global $pagenow; $is_hustle_wizard = $this->is_hustle_wizard(); $is_restricted_post_type = $this->is_restricted_post_type(); // If page different than Post or Page, abort. if ( ( 'post.php' !== $pagenow && 'post-new.php' !== $pagenow && ! $is_hustle_wizard ) \|\| $is_restricted_post_type ) { return; } add_action( 'media_buttons', array( $this, 'attach_button' ) ); add_action( 'admin_footer', array( $this, 'enqueue_js_scripts' ) ); if ( $is_hustle_wizard ) { add_action( 'admin_footer', array( $this, 'enqueue_preview_scripts_for_hustle' ) ); } } /* * Check if current page is Hustle wizard page * * @since 1.0.5 * * @return bool / public function is_hustle_wizard() { $page = Forminator_Core::sanitize_text_field( 'page' ); // Hustle wizard pages. $pages = array( 'hustle_popup', 'hustle_slidein', 'hustle_embedded', 'hustle_sshare', ); // Check if current page is hustle wizard page. if ( $page && in_array( $page, $pages, true ) ) { return true; } return false; } /* * Check if current page is in restricted post type * * @since 1.32.0 * * @return bool / public function is_restricted_post_type() { $post_type = Forminator_Core::sanitize_text_field( 'post_type' ); if ( ! $post_type ) { $post_type = get_post_type( Forminator_Core::sanitize_text_field( 'post' ) ); } // Restricted post types. $post_types = array( 'cfs' ); // Filter to include more post types. $post_types = apply_filters( 'forminator_exclude_shortcode_generator_post_types', $post_types ); // Check if current page is a restricted post type page. if ( $post_type && in_array( $post_type, $post_types, true ) ) { return true; } return false; } /* * Attach button * * @since 1.0 / public function attach_button() { // Button markup. printf( '<button type="button" id="%s" class="button" data-editor="content" data-a11y-dialog-show="forminator-popup">%s<span>%s</span></button>', 'forminator-generate-shortcode', '<i class="forminator-scgen-icon" aria-hidden="true"></i>', esc_html__( 'Add Form', 'forminator' ) ); } /* * Enqueue JS * * @since 1.0 * @param string $content Content. * * @return mixed / public function enqueue_js_scripts( $content ) { $sui_version = FORMINATOR_SUI_VERSION; $sanitize_version = str_replace( '.', '-', $sui_version ); $sui_body_class = "sui-$sanitize_version"; wp_enqueue_script( 'jquery-ui-core' ); wp_enqueue_script( 'jquery-ui-widget' ); wp_enqueue_script( 'jquery-ui-mouse' ); wp_enqueue_script( 'jquery-ui-tabs' ); // Get shortcode generator styles. wp_enqueue_style( 'forminator-shortcode-generator-styles', forminator_plugin_url() . 'build/css/forminator-scgen.min.css', array(), FORMINATOR_VERSION ); // Get SUI JS. $sui_handle = 'shared-ui'; wp_enqueue_script( $sui_handle, forminator_plugin_url() . 'build/js/shared-ui.min.js', array( 'jquery', 'clipboard' ), $sui_body_class, true ); // Get shortcode generator scripts. wp_enqueue_script( 'forminator-shortcode-generator', forminator_plugin_url() . 'build/admin/scgen.min.js', array( 'jquery' ), FORMINATOR_VERSION, false ); wp_localize_script( 'forminator-shortcode-generator', 'forminatorScgenData', array( 'suiVersion' => $sui_body_class, ) ); $this->print_markup(); ?> <script type="text/javascript"> jQuery(function () { jQuery("#forminator-generate-shortcode").on( 'click', function(e) { e.preventDefault(); }); }); </script> <?php } /* * Enqueue preview scripts for Hustle. * * @since 1.0 * @param string $content Content. * * @return mixed / public function enqueue_preview_scripts_for_hustle( $content ) { /* * Forminator UI * These stylesheets currently works with "forms" only. * * @since 1.7.0 / Forminator_Assets_Enqueue::fui_enqueue_style( 'forminator-scgen-global', forminator_plugin_url() . 'assets/forminator-ui/css/forminator-global.min.css', array(), FORMINATOR_VERSION ); Forminator_Assets_Enqueue::fui_enqueue_style( 'forminator-scgen-icons', forminator_plugin_url() . 'assets/forminator-ui/css/forminator-icons.min.css', array(), FORMINATOR_VERSION ); Forminator_Assets_Enqueue::fui_enqueue_style( 'forminator-scgen-forms', forminator_plugin_url() . 'assets/forminator-ui/css/forminator-forms.min.css', array(), FORMINATOR_VERSION ); } /* * Print modal markup * * @since 1.0 / public function print_markup() { ?> <div id="forminator-scgen-modal" class="sui-wrap" style="display:none;"> <div class="sui-modal sui-modal-md"> <div role="dialog" id="forminator-popup" class="sui-modal-content" aria-modal="true" aria-labelledby="scgenDialogTitle" aria-describedby="scgenDialogDescription" > <div class="sui-box" style="margin-bottom: 0;"> <div class="sui-box-header sui-flatten sui-content-center sui-spacing-top--60"> <h3 id="scgenDialogTitle" class="sui-box-title sui-lg"><?php esc_html_e( 'Forminator Shortcodes', 'forminator' ); ?></h3> <p id="scgenDialogDescription" class="sui-description"><?php esc_html_e( 'Select an option from the dropdown menu and generate a shortcode to insert in your post or page.', 'forminator' ); ?></p> <button class="sui-modal-skip sui-button-icon sui-button-float--right sui-dialog-close" data-modal-close=""> <span class="sui-icon-close sui-md" aria-hidden="true"></span> <span class="sui-screen-reader-text"><?php esc_html_e( 'Close this dialog window.', 'forminator' ); ?></span> </button> </div> <div class="sui-box-body sui-box-body-slim"> <div class="sui-tabs sui-tabs-flushed"> <?php if ( isset( $_GET['page'] ) && 'hustle_popup' === $_GET['page'] ) : / phpcs:ignore WordPress.Security.NonceVerification.Recommended / ?> <div role="tablist" class="sui-tabs-menu"> <button id="forminator-shortcode-type--forms" type="button" role="tab" class="sui-tab-item active" aria-controls="forminator-custom-forms" aria-selected="true" > <?php esc_html_e( 'Forms', 'forminator' ); ?> </button> <button id="forminator-shortcode-type--polls" type="button" role="tab" class="sui-tab-item" aria-controls="forminator-polls" aria-selected="false" tabindex="-1" > <?php esc_html_e( 'Polls', 'forminator' ); ?> </button> <button id="forminator-shortcode-type--quizzes" type="button" role="tab" class="sui-tab-item" aria-controls="forminator-quizzes" aria-selected="false" tabindex="-1" > <?php esc_html_e( 'Quizzes', 'forminator' ); ?> </button> </div> <div class="sui-tabs-content"> <!-- Forms --> <div role="tabpanel" tabindex="0" id="forminator-custom-forms" class="sui-tab-content active" aria-labelledby="forminator-shortcode-type--forms" > <div class="sui-form-field"> <label for="forminator-select-forms" class="sui-label"><?php esc_html_e( 'Choose an option', 'forminator' ); ?></label> <?php echo $this->get_forms(); / phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped / ?> <span class="sui-error-message" style="display: none;"><?php esc_html_e( 'Please, select an option before you proceed.', 'forminator' ); ?></span> </div> <div class="fui-simulate-footer"> <button class="sui-button sui-button-blue wpmudev-insert-cform"> <i class="sui-icon-loader sui-loading" aria-hidden="true"></i> <span class="sui-loading-text"><?php esc_html_e( 'Generate Shortcode', 'forminator' ); ?></span> </button> </div> </div> <!-- Polls --> <div role="tabpanel" tabindex="0" id="forminator-polls" class="sui-tab-content" aria-labelledby="forminator-shortcode-type--polls" hidden > <div class="sui-form-field"> <label for="forminator-select-forms" class="sui-label"><?php esc_html_e( 'Choose an option', 'forminator' ); ?></label> <?php echo $this->get_polls(); / phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped / ?> <span class="sui-error-message" style="display: none;"><?php esc_html_e( 'Please, select an option before you proceed.', 'forminator' ); ?></span> </div> <div class="fui-simulate-footer"> <button class="sui-button sui-button-blue wpmudev-insert-poll"> <i class="sui-icon-loader sui-loading" aria-hidden="true"></i> <span class="sui-loading-text"><?php esc_html_e( 'Generate Shortcode', 'forminator' ); ?></span> </button> </div> </div> <!-- Quizzes --> <div role="tabpanel" tabindex="0" id="forminator-quizzes" class="sui-tab-content" aria-labelledby="forminator-shortcode-type--quizzes" hidden > <div class="sui-form-field"> <label for="forminator-select-forms" class="sui-label"><?php esc_html_e( 'Choose an option', 'forminator' ); ?></label> <?php echo $this->get_quizzes(); / phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped / ?> <span class="sui-error-message" style="display: none;"><?php esc_html_e( 'Please, select an option before you proceed.', 'forminator' ); ?></span> </div> <div class="fui-simulate-footer"> <button class="sui-button sui-button-blue wpmudev-insert-quiz"> <i class="sui-icon-loader sui-loading" aria-hidden="true"></i> <span class="sui-loading-text"><?php esc_html_e( 'Generate Shortcode', 'forminator' ); ?></span> </button> </div> </div> </div> <?php else : ?> <div data-tabs> <div id="forminator-shortcode-type--forms" class="active"><?php esc_html_e( 'Forms', 'forminator' ); ?></div> <div id="forminator-shortcode-type--polls"><?php esc_html_e( 'Polls', 'forminator' ); ?></div> <div id="forminator-shortcode-type--quizzes"><?php esc_html_e( 'Quizzes', 'forminator' ); ?></div> </div> <div data-panes> <!-- Forms --> <div id="forminator-custom-forms" class="active"> <div class="sui-form-field"> <label for="forminator-select-forms" class="sui-label"><?php esc_html_e( 'Choose an option', 'forminator' ); ?></label> <?php echo $this->get_forms(); / phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped / ?> <span class="sui-error-message" style="display: none;"><?php esc_html_e( 'Please, select an option before you proceed.', 'forminator' ); ?></span> </div> <div class="fui-simulate-footer"> <button class="sui-button sui-button-blue wpmudev-insert-cform"> <i class="sui-icon-loader sui-loading" aria-hidden="true"></i> <span class="sui-loading-text"><?php esc_html_e( 'Generate Shortcode', 'forminator' ); ?></span> </button> </div> </div> <!-- Polls --> <div id="forminator-polls"> <div class="sui-form-field"> <label for="forminator-select-forms" class="sui-label"><?php esc_html_e( 'Choose an option', 'forminator' ); ?></label> <?php echo $this->get_polls(); / phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped / ?> <span class="sui-error-message" style="display: none;"><?php esc_html_e( 'Please, select an option before you proceed.', 'forminator' ); ?></span> </div> <div class="fui-simulate-footer"> <button class="sui-button sui-button-blue wpmudev-insert-poll"> <i class="sui-icon-loader sui-loading" aria-hidden="true"></i> <span class="sui-loading-text"><?php esc_html_e( 'Generate Shortcode', 'forminator' ); ?></span> </button> </div> </div> <!-- Quizzes --> <div id="forminator-quizzes"> <div class="sui-form-field"> <label for="forminator-select-forms" class="sui-label"><?php esc_html_e( 'Choose an option', 'forminator' ); ?></label> <?php echo $this->get_quizzes(); / phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped / ?> <span class="sui-error-message" style="display: none;"><?php esc_html_e( 'Please, select an option before you proceed.', 'forminator' ); ?></span> </div> <div class="fui-simulate-footer"> <button class="sui-button sui-button-blue wpmudev-insert-quiz"> <i class="sui-icon-loader sui-loading" aria-hidden="true"></i> <span class="sui-loading-text"><?php esc_html_e( 'Generate Shortcode', 'forminator' ); ?></span> </button> </div> </div> </div> <?php endif; ?> </div> </div> </div> </div> </div> </div> <?php } /* * Print forms select * * @since 1.0 * @return string / public function get_forms() { $html = ''; $modules = Forminator_API::get_forms( null, 1, 999 ); $search = ( count( $modules ) > 4 ) ? 'true' : 'false'; $placeholder = esc_html__( 'Select Custom Form', 'forminator' ); $html .= '<select id="forminator-select-forms" name="forms" class="sui-select forminator-custom-form-list" data-placeholder="' . $placeholder . '" data-search="' . $search . '">'; $html .= '<option></option>'; foreach ( $modules as $module ) { $module = (array) $module; $title = forminator_get_form_name( $module['id'] ); if ( mb_strlen( $title ) > 25 ) { $title = mb_substr( $title, 0, 25 ) . '...'; } $html .= '<option value="' . absint( $module['id'] ) . '">' . esc_html( $title ) . ' - ID: ' . absint( $module['id'] ) . '</option>'; } $html .= '</select>'; return $html; } /* * Print polls select * * @since 1.0 * @return string / public function get_polls() { $html = ''; $modules = Forminator_API::get_polls( null, 1, 999 ); $search = ( count( $modules ) > 4 ) ? 'true' : 'false'; $placeholder = esc_html__( 'Select Poll', 'forminator' ); $html .= '<select id="forminator-select-polls" name="forms" class="sui-select forminator-insert-poll" data-placeholder="' . $placeholder . '" data-search="' . $search . '">'; $html .= '<option></option>'; foreach ( $modules as $module ) { $module = (array) $module; $title = forminator_get_form_name( $module['id'] ); if ( mb_strlen( $title ) > 25 ) { $title = mb_substr( $title, 0, 25 ) . '...'; } $html .= '<option value="' . absint( $module['id'] ) . '">' . esc_html( $title ) . ' - ID: ' . absint( $module['id'] ) . '</option>'; } $html .= '</select>'; return $html; } /* * Print quizzes select * * @since 1.0 * @return string */ public function get_quizzes() { $html = ''; $modules = Forminator_API::get_quizzes( null, 1, 999 ); $search = ( count( $modules ) > 4 ) ? 'true' : 'false'; $placeholder = esc_html__( 'Select Quiz', 'forminator' ); $html .= '<select id="forminator-select-quizzes" name="forms" class="sui-select forminator-quiz-list" data-placeholder="' . $placeholder . '" data-search="' . $search . '">'; $html .= '<option value="">' . esc_html__( 'Select Quiz', 'forminator' ) . '</option>'; foreach ( $modules as $module ) { $module = (array) $module; $title = forminator_get_form_name( $module['id'] ); if ( mb_strlen( $title ) > 25 ) { $title = mb_substr( $title, 0, 25 ) . '...'; } $html .= '<option value="' . absint( $module['id'] ) . '">' . esc_html( $title ) . ' - ID: ' . absint( $module['id'] ) . '</option>'; } $html .= '</select>'; return $html; } }	16.43 KB	2026-01-12 18:46
📄 class-template-api.php <?php /** * Forminator Template API * * @package Forminator / /* * Class Forminator_Template_API / class Forminator_Template_API { /* * API key * * @var string / private static ?string $api_key = null; /* * Singleton instance * * @var Forminator_Template_API / private static ?Forminator_Template_API $instance = null; /* * Get instance of this class. * * @return Forminator_Template_API / public static function get_instance(): Forminator_Template_API { if ( is_null( self::$instance ) ) { self::$instance = new self(); } return self::$instance; } /* * Constructor / private function __construct() {} /* * Get API key * * @return string / private static function get_api_key() { if ( is_null( self::$api_key ) ) { if ( class_exists( 'WPMUDEV_Dashboard' ) ) { self::$api_key = WPMUDEV_Dashboard::$api->get_key(); } elseif ( Forminator_Hub_Connector::hub_connector_connected() ) { self::$api_key = \WPMUDEV\Hub\Connector\API::get()->get_api_key(); } } return self::$api_key; } /* * Check if connected to Hub * * @return bool / public static function is_connected(): bool { return FORMINATOR_PRO && ! empty( self::get_api_key() ); } /* * Get templates * * @param bool $is_official - official or custom cloud templates. * @param int $page_number - page number. * @param string $category - template category. * @param string $search - search term. * @return array / public static function get_templates( bool $is_official, int $page_number = 0, string $category = '', string $search = '' ): array { /* * Filter templates per page * * @param int $per_page - templates per page. / $per_page = apply_filters( 'forminator_templates_per_page', 100 ); $args = array( 'is_official' => $is_official ? 1 : 0, 'per_page' => $per_page, ); if ( $is_official ) { $args['order_by'] = 'name'; $args['order'] = 'ASC'; } if ( $category ) { $args['category'] = $category; } if ( $search ) { $args['search'] = $search; } if ( $page_number ) { $args['page'] = $page_number; } $templates = self::request( 'api/hub/v1/forminator-templates', 'GET', $args ); $templates = self::prepare_templates_structure( $templates ); /* * Filter templates * * @param array $templates - templates. * @param bool $is_official - official or custom templates. * @param int $page_number - page number. * @param string $search - search term. * @param string $category - template category. / return apply_filters( 'forminator_templates', $templates, $is_official, $page_number, $search, $category ); } /* * Get template * * @param int $id - template id. * * @return array / public static function get_template( int $id ): array { $template = self::request( 'api/hub/v1/forminator-templates/' . $id, 'GET' ); return self::prepare_template_structure( $template ); } /* * Prepare templates structure * * @param array $templates - templates. * * @return array / private static function prepare_templates_structure( array $templates ): array { foreach ( $templates as $key => $template ) { $templates[ $key ] = self::prepare_template_structure( $template ); } return $templates; } /* * Prepare template structure * * @param array $template - template. * * @return array / private static function prepare_template_structure( array $template ): array { if ( empty( $template ) ) { return $template; } $template['id'] = $template['template_id']; $template['category'] = $template['category']['slug']; $template['screenshot'] = $template['thumbnail']['original'] ?? ''; $template['thumbnail'] = $template['thumbnail']['original'] ?? ''; $template['pro'] = true; return $template; } /* * Create template * * @param string $name - template name. * @param string $json - template config. * @param string $description - template description. * * @return array / public static function create_template( string $name, string $json, string $description = '' ): array { if ( ! forminator_is_user_allowed( 'forminator-templates' ) ) { return array(); } $args = self::prepare_template_args( $name, $json, $description ); $response = self::request( 'api/hub/v1/forminator-templates', 'POST', $args ); return self::prepare_template_structure( $response ); } /* * Update template * * @param int $id - template id. * @param string $name - template name. * @param string $json - template config. * @param string $description - template description. * * @return array / public static function update_template( int $id, string $name, string $json, string $description = '' ): array { if ( ! forminator_is_user_allowed( 'forminator-templates' ) ) { return array(); } $args = self::prepare_template_args( $name, $json, $description ); $response = self::request( 'api/hub/v1/forminator-templates/' . $id, 'POST', $args ); return self::prepare_template_structure( $response ); } /* * Prepare update template args * * @param string $name - template name. * @param string $json - template config. * @param string $description - template description. * * @return array / private static function prepare_template_args( string $name, string $json, string $description ): array { $args = array(); if ( $json ) { $args = array( 'config' => $json, ); } if ( $name ) { $args['name'] = $name; } if ( $description ) { $args['description'] = $description; } return $args; } /* * Delete template * * @param int $id - template id. * * @return bool / public static function delete_template( int $id ): bool { if ( ! forminator_is_user_allowed( 'forminator-templates' ) ) { return false; } $response = self::request( 'api/hub/v1/forminator-templates/' . $id, 'DELETE' ); return $response['removed'] ?? false; } /* * Get template categories * * @return array / public static function get_categories(): array { $categories = self::request( 'api/hub/v1/forminator-templates/categories', 'GET' ); return $categories; } /* * Remote request * * @param string $endpoint - API endpoint. * @param string $method - HTTP method. * @param array $data - request data. * * @return array */ private static function request( string $endpoint, string $method, array $data = array() ): array { $base = 'https://wpmudev.com/'; // Support custom API base. if ( defined( 'WPMUDEV_CUSTOM_API_SERVER' ) && ! empty( WPMUDEV_CUSTOM_API_SERVER ) ) { $base = trailingslashit( WPMUDEV_CUSTOM_API_SERVER ); } $url = $base . $endpoint; $args = array( 'method' => $method, ); try { if ( class_exists( 'WPMUDEV_Dashboard' ) && method_exists( WPMUDEV_Dashboard::$api, 'get_site_id' ) ) { $data['site_id'] = WPMUDEV_Dashboard::$api->get_site_id(); } elseif ( Forminator_Hub_Connector::hub_connector_logged_in() ) { $data['site_id'] = \WPMUDEV\Hub\Connector\Data::get()->hub_site_id(); } if ( 'GET' === $method ) { $url = add_query_arg( $data, $url ); } else { $args['body'] = $data; } $api_key = self::get_api_key(); if ( $api_key ) { $args['headers'] = array( 'Authorization' => $api_key, ); } $response = wp_remote_request( $url, $args ); if ( is_wp_error( $response ) \|\| 200 !== wp_remote_retrieve_response_code( $response ) ) { return array(); } $body = wp_remote_retrieve_body( $response ); } catch ( Exception $e ) { return array(); } $result = json_decode( $body, true ); if ( is_array( $result ) ) { return $result; } return array(); } }	7.69 KB	2026-01-12 18:46
📄 class-upgrade.php <?php /** * Forminator Upgrade * * @package Forminator / if ( ! defined( 'ABSPATH' ) ) { die(); } /* * Class Forminator_Upgrade * * Handle any installation upgrade or install tasks / class Forminator_Upgrade { /* * Initialise data before plugin is fully loaded * * @since 1.0 / public static function init() { /* * Initialize the plugin data / $old_version = get_option( 'forminator_version', false ); if ( $old_version ) { $version_changed = version_compare( $old_version, FORMINATOR_VERSION, 'lt' ); if ( $version_changed ) { update_option( 'forminator_version_upgraded', true ); } } else { $version_changed = true; } if ( $version_changed ) { // Update tables if required. Forminator_Database_Tables::install_database_tables(); Forminator_Database_Tables::insert_default_entries(); // Run status migration on version update. add_action( 'forminator_update_version', array( 'Forminator_Database_Tables', 'maybe_migrate_entry_status' ), 10, 2 ); add_action( 'admin_init', array( __CLASS__, 'flush_rewrite' ) ); // Update version. update_option( 'forminator_version', FORMINATOR_VERSION ); add_action( 'forminator_loaded', function () use ( $old_version ) { /* * Triggered when Forminator version is updated * * @param string FORMINATOR_VERSION New plugin version * @param string $old_version Old plugin version. / do_action( 'forminator_update_version', FORMINATOR_VERSION, $old_version ); } ); } } /* * Flush rewrite * * @return void */ public static function flush_rewrite() { // Flush rewrite rules. flush_rewrite_rules(); } }	1.66 KB	2026-01-12 18:46
📁 external	-	2026-01-12 18:46
📁 field-autofill-providers	-	2026-01-12 18:46
📁 fields	-	2026-01-12 18:46
📁 gateways	-	2026-01-12 18:46
📁 helpers	-	2026-01-12 18:46
📁 lib	-	2026-01-12 18:46
📁 mixpanel	-	2026-01-12 18:46
📁 model	-	2026-01-12 18:46
📁 modules	-	2026-01-12 18:46
📁 protection	-	2026-01-12 18:46
📁 render	-	2026-01-12 18:46

Edit File:

Terminal