- '. sprintf(__('View version %s Details', 'gravityforms'), $version_info["version"]) . ' . ' : '';
-
- echo '' . $new_version . __('
Register your copy of Gravity Forms to receive access to automatic upgrades and support. Need a license key?
Purchase one now .', 'gravityforms') . '
contact us .", 'gravityforms');
- }
- else{
- $page_text = $raw_response['body'];
- if(substr($page_text, 0, 10) != "")
- $page_text = "";
- }
- return stripslashes($page_text);
- }
-
-//------------------------------------------------------
-//-------------- DASHBOARD PAGE -------------------------
-
- //Registers the dashboard widget
- public static function dashboard_setup(){
- $dashboard_title = apply_filters("gform_dashboard_title", __("Forms", "gravityforms"));
- wp_add_dashboard_widget('rg_forms_dashboard', $dashboard_title, array('RGForms', 'dashboard'));
- }
-
- //Displays the dashboard UI
- public static function dashboard(){
- $forms = RGFormsModel::get_form_summary();
-
- if(sizeof($forms) > 0){
- ?>
-
-
-
-
-
-
-
- ', ''); ?>
-
- ", "");
- }*/
- $message = sprintf(__("There is an update available for Gravity Forms. %sView Details%s %s", "gravityforms"), "", " ", $auto_upgrade);
- ?>
-
-
- __( 'Next >', "gravityforms" ),
- 'prev' => __( '< Prev', "gravityforms" ),
- 'image' => __( 'Image', "gravityforms" ),
- 'of' => __( 'of', "gravityforms" ),
- 'close' => __( 'Close', "gravityforms" ),
- 'noiframes' => __( 'This feature requires inline frames. You have iframes disabled or your browser does not support them.' , 'gravityforms'),
- 'loadingAnimation' => includes_url( 'js/thickbox/loadingAnimation.gif' ),
- 'closeImage' => includes_url( 'js/thickbox/tb-close.png' )
- ) );
- }
-
- public static function enqueue_admin_scripts() {
-
- $scripts = array();
- $page = self::get_page();
-
- switch($page) {
- case 'new_form' :
- case 'form_list':
- $scripts = array(
- 'gform_gravityforms',
- 'gform_json',
- 'gform_form_admin',
- 'thickbox'
- );
- break;
-
- case 'form_settings':
- $scripts = array(
- 'gform_gravityforms',
- 'gform_forms',
- 'gform_json',
- 'gform_form_admin',
- 'gform_placeholder',
- 'jquery-ui-datepicker',
- 'gform_masked_input',
- 'jquery-ui-sortable'
- );
- break;
-
- case 'form_editor':
- $thickbox = !GFCommon::is_wp_version("3.3") ? 'gf_thickbox' : 'thickbox';
- $scripts = array(
- $thickbox,
- 'jquery-ui-core',
- 'jquery-ui-sortable',
- 'jquery-ui-tabs',
- 'sack',
- 'gform_gravityforms',
- 'gform_forms',
- 'gform_json',
- 'gform_form_admin',
- 'gform_floatmenu',
- 'gform_menu',
- 'gform_placeholder',
- 'jquery-ui-autocomplete'
- );
-
- if ( wp_is_mobile() )
- $scripts[] = 'jquery-touch-punch';
-
- break;
-
- case 'entry_detail':
- $scripts = array('gform_json');
- break;
-
- case 'entry_detail_edit':
- $scripts = array('gform_gravityforms','plupload-all');
- break;
-
- case 'entry_list':
- $scripts = array(
- 'wp-lists',
- 'wp-ajax-response',
- 'thickbox',
- 'gform_json',
- 'thickbox',
- 'gform_field_filter'
- );
- break;
-
- case 'notification_list':
- $scripts = array(
- 'gform_forms',
- 'gform_json',
- 'gform_form_admin'
- );
- break;
-
- case 'notification_new':
- case 'notification_edit':
- $scripts = array(
- 'jquery-ui-autocomplete',
- 'gform_gravityforms',
- 'gform_placeholder',
- 'gform_form_admin',
- 'gform_forms',
- 'gform_json'
- );
- break;
-
- case 'confirmation':
- $scripts = array(
- 'gform_form_admin',
- 'gform_forms',
- 'gform_gravityforms',
- 'gform_placeholder',
- 'gform_json',
- 'wp-pointer'
- );
- break;
-
- case 'addons':
- $scripts = array('thickbox');
- break;
-
- case 'export_entry':
- $scripts = array(
- 'jquery-ui-datepicker',
- 'gform_form_admin',
- 'gform_field_filter'
- );
- break;
-
- }
-
- if(empty($scripts))
- return;
-
- foreach($scripts as $script){
- wp_enqueue_script($script);
- }
-
-
- GFCommon::localize_gform_gravityforms_multifile();
-
-
- }
-
- public static function get_page() {
-
- /**
- * Page names:
- *
- * new_form
- * form_list
- * form_editor
- * form_settings
- * confirmation
- * notification_list
- * notification_new
- * notification_edit
- * entry_list
- * entry_detail
- * entry_detail_edit
- * settings
- * addons
- * export_entry
- * export_form
- * import_form
- */
-
- if( rgget('page') == 'gf_new_form' )
- return 'new_form';
-
- if( rgget('page') == 'gf_edit_forms' && !rgget('id') )
- return 'form_list';
-
- if( rgget('page') == 'gf_edit_forms' && !rgget('view') )
- return 'form_editor';
-
- if( rgget('page') == 'gf_edit_forms' && rgget('view') == 'settings' && ( !rgget('subview') || rgget('subview') == 'settings') )
- return 'form_settings';
-
- if( rgget('page') == 'gf_edit_forms' && rgget('view') == 'settings' && rgget('subview') == 'confirmation' )
- return 'confirmation';
-
- if( rgget('page') == 'gf_edit_forms' && rgget('view') == 'settings' && rgget('subview') == 'notification' && rgget('nid') )
- return 'notification_edit';
-
- if( rgget('page') == 'gf_edit_forms' && rgget('view') == 'settings' && rgget('subview') == 'notification' && isset($_GET['nid']) )
- return 'notification_edit';
-
- if( rgget('page') == 'gf_edit_forms' && rgget('view') == 'settings' && rgget('subview') == 'notification' )
- return 'notification_list';
-
- if( rgget('page') == 'gf_entries' && (!rgget('view') || rgget('view') == 'entries' ) )
- return 'entry_list';
-
- if( rgget('page') == 'gf_entries' && rgget('view') == 'entry' && isset($_POST['screen_mode']) && rgpost('screen_mode') != 'view')
- return 'entry_detail_edit';
-
- if( rgget('page') == 'gf_entries' && rgget('view') == 'entry')
- return 'entry_detail';
-
- if( rgget('page') == 'gf_settings')
- return 'settings';
-
- if(rgget('page') == 'gf_addons')
- return 'addons';
-
- if(rgget('page') == 'gf_export' && ( rgget('view') == 'export_entry' || !isset($_GET['view']) ) )
- return 'export_entry';
-
- if(rgget('page') == 'gf_export' && rgget('view') == 'export_form')
- return 'export_form';
-
- if(rgget('page') == 'gf_export' && rgget('view') == 'import_form')
- return 'import_form';
-
- return false;
- }
-
- public static function get_form($form_id, $display_title=true, $display_description=true, $force_display=false, $field_values=null, $ajax=false, $tabindex = 1){
- require_once(GFCommon::get_base_path() . "/form_display.php");
- return GFFormDisplay::get_form($form_id, $display_title, $display_description, $force_display, $field_values, $ajax, $tabindex);
- }
-
- public static function new_form(){
- self::form_list_page();
- }
-
- public static function enqueue_scripts(){
- require_once(GFCommon::get_base_path() . "/form_display.php");
- GFFormDisplay::enqueue_scripts();
- }
-
- public static function print_form_scripts($form, $ajax){
- require_once(GFCommon::get_base_path() . "/form_display.php");
- GFFormDisplay::print_form_scripts($form, $ajax);
- }
-
- public static function forms_page($form_id){
- require_once(GFCommon::get_base_path() . "/form_detail.php");
- GFFormDetail::forms_page($form_id);
- }
-
- public static function settings_page(){
- require_once(GFCommon::get_base_path() . "/settings.php");
- GFSettings::settings_page();
- }
-
- public static function add_settings_page( $name, $handle = '', $icon_path = '' ){
- require_once(GFCommon::get_base_path() . "/settings.php");
- GFSettings::add_settings_page($name, $handle, $icon_path);
- }
-
- public static function help_page(){
- require_once(GFCommon::get_base_path() . "/help.php");
- GFHelp::help_page();
- }
-
- public static function export_page(){
- require_once(GFCommon::get_base_path() . "/export.php");
- GFExport::export_page();
- }
-
- public static function update_page(){
- require_once(GFCommon::get_base_path() . "/update.php");
- GFUpdate::update_page();
- }
-
- public static function addons_page(){
-
- wp_print_styles(array("thickbox"));
-
- $plugins = get_plugins();
- $installed_plugins = array();
- foreach($plugins as $key => $plugin){
- $is_active = is_plugin_active($key);
- $installed_plugin = array("plugin" => $key, "name" => $plugin["Name"], "is_active"=>$is_active);
- $installed_plugin["activation_url"] = $is_active ? "" : wp_nonce_url("plugins.php?action=activate&plugin={$key}", "activate-plugin_{$key}");
- $installed_plugin["deactivation_url"] = !$is_active ? "" : wp_nonce_url("plugins.php?action=deactivate&plugin={$key}", "deactivate-plugin_{$key}");
-
- $installed_plugins[] = $installed_plugin;
- }
-
- $nonces = self::get_addon_nonces();
-
- $body = array("plugins" => urlencode(serialize($installed_plugins)), "nonces" => urlencode(serialize($nonces)), "key" => GFCommon::get_key());
- $options = array('body' => $body, 'headers' => array('Referer' => get_bloginfo("url")), 'timeout' => 15);
-
- $raw_response = GFCommon::post_to_manager("api.php", "op=plugin_browser&{$_SERVER["QUERY_STRING"]}", $options);
-
- if ( is_wp_error( $raw_response ) || $raw_response['response']['code'] != 200){
- echo "" . __("Add-On browser is currently unavailable. Please try again later.", "gravityforms") . "
";
- }
- else{
- echo GFCommon::get_remote_message();
- echo $raw_response["body"];
- }
- }
-
- public static function get_addon_info($api, $action, $args){
-
- if($action == "plugin_information" && empty($api) && ( !rgempty("rg", $_GET) || $args->slug == 'gravityforms')){
- $raw_response = GFCommon::post_to_manager("api.php", "op=get_plugin&slug={$args->slug}", array());
-
- if ( is_wp_error( $raw_response ) || $raw_response['response']['code'] != 200)
- return false;
-
- $plugin = unserialize($raw_response["body"]);
-
- $api = new stdClass();
- $api->name = $plugin["title"];
- $api->version = $plugin["version"];
- $api->download_link = $plugin["download_url"];
- $api->tested = '10.0';
- }
- return $api;
- }
-
- public static function get_addon_nonces(){
- $raw_response = GFCommon::post_to_manager("api.php", "op=get_plugins", array());
-
- if ( is_wp_error( $raw_response ) || $raw_response['response']['code'] != 200)
- return false;
-
- $addons = unserialize($raw_response["body"]);
- $nonces = array();
- foreach($addons as $addon){
- $nonces[$addon["key"]] = wp_create_nonce("install-plugin_{$addon["key"]}");
- }
-
- return $nonces;
- }
-
- public static function start_export(){
- require_once(GFCommon::get_base_path() . "/export.php");
- GFExport::start_export();
- }
-
- public static function get_post_category_values(){
- require_once(GFCommon::get_base_path() . "/form_detail.php");
- GFFormDetail::get_post_category_values();
- }
-
- public static function get_notification_post_category_values(){
- require_once(GFCommon::get_base_path() . "/notification.php");
- GFNotification::get_post_category_values();
- }
-
- public static function all_leads_page(){
-
- $view = rgget("view");
- $lead_id = rgget('lid');
-
- if($view == 'entry' && (rgget('lid') || !rgblank(rgget('pos')))) {
- require_once(GFCommon::get_base_path() . "/entry_detail.php");
- GFEntryDetail::lead_detail_page();
- } else if ($view == 'entries' || empty($view)){
- require_once(GFCommon::get_base_path() . "/entry_list.php");
- GFEntryList::all_leads_page();
- } else {
- $form_id = rgget('id');
- do_action("gform_entries_view", $view, $form_id, $lead_id);
- }
-
- }
-
- public static function form_list_page(){
- require_once(GFCommon::get_base_path() . "/form_list.php");
- GFFormList::form_list_page();
- }
-
- public static function forms(){
- if(!GFCommon::ensure_wp_version())
- return;
-
- $id = RGForms::get("id");
- $view = RGForms::get("view");
-
- if($view == "entries"){
- require_once(GFCommon::get_base_path() . "/entry_list.php");
- GFEntryList::leads_page($id);
- } else if($view == "entry"){
- require_once(GFCommon::get_base_path() . "/entry_detail.php");
- GFEntryDetail::lead_detail_page();
- } else if($view == "notification"){
- require_once(GFCommon::get_base_path() . "/notification.php");
- //GFNotification::notification_page($id);
- } else if($view == 'settings') {
- require_once(GFCommon::get_base_path() . "/form_settings.php");
- GFFormSettings::form_settings_page($id);
- } else if(empty($view)){
- if(is_numeric($id)){
- self::forms_page($id);
- } else{
- self::form_list_page();
- }
- }
-
- do_action("gform_view", $view, $id);
-
- }
-
- public static function get($name, $array=null){
- if(!$array)
- $array = $_GET;
-
- if(isset($array[$name]))
- return $array[$name];
-
- return "";
- }
-
- public static function post($name){
- if(isset($_POST[$name]))
- return $_POST[$name];
-
- return "";
- }
-
- // AJAX Function
- public static function resend_notifications(){
-
- check_admin_referer('gf_resend_notifications', 'gf_resend_notifications');
- $form_id = rgpost('formId');
- $leads = rgpost('leadIds'); // may be a single ID or an array of IDs
- if(0 == $leads){
- // get all the lead ids for the current filter / search
- $filter = rgpost("filter");
- $search = rgpost("search");
- $star = $filter == "star" ? 1 : null;
- $read = $filter == "unread" ? 0 : null;
- $status = in_array($filter, array("trash", "spam")) ? $filter : "active";
-
- $search_criteria["status"] = $status;
-
- if($star)
- $search_criteria["field_filters"][] = array("key" => "is_starred", "value" => (bool) $star );
- if(!is_null($read))
- $search_criteria["field_filters"][] = array("key" => "is_read", "value" => (bool) $read );
-
- $search_field_id = rgpost("fieldId");
-
- if(isset($_POST["fieldId"]) && $_POST["fieldId"] !== ''){
- $key = $search_field_id;
- $val = $search;
- $strpos_row_key = strpos($search_field_id, "|");
- if ($strpos_row_key !== false) { //multi-row
- $key_array = explode("|", $search_field_id);
- $key = $key_array[0];
- $val = $key_array[1] . ":" . $val;
- }
- $search_criteria["field_filters"][] = array(
- "key" => $key,
- "operator" => rgempty("operator", $_POST) ? "is" : rgpost("operator"),
- "value" => $val
- );
- }
-
- $leads = GFFormsModel::search_lead_ids($form_id, $search_criteria);
- } else {
- $leads = !is_array($leads) ? array($leads) : $leads;
- }
-
- $form = apply_filters("gform_before_resend_notifications_{$form_id}", apply_filters('gform_before_resend_notifications', RGFormsModel::get_form_meta($form_id), $leads), $leads);
-
- if(empty($leads) || empty($form)) {
- _e("There was an error while resending the notifications.", "gravityforms");
- die();
- };
-
- $notifications = json_decode(rgpost('notifications'));
- if(!is_array($notifications))
- die(__("No notifications have been selected. Please select a notification to be sent.", "gravityforms"));
-
- if( ! rgempty( 'sendTo', $_POST ) && ! GFCommon::is_valid_email_list(rgpost('sendTo')))
- die(__("The Send To email address provided is not valid.", "gravityforms"));
-
- foreach($leads as $lead_id){
-
- $lead = RGFormsModel::get_lead($lead_id);
- foreach($notifications as $notification_id){
- $notification = $form["notifications"][$notification_id];
- if(!$notification)
- continue;
-
- //overriding To email if one was specified
- if(rgpost('sendTo')){
- $notification["to"] = rgpost('sendTo');
- $notification["toType"] = "email";
- }
-
- GFCommon::send_notification($notification, $form, $lead);
- }
- }
-
- die();
- }
-
-//-------------------------------------------------
-//----------- AJAX CALLS --------------------------
- //captcha image
-
- public static function captcha_image(){
- $field = array("simpleCaptchaSize" => $_GET["size"], "simpleCaptchaFontColor"=> $_GET["fg"], "simpleCaptchaBackgroundColor"=>$_GET["bg"]);
- if($_GET["type"] == "math")
- $captcha = GFCommon::get_math_captcha($field, $_GET["pos"]);
- else
- $captcha = GFCommon::get_captcha($field);
-
- @ini_set('memory_limit', '256M');
- $image = imagecreatefrompng($captcha["path"]);
-
- include_once( ABSPATH . 'wp-admin/includes/image-edit.php' );
- wp_stream_image($image, "image/png", 0);
- imagedestroy($image);
- die();
- }
-
-
- public static function update_form_active(){
- check_ajax_referer('rg_update_form_active','rg_update_form_active');
- RGFormsModel::update_form_active($_POST["form_id"], $_POST["is_active"]);
- }
- public static function update_notification_active(){
- check_ajax_referer('rg_update_notification_active','rg_update_notification_active');
- RGFormsModel::update_notification_active($_POST["form_id"], $_POST["notification_id"], $_POST["is_active"]);
- }
- public static function update_confirmation_active(){
- check_ajax_referer('rg_update_confirmation_active','rg_update_confirmation_active');
- RGFormsModel::update_confirmation_active($_POST["form_id"], $_POST["confirmation_id"], $_POST["is_active"]);
- }
- public static function update_lead_property(){
- check_ajax_referer('rg_update_lead_property','rg_update_lead_property');
- RGFormsModel::update_lead_property($_POST["lead_id"], $_POST["name"], $_POST["value"]);
- }
-
- public static function update_lead_status(){
- check_ajax_referer('gf_delete_entry');
- $status = rgpost("status");
- $lead_id = rgpost("entry");
-
- switch($status){
- case "unspam" :
- //TODO: call akismet and set entry as not spam.
- RGFormsModel::update_lead_property($lead_id, "status", "active");
- break;
-
- case "delete" :
- if(GFCommon::current_user_can_any("gravityforms_delete_entries")){
- RGFormsModel::delete_lead($lead_id);
- }
- break;
-
- default :
- RGFormsModel::update_lead_property($lead_id, "status", $status);
- break;
- }
- header("Content-Type: text/xml");
- echo "{$icon} {$label} " . $sub_menu_str;
- if($compact){
- if ($key == "delete")
- $link = apply_filters("gform_form_delete_link", $link);
- $divider = $key == $last_key ? '' : " | ";
- if($count_sub_menu_items > 0)
- $menu_class .= " gf_form_action_has_submenu";
- $output .= '';
- } else {
-
- $output .= "";
- }
-
- }
- } elseif($compact) {
- //for backwards compatibility <1.7: form actions only
- $divider = $key == $last_key ? '' : " | ";
- $output .= ''. $menu_item . $divider . ' ';
- }
- }
-
- return $output;
- }
-
- public static function get_toolbar_menu_items($form_id, $compact = false){
- $menu_items = array();
-
- //---- Form Editor ----
- $edit_capabilities = array("gravityforms_edit_forms");
-
- $menu_items['edit'] = array(
- 'label' => $compact ? __("Edit", "gravityforms") : __("Form Editor", "gravityforms"),
- 'icon' => 'Upload folder is not writable. Export and file upload features will not be functional.
";
+ }
+ }
+
+ //Prints common admin scripts
+ public static function print_scripts() {
+ wp_enqueue_script( 'sack' );
+ wp_print_scripts();
+ }
+
+ public static function is_gravity_ajax_action() {
+ //Gravity Forms AJAX requests
+ $current_action = self::post( 'action' );
+ $gf_ajax_actions = array(
+ 'rg_save_form', 'rg_change_input_type', 'rg_refresh_field_preview', 'rg_add_field', 'rg_duplicate_field',
+ 'rg_delete_field', 'rg_select_export_form', 'rg_start_export', 'gf_upgrade_license',
+ 'gf_delete_custom_choice', 'gf_save_custom_choice', 'gf_get_notification_post_categories',
+ 'rg_update_lead_property', 'delete-gf_entry', 'rg_update_form_active', 'rg_update_notification_active',
+ 'rg_update_confirmation_active', 'gf_resend_notifications', 'rg_dismiss_upgrade', 'gf_save_confirmation',
+ );
+
+ if ( defined( 'DOING_AJAX' ) && DOING_AJAX && in_array( $current_action, $gf_ajax_actions ) ) {
+ return true;
+ }
+
+ //not a gravity forms ajax request.
+ return false;
+ }
+
+ //Returns true if the current page is one of Gravity Forms pages. Returns false if not
+ public static function is_gravity_page() {
+
+ //Gravity Forms pages
+ $current_page = trim( strtolower( self::get( 'page' ) ) );
+ $gf_pages = array( 'gf_edit_forms', 'gf_new_form', 'gf_entries', 'gf_settings', 'gf_export', 'gf_help' );
+
+ return in_array( $current_page, $gf_pages );
+ }
+
+ //Creates "Forms" left nav
+ public static function create_menu() {
+
+ $has_full_access = current_user_can( 'gform_full_access' );
+ $min_cap = GFCommon::current_user_can_which( GFCommon::all_caps() );
+ if ( empty( $min_cap ) ) {
+ $min_cap = 'gform_full_access';
+ }
+
+ $addon_menus = array();
+ $addon_menus = apply_filters( 'gform_addon_navigation', $addon_menus );
+
+ $parent_menu = self::get_parent_menu( $addon_menus );
+
+ // Add a top-level left nav
+ $update_icon = GFCommon::has_update() && current_user_can( 'install_plugins' ) ? "1
' . __( 'Add Form', 'gravityforms' ) . '
' . sprintf( __( 'View version %s Details', 'gravityforms' ), $version_info['version'] ) . ' . ' : '';
+
+ echo '' . $new_version . __( sprintf( '%sRegister%s your copy of Gravity Forms to receive access to automatic upgrades and support. Need a license key? %sPurchase one now%s.', '
', ' ', '
', ' ' ), 'gravityforms' ) . '
contact us .", 'gravityforms' );
+ } else {
+ $page_text = $raw_response['body'];
+ if ( substr( $page_text, 0, 10 ) != '' ) {
+ $page_text = '';
+ }
+ }
+
+ return stripslashes( $page_text );
+ }
+
+ //------------------------------------------------------
+ //-------------- DASHBOARD PAGE -------------------------
+
+ //Registers the dashboard widget
+ public static function dashboard_setup() {
+ $dashboard_title = apply_filters( 'gform_dashboard_title', __( 'Forms', 'gravityforms' ) );
+ wp_add_dashboard_widget( 'rg_forms_dashboard', $dashboard_title, array( 'RGForms', 'dashboard' ) );
+ }
+
+ //Displays the dashboard UI
+ public static function dashboard() {
+ $forms = RGFormsModel::get_form_summary();
+
+ if ( sizeof( $forms ) > 0 ) {
+ ?>
+
+
+
+
+
+
+
+ ', '' ); ?>
+
+ ", '');
+ }*/
+ $message = sprintf( __( 'There is an update available for Gravity Forms. %sView Details%s %s', 'gravityforms' ), "", ' ', $auto_upgrade );
+ ?>
+
+
+ __( 'Next >', 'gravityforms' ),
+ 'prev' => __( '< Prev', 'gravityforms' ),
+ 'image' => __( 'Image', 'gravityforms' ),
+ 'of' => __( 'of', 'gravityforms' ),
+ 'close' => __( 'Close', 'gravityforms' ),
+ 'noiframes' => __( 'This feature requires inline frames. You have iframes disabled or your browser does not support them.', 'gravityforms' ),
+ 'loadingAnimation' => includes_url( 'js/thickbox/loadingAnimation.gif' ),
+ 'closeImage' => includes_url( 'js/thickbox/tb-close.png' )
+ )
+ );
+ }
+
+ public static function enqueue_admin_scripts( $hook ) {
+
+ $scripts = array();
+ $page = self::get_page();
+
+ switch ( $page ) {
+ case 'new_form' :
+ case 'form_list':
+ $scripts = array(
+ 'gform_gravityforms',
+ 'gform_json',
+ 'gform_form_admin',
+ 'thickbox',
+ );
+ break;
+
+ case 'form_settings':
+ $scripts = array(
+ 'gform_gravityforms',
+ 'gform_forms',
+ 'gform_json',
+ 'gform_form_admin',
+ 'gform_placeholder',
+ 'jquery-ui-datepicker',
+ 'gform_masked_input',
+ 'jquery-ui-sortable',
+ );
+ break;
+
+ case 'form_editor':
+ $thickbox = ! GFCommon::is_wp_version( '3.3' ) ? 'gf_thickbox' : 'thickbox';
+ $scripts = array(
+ $thickbox,
+ 'jquery-ui-core',
+ 'jquery-ui-sortable',
+ 'jquery-ui-draggable',
+ 'jquery-ui-droppable',
+ 'jquery-ui-tabs',
+ 'sack',
+ 'gform_gravityforms',
+ 'gform_forms',
+ 'gform_json',
+ 'gform_form_admin',
+ 'gform_floatmenu',
+ 'gform_menu',
+ 'gform_placeholder',
+ 'jquery-ui-autocomplete',
+ );
+
+ if ( wp_is_mobile() ) {
+ $scripts[] = 'jquery-touch-punch';
+ }
+
+ break;
+
+ case 'entry_detail':
+ $scripts = array( 'gform_json' );
+ break;
+
+ case 'entry_detail_edit':
+ $scripts = array( 'gform_gravityforms', 'plupload-all' );
+ break;
+
+ case 'entry_list':
+ $scripts = array(
+ 'wp-lists',
+ 'wp-ajax-response',
+ 'thickbox',
+ 'gform_json',
+ 'thickbox',
+ 'gform_field_filter',
+ );
+ break;
+
+ case 'notification_list':
+ $scripts = array(
+ 'gform_forms',
+ 'gform_json',
+ 'gform_form_admin',
+ );
+ break;
+
+ case 'notification_new':
+ case 'notification_edit':
+ $scripts = array(
+ 'jquery-ui-autocomplete',
+ 'gform_gravityforms',
+ 'gform_placeholder',
+ 'gform_form_admin',
+ 'gform_forms',
+ 'gform_json',
+ );
+ break;
+
+ case 'confirmation':
+ $scripts = array(
+ 'gform_form_admin',
+ 'gform_forms',
+ 'gform_gravityforms',
+ 'gform_placeholder',
+ 'gform_json',
+ 'wp-pointer',
+ );
+ break;
+
+ case 'addons':
+ $scripts = array( 'thickbox' );
+ break;
+
+ case 'export_entry':
+ $scripts = array(
+ 'jquery-ui-datepicker',
+ 'gform_form_admin',
+ 'gform_field_filter',
+ );
+ break;
+ case 'updates' :
+ $scripts = array(
+ 'thickbox'
+ );
+
+ }
+
+ if ( in_array( $hook, array( 'post.php', 'post-new.php' ) ) ) {
+ //add_filter( 'gform_shortcode_preview_disabled', '__return_false' );
+ require_once( GFCommon::get_base_path() . '/tooltips.php' );
+ wp_enqueue_script( 'gform_shortcode_ui' );
+ wp_enqueue_style( 'gform_shortcode_ui' );
+ wp_localize_script( 'gform_shortcode_ui', 'gfShortcodeUIData', array(
+ 'shortcodes' => self::get_shortcodes(),
+ 'previewNonce' => wp_create_nonce( 'gf-shortcode-ui-preview' ),
+ 'previewDisabled' => apply_filters( 'gform_shortcode_preview_disabled', true ),
+ 'strings' => array(
+ 'pleaseSelectAForm' => __( 'Please select a form.', 'gravityforms' ),
+ )
+ ) );
+ }
+
+ if ( empty( $scripts ) ) {
+ return;
+ }
+
+ foreach ( $scripts as $script ) {
+ wp_enqueue_script( $script );
+ }
+
+
+ GFCommon::localize_gform_gravityforms_multifile();
+
+ }
+
+ /**
+ * Gets current page name
+ *
+ * @return bool|string Page name or false
+ * Page names:
+ *
+ * new_form
+ * form_list
+ * form_editor
+ * form_settings
+ * confirmation
+ * notification_list
+ * notification_new
+ * notification_edit
+ * entry_list
+ * entry_detail
+ * entry_detail_edit
+ * settings
+ * addons
+ * export_entry
+ * export_form
+ * import_form
+ * updates
+ */
+ public static function get_page() {
+
+ if ( rgget( 'page' ) == 'gf_new_form' ) {
+ return 'new_form';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && ! rgget( 'id' ) ) {
+ return 'form_list';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && ! rgget( 'view' ) ) {
+ return 'form_editor';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && rgget( 'view' ) == 'settings' && ( ! rgget( 'subview' ) || rgget( 'subview' ) == 'settings' ) ) {
+ return 'form_settings';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && rgget( 'view' ) == 'settings' && rgget( 'subview' ) == 'confirmation' ) {
+ return 'confirmation';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && rgget( 'view' ) == 'settings' && rgget( 'subview' ) == 'notification' && rgget( 'nid' ) ) {
+ return 'notification_edit';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && rgget( 'view' ) == 'settings' && rgget( 'subview' ) == 'notification' && isset( $_GET['nid'] ) ) {
+ return 'notification_edit';
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && rgget( 'view' ) == 'settings' && rgget( 'subview' ) == 'notification' ) {
+ return 'notification_list';
+ }
+
+ if ( rgget( 'page' ) == 'gf_entries' && ( ! rgget( 'view' ) || rgget( 'view' ) == 'entries' ) ) {
+ return 'entry_list';
+ }
+
+ if ( rgget( 'page' ) == 'gf_entries' && rgget( 'view' ) == 'entry' && isset( $_POST['screen_mode'] ) && $_POST['screen_mode'] == 'edit' ) {
+ return 'entry_detail_edit';
+ }
+
+ if ( rgget( 'page' ) == 'gf_entries' && rgget( 'view' ) == 'entry' ){
+ return 'entry_detail';
+ }
+
+ if ( rgget( 'page' ) == 'gf_settings' ) {
+ return 'settings';
+ }
+
+ if ( rgget( 'page' ) == 'gf_addons' ) {
+ return 'addons';
+ }
+
+ if ( rgget( 'page' ) == 'gf_export' && ( rgget( 'view' ) == 'export_entry' || ! isset( $_GET['view'] ) ) ) {
+ return 'export_entry';
+ }
+
+ if ( rgget( 'page' ) == 'gf_export' && rgget( 'view' ) == 'export_form' ) {
+ return 'export_form';
+ }
+
+ if ( rgget( 'page' ) == 'gf_export' && rgget( 'view' ) == 'import_form' ) {
+ return 'import_form';
+ }
+
+ if ( rgget( 'page' ) == 'gf_update' ) {
+ return 'updates';
+ }
+
+ return false;
+ }
+
+ public static function get_form( $form_id, $display_title = true, $display_description = true, $force_display = false, $field_values = null, $ajax = false, $tabindex = 1 ) {
+ require_once( GFCommon::get_base_path() . '/form_display.php' );
+
+ return GFFormDisplay::get_form( $form_id, $display_title, $display_description, $force_display, $field_values, $ajax, $tabindex );
+ }
+
+ public static function new_form() {
+ self::form_list_page();
+ }
+
+ public static function enqueue_scripts() {
+ require_once( GFCommon::get_base_path() . '/form_display.php' );
+ GFFormDisplay::enqueue_scripts();
+ }
+
+ public static function print_form_scripts( $form, $ajax ) {
+ require_once( GFCommon::get_base_path() . '/form_display.php' );
+ GFFormDisplay::print_form_scripts( $form, $ajax );
+ }
+
+ public static function forms_page( $form_id ) {
+ require_once( GFCommon::get_base_path() . '/form_detail.php' );
+ GFFormDetail::forms_page( $form_id );
+ }
+
+ public static function settings_page() {
+ require_once( GFCommon::get_base_path() . '/settings.php' );
+ GFSettings::settings_page();
+ }
+
+ public static function add_settings_page( $name, $handle = '', $icon_path = '' ) {
+ require_once( GFCommon::get_base_path() . '/settings.php' );
+ GFSettings::add_settings_page( $name, $handle, $icon_path );
+ }
+
+ public static function help_page() {
+ require_once( GFCommon::get_base_path() . '/help.php' );
+ GFHelp::help_page();
+ }
+
+ public static function export_page() {
+ require_once( GFCommon::get_base_path() . '/export.php' );
+ GFExport::export_page();
+ }
+
+ public static function update_page() {
+ require_once( GFCommon::get_base_path() . '/update.php' );
+ GFUpdate::update_page();
+ }
+
+ public static function addons_page() {
+
+ wp_print_styles( array( 'thickbox' ) );
+
+ $plugins = get_plugins();
+ $installed_plugins = array();
+ foreach ( $plugins as $key => $plugin ) {
+ $is_active = is_plugin_active( $key );
+ $installed_plugin = array( 'plugin' => $key, 'name' => $plugin['Name'], 'is_active' => $is_active );
+ $installed_plugin['activation_url'] = $is_active ? '' : wp_nonce_url( "plugins.php?action=activate&plugin={$key}", "activate-plugin_{$key}" );
+ $installed_plugin['deactivation_url'] = ! $is_active ? '' : wp_nonce_url( "plugins.php?action=deactivate&plugin={$key}", "deactivate-plugin_{$key}" );
+
+ $installed_plugins[] = $installed_plugin;
+ }
+
+ $nonces = self::get_addon_nonces();
+
+ $body = array( 'plugins' => urlencode( serialize( $installed_plugins ) ), 'nonces' => urlencode( serialize( $nonces ) ), 'key' => GFCommon::get_key() );
+ $options = array( 'body' => $body, 'headers' => array( 'Referer' => get_bloginfo( 'url' ) ), 'timeout' => 15 );
+
+ $raw_response = GFCommon::post_to_manager( 'api.php', "op=plugin_browser&{$_SERVER['QUERY_STRING']}", $options );
+
+ if ( is_wp_error( $raw_response ) || $raw_response['response']['code'] != 200 ) {
+ echo "" . __( 'Add-On browser is currently unavailable. Please try again later.', 'gravityforms' ) . '
';
+ } else {
+ echo GFCommon::get_remote_message();
+ echo $raw_response['body'];
+ }
+ }
+
+ public static function get_addon_info( $api, $action, $args ) {
+
+ if ( $action == 'plugin_information' && empty( $api ) && ( ! rgempty( 'rg', $_GET ) || $args->slug == 'gravityforms' ) ) {
+
+ $raw_response = GFCommon::post_to_manager( 'api.php', "op=get_plugin&slug={$args->slug}", array() );
+
+ if ( is_wp_error( $raw_response ) || $raw_response['response']['code'] != 200 ) {
+ return false;
+ }
+
+ $plugin = unserialize( $raw_response['body'] );
+
+ $api = new stdClass();
+ $api->name = $plugin['title'];
+ $api->version = $plugin['version'];
+ $api->download_link = $plugin['download_url'];
+ $api->tested = '10.0';
+
+ }
+
+ return $api;
+ }
+
+ public static function get_addon_nonces() {
+
+ $raw_response = GFCommon::post_to_manager( 'api.php', 'op=get_plugins', array() );
+
+ if ( is_wp_error( $raw_response ) || $raw_response['response']['code'] != 200 ) {
+ return false;
+ }
+
+ $addons = unserialize( $raw_response['body'] );
+ $nonces = array();
+ foreach ( $addons as $addon ) {
+ $nonces[ $addon['key'] ] = wp_create_nonce( "install-plugin_{$addon['key']}" );
+ }
+
+ return $nonces;
+ }
+
+ public static function start_export() {
+ require_once( GFCommon::get_base_path() . '/export.php' );
+ GFExport::start_export();
+ }
+
+ public static function get_post_category_values() {
+ require_once( GFCommon::get_base_path() . '/form_detail.php' );
+ GFFormDetail::get_post_category_values();
+ }
+
+ public static function get_notification_post_category_values() {
+ require_once( GFCommon::get_base_path() . '/notification.php' );
+ GFNotification::get_post_category_values();
+ }
+
+ public static function all_leads_page() {
+
+ $view = rgget( 'view' );
+ $lead_id = rgget( 'lid' );
+
+ if ( $view == 'entry' && ( rgget( 'lid' ) || ! rgblank( rgget( 'pos' ) ) ) ) {
+ require_once( GFCommon::get_base_path() . '/entry_detail.php' );
+ GFEntryDetail::lead_detail_page();
+ } else if ( $view == 'entries' || empty( $view ) ) {
+ require_once( GFCommon::get_base_path() . '/entry_list.php' );
+ GFEntryList::all_leads_page();
+ } else {
+ $form_id = rgget( 'id' );
+ do_action( 'gform_entries_view', $view, $form_id, $lead_id );
+ }
+
+ }
+
+ public static function form_list_page() {
+ require_once( GFCommon::get_base_path() . '/form_list.php' );
+ GFFormList::form_list_page();
+ }
+
+ public static function forms() {
+ if ( ! GFCommon::ensure_wp_version() ) {
+ return;
+ }
+
+ $id = RGForms::get( 'id' );
+ $view = RGForms::get( 'view' );
+
+ if ( $view == 'entries' ) {
+ require_once( GFCommon::get_base_path() . '/entry_list.php' );
+ GFEntryList::leads_page( $id );
+ } else if ( $view == 'entry' ) {
+ require_once( GFCommon::get_base_path() . '/entry_detail.php' );
+ GFEntryDetail::lead_detail_page();
+ } else if ( $view == 'notification' ) {
+ require_once( GFCommon::get_base_path() . '/notification.php' );
+ //GFNotification::notification_page($id);
+ } else if ( $view == 'settings' ) {
+ require_once( GFCommon::get_base_path() . '/form_settings.php' );
+ GFFormSettings::form_settings_page( $id );
+ } else if ( empty( $view ) ) {
+ if ( is_numeric( $id ) ) {
+ self::forms_page( $id );
+ } else {
+ self::form_list_page();
+ }
+ }
+
+ do_action( 'gform_view', $view, $id );
+
+ }
+
+ public static function get( $name, $array = null ) {
+ if ( ! $array ) {
+ $array = $_GET;
+ }
+
+ if ( isset( $array[ $name ] ) ) {
+ return $array[ $name ];
+ }
+
+ return '';
+ }
+
+ public static function post( $name ) {
+ if ( isset( $_POST[ $name ] ) ) {
+ return $_POST[ $name ];
+ }
+
+ return '';
+ }
+
+ // AJAX Function
+ public static function resend_notifications() {
+
+ check_admin_referer( 'gf_resend_notifications', 'gf_resend_notifications' );
+ $form_id = rgpost( 'formId' );
+ $leads = rgpost( 'leadIds' ); // may be a single ID or an array of IDs
+ if ( 0 == $leads ) {
+ // get all the lead ids for the current filter / search
+ $filter = rgpost( 'filter' );
+ $search = rgpost( 'search' );
+ $star = $filter == 'star' ? 1 : null;
+ $read = $filter == 'unread' ? 0 : null;
+ $status = in_array( $filter, array( 'trash', 'spam' ) ) ? $filter : 'active';
+
+ $search_criteria['status'] = $status;
+
+ if ( $star ) {
+ $search_criteria['field_filters'][] = array( 'key' => 'is_starred', 'value' => (bool) $star );
+ }
+ if ( ! is_null( $read ) ) {
+ $search_criteria['field_filters'][] = array( 'key' => 'is_read', 'value' => (bool) $read );
+ }
+
+ $search_field_id = rgpost( 'fieldId' );
+
+ if ( isset( $_POST['fieldId'] ) && $_POST['fieldId'] !== '' ) {
+ $key = $search_field_id;
+ $val = $search;
+ $strpos_row_key = strpos( $search_field_id, '|' );
+ if ( $strpos_row_key !== false ) { //multi-row
+ $key_array = explode( '|', $search_field_id );
+ $key = $key_array[0];
+ $val = $key_array[1] . ':' . $val;
+ }
+ $search_criteria['field_filters'][] = array(
+ 'key' => $key,
+ 'operator' => rgempty( 'operator', $_POST ) ? 'is' : rgpost( 'operator' ),
+ 'value' => $val,
+ );
+ }
+
+ $leads = GFFormsModel::search_lead_ids( $form_id, $search_criteria );
+ } else {
+ $leads = ! is_array( $leads ) ? array( $leads ) : $leads;
+ }
+
+ $form = apply_filters( "gform_before_resend_notifications_{$form_id}", apply_filters( 'gform_before_resend_notifications', RGFormsModel::get_form_meta( $form_id ), $leads ), $leads );
+
+ if ( empty( $leads ) || empty( $form ) ) {
+ _e( 'There was an error while resending the notifications.', 'gravityforms' );
+ die();
+ };
+
+ $notifications = json_decode( rgpost( 'notifications' ) );
+ if ( ! is_array( $notifications ) ) {
+ die( __( 'No notifications have been selected. Please select a notification to be sent.', 'gravityforms' ) );
+ }
+
+ if ( ! rgempty( 'sendTo', $_POST ) && ! GFCommon::is_valid_email_list( rgpost( 'sendTo' ) ) ) {
+ die( __( 'The Send To email address provided is not valid.', 'gravityforms' ) );
+ }
+
+ foreach ( $leads as $lead_id ) {
+
+ $lead = RGFormsModel::get_lead( $lead_id );
+ foreach ( $notifications as $notification_id ) {
+ $notification = $form['notifications'][ $notification_id ];
+ if ( ! $notification ) {
+ continue;
+ }
+
+ //overriding To email if one was specified
+ if ( rgpost( 'sendTo' ) ) {
+ $notification['to'] = rgpost( 'sendTo' );
+ $notification['toType'] = 'email';
+ }
+
+ GFCommon::send_notification( $notification, $form, $lead );
+ }
+ }
+
+ die();
+ }
+
+ //-------------------------------------------------
+ //----------- AJAX CALLS --------------------------
+ //captcha image
+
+ public static function captcha_image() {
+ $field_properties = array( 'type' => 'captcha', 'simpleCaptchaSize' => $_GET['size'], 'simpleCaptchaFontColor' => $_GET['fg'], 'simpleCaptchaBackgroundColor' => $_GET['bg'] );
+ /* @var GF_Field_CAPTCHA $field */
+ $field = GF_Fields::create( $field_properties );
+ if ( $_GET['type'] == 'math' ) {
+ $captcha = $field->get_math_captcha( $_GET['pos'] );
+ } else {
+ $captcha = $field->get_captcha();
+ }
+
+ @ini_set( 'memory_limit', '256M' );
+ $image = imagecreatefrompng( $captcha['path'] );
+
+ include_once( ABSPATH . 'wp-admin/includes/image-edit.php' );
+ wp_stream_image( $image, 'image/png', 0 );
+ imagedestroy( $image );
+ die();
+ }
+
+ public static function update_form_active() {
+ check_ajax_referer( 'rg_update_form_active', 'rg_update_form_active' );
+ RGFormsModel::update_form_active( $_POST['form_id'], $_POST['is_active'] );
+ }
+
+ public static function update_notification_active() {
+ check_ajax_referer( 'rg_update_notification_active', 'rg_update_notification_active' );
+ RGFormsModel::update_notification_active( $_POST['form_id'], $_POST['notification_id'], $_POST['is_active'] );
+ }
+
+ public static function update_confirmation_active() {
+ check_ajax_referer( 'rg_update_confirmation_active', 'rg_update_confirmation_active' );
+ RGFormsModel::update_confirmation_active( $_POST['form_id'], $_POST['confirmation_id'], $_POST['is_active'] );
+ }
+
+ public static function update_lead_property() {
+ check_ajax_referer( 'rg_update_lead_property', 'rg_update_lead_property' );
+ RGFormsModel::update_lead_property( $_POST['lead_id'], $_POST['name'], $_POST['value'] );
+ }
+
+ public static function update_lead_status() {
+ check_ajax_referer( 'gf_delete_entry' );
+ $status = rgpost( 'status' );
+ $lead_id = rgpost( 'entry' );
+
+ switch ( $status ) {
+ case 'unspam' :
+ RGFormsModel::update_lead_property( $lead_id, 'status', 'active' );
+ break;
+
+ case 'delete' :
+ if ( GFCommon::current_user_can_any( 'gravityforms_delete_entries' ) ) {
+ RGFormsModel::delete_lead( $lead_id );
+ }
+ break;
+
+ default :
+ RGFormsModel::update_lead_property( $lead_id, 'status', $status );
+ break;
+ }
+ header( 'Content-Type: text/xml' );
+ echo "{$icon} {$label} " . $sub_menu_str;
+ if ( $compact ) {
+ if ( $key == 'delete' ) {
+ $link = apply_filters( 'gform_form_delete_link', $link );
+ }
+ $divider = $key == $last_key ? '' : ' | ';
+ if ( $count_sub_menu_items > 0 ) {
+ $menu_class .= ' gf_form_action_has_submenu';
+ }
+ $output .= '';
+ } else {
+
+ $output .= "";
+ }
+ }
+ } elseif ( $compact ) {
+ //for backwards compatibility <1.7: form actions only
+ $divider = $key == $last_key ? '' : ' | ';
+ $output .= '' . $menu_item . $divider . ' ';
+ }
+ }
+
+ return $output;
+ }
+
+ public static function get_toolbar_menu_items( $form_id, $compact = false ) {
+ $menu_items = array();
+
+ //---- Form Editor ----
+ $edit_capabilities = array( 'gravityforms_edit_forms' );
+
+ $menu_items['edit'] = array(
+ 'label' => $compact ? __( 'Edit', 'gravityforms' ) : __( 'Form Editor', 'gravityforms' ),
+ 'icon' => '
-
-
-
-
-
-
-
frequently asked questions (FAQ) first. If you still can't find the answer
open a support ticket and we will be happy to answer your questions and assist you with any problems.
Please note: If you have not
purchased a license from us, you won't have access to these help resources.", "gravityforms"); ?>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Please Note: Only licensed Gravity Forms customers are granted access to the downloads section.", "gravityforms"); ?>
-
-
-
-
-
-
- Please note: The Gravity Forms support team does not provide support for third party scripts, widgets, etc.", "gravityforms"); ?>
-
-
-
-
-
+
+
+
+
+
+
+
frequently asked questions (FAQ) first. If you still can't find the answer
open a support ticket and we will be happy to answer your questions and assist you with any problems.
Please note: If you have not
purchased a license from us, you won't have access to these help resources.", 'gravityforms' ); ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Please Note: Only licensed Gravity Forms customers are granted access to the downloads section.', 'gravityforms' ); ?>
+
+
+
+
+
+
+ Please note: The Gravity Forms support team does not provide support for third party scripts, widgets, etc.', 'gravityforms' ); ?>
+
+
+
+
+
- *
- *
- * array(
- * array( "handle" => "maskedinput",
- * "src" => GFCommon::get_base_url() . "/js/jquery.maskedinput-1.3.min.js",
- * "version" => GFCommon::$version,
- * "deps" => array("jquery"),
- * "in_footer" => false,
- *
- * //Determines where the script will be enqueued. The script will be enqueued if any of the conditions match
- * "enqueue" => array(
- * //admin_page - Specified one or more pages (known pages) where the script is supposed to be enqueued. When this setting is specified, scripts will only be enqueued in those pages.
- * //To enqueue scripts in the front end (public website), simply don't define this setting
- * array("admin_page" => array("form_settings", "plugin_settings") ),
- *
- * //tab - Specifies a form settings or plugin settings tab in which the script is supposed to be enqueued. If none is specified, the script will be enqueued in any of the form settings or plugin_settings page
- * array("tab" => "signature"),
- *
- * //query - Specifies a set of query string ($_GET) values. If all specified query string values match the current requested page, the script will be enqueued
- * array("query" => "page=gf_edit_forms&view=settings&id=_notempty_")
- *
- * //post - Specifies a set of post ($_POST) values. If all specified posted values match the current request, the script will be enqueued
- * array("post" => "posted_field=val")
- *
- * )
- * ),
- * array(
- * "handle" => "super_signature_script",
- * "src" => $this->get_base_url() . "/super_signature/ss.js",
- * "version" => $this->_version,
- * "deps" => array("jquery"),
- * "callback" => array($this, "localize_scripts"),
- * "strings" => array(
- * // Accessible in JavaScript using the global variable "[script handle]_strings"
- * "stringKey1" => __("The string", "gravityforms"),
- * "stringKey2" => __("Another string.", "gravityforms")
- * )
- * "enqueue" => array(
- * //field_types - Specifies one or more field types that requires this script. The script will only be enqueued if the current form has a field of any of the specified field types. Only applies when a current form is available.
- * array("field_types" => array("signature"))
- * )
- * )
- * );
- *
- *
- *
- */
- protected function scripts(){
- return array(
- array(
- 'handle' => 'gform_form_admin',
- 'enqueue' => array( array( "admin_page" => array("form_settings") ) )
- ),
- array(
- 'handle' => 'gform_gravityforms',
- 'enqueue' => array( array( "admin_page" => array("form_settings") ) )
- ),
- array("handle" => "google_charts",
- "src" => "https://www.google.com/jsapi",
- "version" => GFCommon::$version,
- "enqueue" => array(
- array("admin_page" => array("results")),
- )
- ),
- array("handle" => "gaddon_results_js",
- "src" => GFAddOn::get_gfaddon_base_url() . "/js/gaddon_results.js",
- "version" => GFCommon::$version,
- "deps" => array('jquery', 'sack', 'jquery-ui-resizable', 'jquery-ui-datepicker' , 'google_charts', 'gform_field_filter'),
- "callback" => array('GFResults', "localize_results_scripts"),
- "enqueue" => array(
- array("admin_page" => array("results")),
- )
- ),
- array(
- 'handle' => 'gaddon_repeater',
- 'src' => GFAddOn::get_gfaddon_base_url() . '/js/repeater.js',
- 'version' => GFCommon::$version,
- 'deps' => array( 'jquery' ),
- 'enqueue' => array(
- array(
- 'admin_page' => array( 'form_settings' )
-// ,
-// 'field_types' => array( 'dynamic_field_map' )
- )
- )
- )
- );
- }
-
-
- /**
- * Target of admin_enqueue_scripts and gform_enqueue_scripts hooks.
- * Not intended to be overridden by child classes.
- * In order to enqueue scripts and styles, override the scripts() and styles() functions
- *
- * @ignore
- */
- public function enqueue_scripts($form="", $is_ajax=false){
-
- if(empty($form))
- $form = $this->get_current_form();
-
- //Enqueueing scripts
- $scripts = $this->scripts();
- foreach($scripts as $script){
- $src = isset($script["src"]) ? $script["src"] : false;
- $deps = isset($script["deps"]) ? $script["deps"] : array();
- $version = isset($script["version"]) ? $script["version"] : false;
- $in_footer = isset($script["in_footer"]) ? $script["in_footer"] : false;
- wp_register_script($script["handle"],$src, $deps, $version, $in_footer);
- if(isset($script["enqueue"]) && $this->_can_enqueue_script($script["enqueue"], $form, $is_ajax)){
- $this->add_no_conflict_scripts(array($script["handle"]));
- wp_enqueue_script($script["handle"]);
- if(isset($script["strings"]))
- wp_localize_script($script["handle"], $script["handle"]."_strings", $script["strings"]);
- if(isset($script["callback"]) && is_callable($script["callback"])){
- $args = compact("form", "is_ajax");
- call_user_func_array($script["callback"], $args);
- }
- }
- }
-
- //Enqueueing styles
- $styles = $this->styles();
- foreach($styles as $style){
- $src = isset($style["src"]) ? $style["src"] : false;
- $deps = isset($style["deps"]) ? $style["deps"] : array();
- $version = isset($style["version"]) ? $style["version"] : false;
- $media = isset($style["media"]) ? $style["media"] : "all";
- wp_register_style($style["handle"], $src, $deps, $version, $media);
- if($this->_can_enqueue_script($style["enqueue"], $form, $is_ajax)){
- $this->add_no_conflict_styles(array($style["handle"]));
- if ($this->is_preview()) {
- $this->_preview_styles[] = $style["handle"];
- } elseif ($this->is_print()) {
- $this->_print_styles[] = $style["handle"];
- } else {
- wp_enqueue_style($style["handle"]);
- }
- }
- }
- }
-
- /**
- * Target of gform_preview_styles. Enqueue styles to the preview page.
- * Not intented to be overriden by child classes
- *
- * @ignore
- */
- public function enqueue_preview_styles($preview_styles, $form) {
- return array_merge($preview_styles, $this->_preview_styles);
- }
-
-
- /**
- * Target of gform_print_styles. Enqueue styles to the print entry page.
- * Not intented to be overriden by child classes
- *
- * @ignore
- */
- public function enqueue_print_styles($print_styles, $form) {
- if(false === $print_styles)
- $print_styles = array();
-
- $styles = $this->styles();
- foreach($styles as $style){
- if($this->_can_enqueue_script($style["enqueue"], $form, false)){
- $this->add_no_conflict_styles(array($style["handle"]));
- $src = isset($style["src"]) ? $style["src"] : false;
- $deps = isset($style["deps"]) ? $style["deps"] : array();
- $version = isset($style["version"]) ? $style["version"] : false;
- $media = isset($style["media"]) ? $style["media"] : "all";
- wp_register_style($style["handle"], $src, $deps, $version, $media);
- $print_styles[] = $style["handle"];
- }
- }
-
- return array_merge($print_styles, $this->_print_styles);
- }
-
-
- /**
- * Adds scripts to the list of white-listed no conflict scripts.
- *
- * @param $scripts
- */
- private function add_no_conflict_scripts($scripts) {
- $this->_no_conflict_scripts = array_merge($scripts, $this->_no_conflict_scripts);
-
- }
-
- /**
- * Adds styles to the list of white-listed no conflict styles.
- *
- * @param $styles
- */
- private function add_no_conflict_styles($styles) {
- $this->_no_conflict_styles = array_merge($styles, $this->_no_conflict_styles);
- }
-
- private function _can_enqueue_script($enqueue_conditions, $form, $is_ajax){
- if(empty($enqueue_conditions))
- return false;
-
- foreach($enqueue_conditions as $condition){
- if(is_callable($condition)){
- return call_user_func($condition, $form, $is_ajax);
- }
- else{
- $query_matches = isset($condition["query"]) ? $this->_request_condition_matches($_GET, $condition["query"]) : true;
- $post_matches = isset($condition["post"]) ? $this->_request_condition_matches($_POST, $condition["query"]) : true;
- $admin_page_matches = isset($condition["admin_page"]) ? $this->_page_condition_matches($condition["admin_page"], rgar($condition,"tab")) : true;
- $field_type_matches = isset($condition["field_types"]) ? $this->_field_condition_matches($condition["field_types"], $form) : true;
-
- //Scripts will only be enqueued in any admin page if "admin_page", "query" or "post" variable is set.
- //Scripts will only be enqueued in the front end if "admin_page" is not set.
- $site_matches = ( isset($condition["admin_page"]) && is_admin() ) || ( !isset($condition["admin_page"]) && !is_admin() ) || ( isset($condition["query"]) || isset($condition["post"]) ) ;
-
- if($query_matches && $post_matches && $admin_page_matches && $field_type_matches && $site_matches){
- return true;
- }
- }
- }
- return false;
- }
-
- private function _request_condition_matches($request, $query){
- parse_str($query, $query_array);
- foreach($query_array as $key => $value){
-
- switch ($value){
- case "_notempty_" :
- if(rgempty($key, $request))
- return false;
- break;
- case "_empty_" :
- if(!rgempty($key, $request))
- return false;
- break;
- default :
- if (rgar($request, $key) != $value)
- return false;
- break;
- }
-
- }
- return true;
- }
-
- private function _page_condition_matches($pages, $tab){
- if(!is_array($pages))
- $pages = array($pages);
-
- foreach($pages as $page){
- switch($page){
- case "form_editor" :
- if($this->is_form_editor())
- return true;
-
- break;
-
- case "form_settings" :
- if($this->is_form_settings($tab))
- return true;
-
- break;
-
- case "plugin_settings" :
- if($this->is_plugin_settings($tab))
- return true;
-
- break;
-
- case "app_settings" :
- if($this->is_app_settings($tab))
- return true;
-
- break;
-
- case "plugin_page" :
- if($this->is_plugin_page())
- return true;
-
- break;
-
- case "entry_view" :
- if($this->is_entry_view())
- return true;
-
- break;
-
- case "entry_edit" :
- if($this->is_entry_edit())
- return true;
-
- break;
-
- case "results" :
- if($this->is_results())
- return true;
-
- break;
-
- }
- }
- return false;
-
- }
-
- private function _field_condition_matches($field_types, $form){
- if(!is_array($field_types))
- $field_types = array($field_types);
-
- $fields = GFCommon::get_fields_by_type($form, $field_types);
- if(count($fields) > 0)
- return true;
-
- return false;
- }
-
- /**
- * Target for the gform_noconflict_scripts filter. Adds scripts to the list of white-listed no conflict scripts.
- *
- * Not intended to be overridden or called directed by Add-Ons.
- *
- * @ignore
- *
- * @param array $scripts Array of scripts to be white-listed
- * @return array
- */
- public function register_noconflict_scripts($scripts) {
- //registering scripts with Gravity Forms so that they get enqueued when running in no-conflict mode
- return array_merge($scripts, $this->_no_conflict_scripts);
- }
-
- /**
- * Target for the gform_noconflict_styles filter. Adds styles to the list of white-listed no conflict scripts.
- *
- * Not intended to be overridden or called directed by Add-Ons.
- *
- * @ignore
- *
- * @param array $styles Array of styles to be white-listed
- * @return array
- */
- public function register_noconflict_styles($styles) {
- //registering styles with Gravity Forms so that they get enqueued when running in no-conflict mode
- return array_merge($styles, $this->_no_conflict_styles);
- }
-
-
-
- //-------------- Entry meta --------------------------------------
-
- /**
- * Override this method to activate and configure entry meta.
- *
- *
- * @param array $entry_meta An array of entry meta already registered with the gform_entry_meta filter.
- * @param int $form_id The form id
- *
- * @return array The filtered entry meta array.
- */
- protected function get_entry_meta($entry_meta, $form_id) {
- return $entry_meta;
- }
-
-
- //-------------- Results page --------------------------------------
- /**
- * Returns the configuration for the results page. By default this is not activated.
- * To activate the results page override this function and return an array with the configuration data.
- *
- * Example:
- * public function get_results_page_config() {
- * return array(
- * "title" => "Quiz Results",
- * "capabilities" => array("gravityforms_quiz_results"),
- * "callbacks" => array(
- * "fields" => array($this, "results_fields"),
- * "calculation" => array($this, "results_calculation"),
- * "markup" => array($this, "results_markup"),
- * )
- * );
- * }
- *
- */
- public function get_results_page_config() {
- return false;
- }
-
- /**
- * Initializes the result page functionality. To activate result page functionality, override the get_results_page_config() function.
- *
- * @param $results_page_config - configuration returned by get_results_page_config()
- */
- protected function results_page_init($results_page_config) {
- require_once("class-gf-results.php");
-
- if(isset($results_page_config["callbacks"]["filters"]))
- add_filter("gform_filters_pre_results", $results_page_config["callbacks"]["filters"], 10, 2);
-
- if(isset($results_page_config["callbacks"]["filter_ui"])){
- add_filter("gform_filter_ui", $results_page_config["callbacks"]["filter_ui"], 10, 5);
- }
-
- $gf_results = new GFResults($this->_slug, $results_page_config);
- $gf_results->init();
- }
-
- //-------------- Logging integration --------------------------------------
-
- function set_logging_supported($plugins){
- $plugins[$this->_slug] = $this->_title;
- return $plugins;
- }
-
-
- //-------------- Members plugin integration --------------------------------------
-
- /**
- * Checks whether the Members plugin is installed and activated.
- *
- * Not intended to be overridden or called directly by Add-Ons.
- *
- * @ignore
- *
- * @return bool
- */
- protected function has_members_plugin() {
- return function_exists('members_get_capabilities');
- }
-
- /**
- * Not intended to be overridden or called directly by Add-Ons.
- *
- * @ignore
- *
- * @param $caps
- * @return array
- */
- public function members_get_capabilities($caps) {
- return array_merge($caps, $this->_capabilities);
- }
-
- //-------------- Permissions: Capabilities and Roles ----------------------------
-
- /**
- * Checks whether the current user is assigned to a capability or role.
- *
- * @param string|array $caps An string or array of capabilities to check
- * @return bool Returns true if the current user is assigned to any of the capabilities.
- */
- protected function current_user_can_any($caps) {
- return GFCommon::current_user_can_any($caps);
- }
-
-
- //------- Settings Helper Methods (Common to all settings pages) -------------------
-
- /***
- * Renders the UI of all settings page based on the specified configuration array $sections
- *
- * @param array $sections - Configuration array containing all fields to be rendered grouped into sections
- */
- protected function render_settings( $sections ) {
-
- if( ! $this->has_setting_field_type( 'save', $sections ) )
- $sections = $this->add_default_save_button( $sections );
-
- ?>
-
-
-
- setting_dependency_met( rgar( $section, 'dependency' ) ) )
- $this->single_section( $section, $is_first);
-
- $is_first = false;
- }
- }
+ }
- /***
- * Displays the UI for a field section
- *
- * @param array $section - The section to be displayed
- * @param bool $is_first - true for the first section in the list, false for all others
- */
- protected function single_section( $section, $is_first = false) {
-
- extract( wp_parse_args( $section, array(
- 'title' => false,
- 'description' => false,
- 'id' => '',
- 'class' => false,
- 'style' => '',
- ''
- ) ) );
-
- $classes = array( 'gaddon-section' );
-
- if( $is_first )
- $classes[] = 'gaddon-first-section';
-
- if( $class )
- $classes[] = $class;
-
- ?>
-
-
-
-
-
- " >
-
- single_setting_label( $field ); ?>
-
-
- single_setting( $field ); ?>
-
-
-
- get_required_indicator( $field );
-
- }
-
- protected function single_setting_row_save( $field ) {
- ?>
-
-
-
- single_setting( $field ); ?>
-
-
-
- _saved_settings = $settings;
- }
-
- /***
- * Sets the previous settings to a class variable so that it can be accessed by lower level functions providing support for
- * verifying whether a value was changed before executing an action
- *
- * @param array $settings: Settings to be stored
- */
- protected function set_previous_settings( $settings ) {
- $this->_previous_settings = $settings;
- }
-
- protected function get_previous_settings() {
- return $this->_previous_settings;
- }
-
-
-
- /***
- * Gets settings from $_POST variable, returning a name/value collection of setting name and setting value
- */
- protected function get_posted_settings(){
- global $_gaddon_posted_settings;
-
- if(isset($_gaddon_posted_settings))
- return $_gaddon_posted_settings;
-
- $_gaddon_posted_settings = array();
- if(count($_POST) > 0){
- foreach($_POST as $key => $value){
- if(preg_match("|_gaddon_setting_(.*)|", $key, $matches)){
- $_gaddon_posted_settings[$matches[1]] = self::maybe_decode_json(stripslashes_deep($value));
- }
- }
- }
-
- return $_gaddon_posted_settings;
- }
-
- protected static function maybe_decode_json($value) {
- if (self::is_json($value))
- return json_decode($value, ARRAY_A);
-
- return $value;
- }
-
- protected static function is_json($value) {
- if (is_string($value) && in_array( substr($value, 0, 1), array( '{', '[' ) ) && is_array(json_decode($value, ARRAY_A)))
- return true;
-
- return false;
- }
-
- /***
- * Gets the "current" settings, which are settings from $_POST variables if this is a postback request, or the current saved settings for a get request.
- */
- protected function get_current_settings(){
- //try getting settings from post
- $settings = $this->get_posted_settings();
-
- //if nothing has been posted, get current saved settings
- if(empty($settings)){
- $settings = $this->_saved_settings;
- }
-
- return $settings;
- }
-
- /***
- * Retrieves the setting for a specific field/input
- *
- * @param string $setting_name The field or input name
- * @param string $default_value Optional. The default value
- * @return string|array
- */
- protected function get_setting( $setting_name, $default_value = "" , $settings = false ) {
-
- if( ! $settings )
- $settings = $this->get_current_settings();
-
- if (false === $settings) {
- return $default_value;
- }
-
- if (strpos($setting_name, "[") !== false) {
- $path_parts = explode("[", $setting_name);
- foreach ($path_parts as $part) {
- $part = trim($part, "]");
- if (false === isset($settings[$part])) {
- return $default_value;
- }
- $settings = rgar($settings, $part);
- }
- $setting = $settings;
- } else {
- if (false === isset($settings[$setting_name])) {
- return $default_value;
- }
- $setting = $settings[$setting_name];
- }
-
- return $setting;
- }
-
- protected function get_mapped_field_value( $setting_name, $form, $entry, $settings = false ){
-
- $field_id = $this->get_setting($setting_name, "", $settings);
-
- $field_type = GFFormsModel::get_input_type(GFFormsModel::get_field($form, $field_id));
- $is_field_id_integer = ctype_digit($field_id);
-
- if($is_field_id_integer && $field_type == "name"){
- //Full Name
- $value = $this->get_full_name($entry, $field_id);
- }
- else if($is_field_id_integer && $field_type == "address"){
- //Full Address
- $value = $this->get_full_address($entry, $field_id);
- }
- else{
- $value = rgar($entry, $field_id);
- }
-
- return $value;
- }
-
- protected function get_full_address($entry, $field_id){
- $street_value = str_replace(" ", " ", trim($entry[$field_id . ".1"]));
- $street2_value = str_replace(" ", " ", trim($entry[$field_id . ".2"]));
- $city_value = str_replace(" ", " ", trim($entry[$field_id . ".3"]));
- $state_value = str_replace(" ", " ", trim($entry[$field_id . ".4"]));
- $zip_value = trim($entry[$field_id . ".5"]);
- $country_value = GFCommon::get_country_code(trim($entry[$field_id . ".6"]));
-
- $address = $street_value;
- $address .= !empty($address) && !empty($street2_value) ? " $street2_value" : $street2_value;
- $address .= !empty($address) && (!empty($city_value) || !empty($state_value)) ? ", $city_value," : $city_value;
- $address .= !empty($address) && !empty($city_value) && !empty($state_value) ? " $state_value" : $state_value;
- $address .= !empty($address) && !empty($zip_value) ? " $zip_value," : $zip_value;
- $address .= !empty($address) && !empty($country_value) ? " $country_value" : $country_value;
-
-
- return $address;
- }
-
- protected function get_full_name($entry, $field_id){
-
- //If field is aweber (one input), simply return full content
- $name = rgar($entry,$field_id);
- if(!empty($name))
- return $name;
-
- //Complex field (multiple inputs). Join all pieces and create name
- $prefix = trim(rgar($entry,$field_id . ".2"));
- $first = trim(rgar($entry,$field_id . ".3"));
- $last = trim(rgar($entry,$field_id . ".6"));
- $suffix = trim(rgar($entry,$field_id . ".8"));
-
- $name = $prefix;
- $name .= !empty($name) && !empty($first) ? " $first" : $first;
- $name .= !empty($name) && !empty($last) ? " $last" : $last;
- $name .= !empty($name) && !empty($suffix) ? " $suffix" : $suffix;
- return $name;
- }
-
-
- /***
- * Determines if a dependent field has been populated.
- *
- * @param string $dependency - Field or input name of the "parent" field.
- * @return bool - true if the "parent" field has been filled out and false if it has not.
- *
- */
- protected function setting_dependency_met( $dependency ) {
-
- // if no dependency, always return true
- if( ! $dependency )
- return true;
-
- //use a callback if one is specified in the configuration
- if(is_callable($dependency)){
- return call_user_func($dependency);
- }
-
- if(is_array($dependency)){
- //supports: "dependency" => array("field" => "myfield", "values" => array("val1", "val2"))
- $dependency_field = $dependency["field"];
- $dependency_value = $dependency["values"];
- }
- else{
- //supports: "dependency" => "myfield"
- $dependency_field = $dependency;
- $dependency_value = "_notempty_";
- }
-
- if(!is_array($dependency_value))
- $dependency_value = array($dependency_value);
-
- $current_value = $this->get_setting($dependency_field);
-
- foreach($dependency_value as $val){
- if($current_value == $val)
- return true;
-
- if($val == "_notempty_" && !rgblank($current_value))
- return true;
- }
-
- return false;
- }
-
- protected function has_setting_field_type( $type, $fields ) {
-
- foreach( $fields as &$section ) {
- foreach( $section['fields'] as $field ) {
- if( rgar( $field, 'type' ) == $type )
- return true;
- }
- }
-
- return false;
- }
-
- protected function add_default_save_button( $sections ) {
- $sections[count($sections) - 1]['fields'][] = array( 'type' => 'save' );
- return $sections;
- }
-
- protected function get_save_success_message( $sections ) {
- $save_button = $this->get_save_button($sections);
- return isset($save_button["messages"]["success"]) ? $save_button["messages"]["success"] : __("Settings updated", "gravityforms") ;
- }
-
- protected function get_save_error_message( $sections ) {
- $save_button = $this->get_save_button($sections);
- return isset($save_button["messages"]["error"]) ? $save_button["messages"]["error"] : __("There was an error while saving your settings", "gravityforms") ;
- }
-
- protected function get_save_button($sections){
- $fields = $sections[count($sections) - 1]['fields'];
+ /**
+ * Override this function to add AJAX hooks or to add initialization code when an AJAX request is being performed
+ */
+ protected function init_ajax() {
+ if ( rgpost( 'view' ) == 'gf_results_' . $this->_slug ) {
+ require_once( GFCommon::get_base_path() . '/tooltips.php' );
+ require_once( 'class-gf-results.php' );
+ $gf_results = new GFResults( $this->_slug, $this->get_results_page_config() );
+ add_action( 'wp_ajax_gresults_get_results_gf_results_' . $this->_slug, array( $gf_results, 'ajax_get_results' ) );
+ add_action( 'wp_ajax_gresults_get_more_results_gf_results_' . $this->_slug, array( $gf_results, 'ajax_get_more_results' ) );
+ } elseif ( $this->method_is_overridden( 'get_locking_config' ) ) {
+ require_once( GFCommon::get_base_path() . '/includes/locking/class-gf-locking.php' );
+ require_once( 'class-gf-addon-locking.php' );
+ $config = $this->get_locking_config();
+ new GFAddonLocking( $config, $this );
+ }
+ }
- foreach($fields as $field){
- if ($field["type"] == "save")
- return $field;
- }
-
- return false;
- }
-
-
-
- //------------- Field Types ------------------------------------------------------
-
- /***
- * Renders and initializes a text field based on the $field array
- *
- * @param array $field - Field array containing the configuration options of this field
- * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
- * @return string The HTML for the field
- */
- protected function settings_text($field, $echo = true) {
-
- $field["type"] = "text"; //making sure type is set to text
- $attributes = $this->get_field_attributes($field);
- $default_value = rgar( $field, 'value' ) ? rgar( $field, 'value' ) : rgar( $field, 'default_value' );
- $value = $this->get_setting($field["name"], $default_value);
-
-
- $name = esc_attr($field["name"]);
- $tooltip = isset( $choice['tooltip'] ) ? gform_tooltip( $choice['tooltip'], rgar( $choice, 'tooltip_class'), true ) : "";
- $html = "";
- $html .= '
+ *
*
- * @param array $field - Field array containing the configuration options of this field
- * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
+ * array(
+ * array( "handle" => 'maskedinput',
+ * "src" => GFCommon::get_base_url() . '/js/jquery.maskedinput-1.3.min.js',
+ * "version" => GFCommon::$version,
+ * "deps" => array("jquery"),
+ * "in_footer" => false,
*
- * @return string The HTML for the field
+ * //Determines where the script will be enqueued. The script will be enqueued if any of the conditions match
+ * "enqueue" => array(
+ * //admin_page - Specified one or more pages (known pages) where the script is supposed to be enqueued.
+ * //To enqueue scripts in the front end (public website), simply don't define this setting
+ * array("admin_page" => array("form_settings", 'plugin_settings') ),
+ *
+ * //tab - Specifies a form settings or plugin settings tab in which the script is supposed to be enqueued. If none is specified, the script will be enqueued in any of the form settings or plugin_settings page
+ * array("tab" => 'signature'),
+ *
+ * //query - Specifies a set of query string ($_GET) values. If all specified query string values match the current requested page, the script will be enqueued
+ * array("query" => 'page=gf_edit_forms&view=settings&id=_notempty_')
+ *
+ * //post - Specifies a set of post ($_POST) values. If all specified posted values match the current request, the script will be enqueued
+ * array("post" => 'posted_field=val')
+ *
+ * )
+ * ),
+ * array(
+ * "handle" => 'super_signature_script',
+ * "src" => $this->get_base_url() . '/super_signature/ss.js',
+ * "version" => $this->_version,
+ * "deps" => array("jquery"),
+ * "callback" => array($this, 'localize_scripts'),
+ * "strings" => array(
+ * // Accessible in JavaScript using the global variable "[script handle]_strings"
+ * "stringKey1" => __("The string", 'gravityforms'),
+ * "stringKey2" => __("Another string.", 'gravityforms')
+ * )
+ * "enqueue" => array(
+ * //field_types - Specifies one or more field types that requires this script. The script will only be enqueued if the current form has a field of any of the specified field types. Only applies when a current form is available.
+ * array("field_types" => array("signature"))
+ * )
+ * )
+ * );
+ *
+ *
+ *
*/
- protected function settings_checkbox( $field, $echo = true ) {
-
- $field['type'] = 'checkbox'; //making sure type is set to checkbox
+ protected function scripts() {
+ return array(
+ array(
+ 'handle' => 'gform_form_admin',
+ 'enqueue' => array( array( 'admin_page' => array( 'form_settings' ) ) )
+ ),
+ array(
+ 'handle' => 'gform_gravityforms',
+ 'enqueue' => array( array( 'admin_page' => array( 'form_settings' ) ) )
+ ),
+ array(
+ 'handle' => 'google_charts',
+ 'src' => 'https://www.google.com/jsapi',
+ 'version' => GFCommon::$version,
+ 'enqueue' => array(
+ array( 'admin_page' => array( 'results' ) ),
+ )
+ ),
+ array(
+ 'handle' => 'gaddon_results_js',
+ 'src' => GFAddOn::get_gfaddon_base_url() . '/js/gaddon_results.js',
+ 'version' => GFCommon::$version,
+ 'deps' => array( 'jquery', 'sack', 'jquery-ui-resizable', 'jquery-ui-datepicker', 'google_charts', 'gform_field_filter' ),
+ 'callback' => array( 'GFResults', 'localize_results_scripts' ),
+ 'enqueue' => array(
+ array( 'admin_page' => array( 'results' ) ),
+ )
+ ),
+ array(
+ 'handle' => 'gaddon_repeater',
+ 'src' => GFAddOn::get_gfaddon_base_url() . '/js/repeater.js',
+ 'version' => GFCommon::$version,
+ 'deps' => array( 'jquery' ),
+ 'enqueue' => array(
+ array(
+ 'admin_page' => array( 'form_settings' )
+ // ,
+ // 'field_types' => array( 'dynamic_field_map' )
+ ),
+ ),
+ ),
+ );
+ }
- $field_attributes = $this->get_field_attributes( $field, array() );
- $horizontal = rgar( $field, 'horizontal' ) ? ' gaddon-setting-inline' : '';
- $default_choice_attributes = array( 'onclick' => 'jQuery(this).siblings("input[type=hidden]").val(jQuery(this).prop("checked") ? 1 : 0);' );
- $html = '';
- if ( is_array( $field['choices'] ) ) {
- foreach ( $field['choices'] as $choice ) {
- $choice['id'] = sanitize_title($choice['name']);
- $choice_attributes = $this->get_choice_attributes( $choice, $field_attributes, $default_choice_attributes );
- $value = $this->get_setting( $choice['name'], rgar( $choice, 'default_value' ) );
- $tooltip = isset( $choice['tooltip'] ) ? gform_tooltip( $choice['tooltip'], rgar( $choice, 'tooltip_class' ), true ) : '';
+ /**
+ * Target of admin_enqueue_scripts and gform_enqueue_scripts hooks.
+ * Not intended to be overridden by child classes.
+ * In order to enqueue scripts and styles, override the scripts() and styles() functions
+ *
+ * @ignore
+ */
+ public function enqueue_scripts( $form = '', $is_ajax = false ) {
- $html .= $this->checkbox_item( $choice, $horizontal, $choice_attributes, $value, $tooltip );
+ if ( empty( $form ) ) {
+ $form = $this->get_current_form();
+ }
+ //Enqueueing scripts
+ $scripts = $this->scripts();
+ foreach ( $scripts as $script ) {
+ $src = isset( $script['src'] ) ? $script['src'] : false;
+ $deps = isset( $script['deps'] ) ? $script['deps'] : array();
+ $version = isset( $script['version'] ) ? $script['version'] : false;
+ $in_footer = isset( $script['in_footer'] ) ? $script['in_footer'] : false;
+ wp_register_script( $script['handle'], $src, $deps, $version, $in_footer );
+ if ( isset( $script['enqueue'] ) && $this->_can_enqueue_script( $script['enqueue'], $form, $is_ajax ) ) {
+ $this->add_no_conflict_scripts( array( $script['handle'] ) );
+ wp_enqueue_script( $script['handle'] );
+ if ( isset( $script['strings'] ) ) {
+ wp_localize_script( $script['handle'], $script['handle'] . '_strings', $script['strings'] );
+ }
+ if ( isset( $script['callback'] ) && is_callable( $script['callback'] ) ) {
+ $args = compact( 'form', 'is_ajax' );
+ call_user_func_array( $script['callback'], $args );
+ }
}
}
- if ( $this->field_failed_validation( $field ) )
- $html .= $this->get_error_icon( $field );
-
- if ( $echo )
- echo $html;
+ //Enqueueing styles
+ $styles = $this->styles();
+ foreach ( $styles as $style ) {
+ $src = isset( $style['src'] ) ? $style['src'] : false;
+ $deps = isset( $style['deps'] ) ? $style['deps'] : array();
+ $version = isset( $style['version'] ) ? $style['version'] : false;
+ $media = isset( $style['media'] ) ? $style['media'] : 'all';
+ wp_register_style( $style['handle'], $src, $deps, $version, $media );
+ if ( $this->_can_enqueue_script( $style['enqueue'], $form, $is_ajax ) ) {
+ $this->add_no_conflict_styles( array( $style['handle'] ) );
+ if ( $this->is_preview() ) {
+ $this->_preview_styles[] = $style['handle'];
+ } elseif ( $this->is_print() ) {
+ $this->_print_styles[] = $style['handle'];
+ } else {
+ wp_enqueue_style( $style['handle'] );
+ }
+ }
+ }
+ }
- return $html;
+ /**
+ * Target of gform_preview_styles. Enqueue styles to the preview page.
+ * Not intented to be overriden by child classes
+ *
+ * @ignore
+ */
+ public function enqueue_preview_styles( $preview_styles, $form ) {
+ return array_merge( $preview_styles, $this->_preview_styles );
}
/**
- * Returns the markup for an individual checkbox item give the parameters
- *
- * @param $choice - Choice array with all configured properties
- * @param $horizontal_class - CSS class to style checkbox items horizontally
- * @param $attributes - String containing all the attributes for the input tag.
- * @param $value - Currently selection (1 if field has been checked. 0 or null otherwise)
- * @param $tooltip - String containing a tooltip for this checkbox item.
+ * Target of gform_print_styles. Enqueue styles to the print entry page.
+ * Not intented to be overriden by child classes
*
- * @return string - The markup of an individual checkbox item
+ * @ignore
*/
- protected function checkbox_item( $choice, $horizontal_class, $attributes, $value, $tooltip ) {
- $hidden_field_value = $value == '1' ? '1' : '0';
- $checkbox_item = '
-
-
';
+ $styles = $this->styles();
+ foreach ( $styles as $style ) {
+ if ( $this->_can_enqueue_script( $style['enqueue'], $form, false ) ) {
+ $this->add_no_conflict_styles( array( $style['handle'] ) );
+ $src = isset( $style['src'] ) ? $style['src'] : false;
+ $deps = isset( $style['deps'] ) ? $style['deps'] : array();
+ $version = isset( $style['version'] ) ? $style['version'] : false;
+ $media = isset( $style['media'] ) ? $style['media'] : 'all';
+ wp_register_style( $style['handle'], $src, $deps, $version, $media );
+ $print_styles[] = $style['handle'];
+ }
+ }
- return $checkbox_item;
+ return array_merge( $print_styles, $this->_print_styles );
}
+
/**
- * Returns the markup for an individual checkbox input and its associated label
- *
- * @param $choice - Choice array with all configured properties
- * @param $attributes - String containing all the attributes for the input tag.
- * @param $value - Currently selection (1 if field has been checked. 0 or null otherwise)
- * @param $tooltip - String containing a tooltip for this checkbox item.
+ * Adds scripts to the list of white-listed no conflict scripts.
*
- * @return string - The markup of an individual checkbox input and its associated label
+ * @param $scripts
*/
- protected function checkbox_input( $choice, $attributes, $value, $tooltip ) {
- $markup = '' . esc_html( $choice['label'] ) . ' ' . $tooltip . ' ';
+ private function add_no_conflict_scripts( $scripts ) {
+ $this->_no_conflict_scripts = array_merge( $scripts, $this->_no_conflict_scripts );
- return $markup;
}
+ /**
+ * Adds styles to the list of white-listed no conflict styles.
+ *
+ * @param $styles
+ */
+ private function add_no_conflict_styles( $styles ) {
+ $this->_no_conflict_styles = array_merge( $styles, $this->_no_conflict_styles );
+ }
- /***
- * Renders and initializes a radio field or a collection of radio fields based on the $field array
- *
- * @param array $field - Field array containing the configuration options of this field
- * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
- * @return string Returns the markup for the radio buttons
- *
- */
- protected function settings_radio($field, $echo = true) {
-
- $field["type"] = "radio"; //making sure type is set to radio
-
- $selected_value = $this->get_setting($field['name'], rgar($field, "default_value"));
- $field_attributes = $this->get_field_attributes($field);
- $horizontal = rgar($field, "horizontal") ? " gaddon-setting-inline" : "";
- $html = "";
- if (is_array($field["choices"])) {
- foreach ($field["choices"] as $i => $choice) {
- $choice['id'] = $field['name'] . $i;
- $choice_attributes = $this->get_choice_attributes($choice, $field_attributes);
-
- $tooltip = isset( $choice['tooltip'] ) ? gform_tooltip( $choice['tooltip'], rgar( $choice, 'tooltip_class'), true ) : "";
-
- $radio_value = isset($choice["value"]) ? $choice["value"] : $choice["label"];
- $checked = checked($selected_value, $radio_value, false);
- $html .= '
-
-
- '. esc_html($choice['label']) . ' ' . $tooltip . '
-
-
- ';
- }
- }
+ private function _can_enqueue_script( $enqueue_conditions, $form, $is_ajax ) {
+ if ( empty( $enqueue_conditions ) ) {
+ return false;
+ }
- if( $this->field_failed_validation( $field ) )
- $html .= $this->get_error_icon( $field );
+ foreach ( $enqueue_conditions as $condition ) {
+ if ( is_callable( $condition ) ) {
+ return call_user_func( $condition, $form, $is_ajax );
+ } else {
+ $query_matches = isset( $condition['query'] ) ? $this->_request_condition_matches( $_GET, $condition['query'] ) : true;
+ $post_matches = isset( $condition['post'] ) ? $this->_request_condition_matches( $_POST, $condition['query'] ) : true;
+ $admin_page_matches = isset( $condition['admin_page'] ) ? $this->_page_condition_matches( $condition['admin_page'], rgar( $condition, 'tab' ) ) : true;
+ $field_type_matches = isset( $condition['field_types'] ) ? $this->_field_condition_matches( $condition['field_types'], $form ) : true;
+
+ if ( $query_matches && $post_matches && $admin_page_matches && $field_type_matches) {
+ return true;
+ }
+ }
+ }
- if ($echo)
- echo $html;
+ return false;
+ }
- return $html;
- }
+ private function _request_condition_matches( $request, $query ) {
+ parse_str( $query, $query_array );
+ foreach ( $query_array as $key => $value ) {
- /***
- * Renders and initializes a drop down field based on the $field array
- *
- * @param array $field - Field array containing the configuration options of this field
- * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
- *
- * @return string The HTML for the field
- */
- protected function settings_select( $field, $echo = true ) {
+ switch ( $value ) {
+ case '_notempty_' :
+ if ( rgempty( $key, $request ) ) {
+ return false;
+ }
+ break;
+ case '_empty_' :
+ if ( ! rgempty( $key, $request ) ) {
+ return false;
+ }
+ break;
+ default :
+ if ( rgar( $request, $key ) != $value ) {
+ return false;
+ }
+ break;
+ }
+ }
- $field['type'] = 'select'; // making sure type is set to select
- $attributes = $this->get_field_attributes($field);
- $value = $this->get_setting( $field['name'], rgar( $field, 'default_value' ) );
- $name = '' . esc_attr( $field['name'] );
+ return true;
+ }
- $html = sprintf(
- '%3$s ',
- '_gaddon_setting_' . $name, implode( ' ', $attributes ), $this->get_select_options( $field['choices'], $value )
- );
+ private function _page_condition_matches( $pages, $tab ) {
+ if ( ! is_array( $pages ) ) {
+ $pages = array( $pages );
+ }
- if( $this->field_failed_validation( $field ) )
- $html .= $this->get_error_icon( $field );
+ foreach ( $pages as $page ) {
+ switch ( $page ) {
+ case 'form_editor' :
+ if ( $this->is_form_editor() ) {
+ return true;
+ }
- if( $echo )
- echo $html;
+ break;
- return $html;
- }
+ case 'form_settings' :
+ if ( $this->is_form_settings( $tab ) ) {
+ return true;
+ }
- public function get_select_options( $choices, $selected_value ) {
+ break;
- $options = '';
+ case 'plugin_settings' :
+ if ( $this->is_plugin_settings( $tab ) ) {
+ return true;
+ }
- foreach( $choices as $choice ) {
+ break;
- if( isset( $choice['choices'] ) ) {
+ case 'app_settings' :
+ if ( $this->is_app_settings( $tab ) ) {
+ return true;
+ }
- $options .= sprintf( '%2$s ', $choice['label'], $this->get_select_options( $choice['choices'], $selected_value ) );
+ break;
- } else {
+ case 'plugin_page' :
+ if ( $this->is_plugin_page() ) {
+ return true;
+ }
- if( ! isset( $choice['value'] ) )
- $choice['value'] = $choice['label'];
+ break;
- $options .= $this->get_select_option( $choice, $selected_value );
+ case 'entry_view' :
+ if ( $this->is_entry_view() ) {
+ return true;
+ }
- }
+ break;
- }
+ case 'entry_edit' :
+ if ( $this->is_entry_edit() ) {
+ return true;
+ }
- return $options;
- }
+ break;
- protected function get_select_option( $choice, $selected_value ) {
- return sprintf( '%3$s ', esc_attr( $choice['value'] ), selected( $selected_value, $choice['value'], false ), $choice['label'] );
- }
+ case 'results' :
+ if ( $this->is_results() ) {
+ return true;
+ }
+ break;
- //------------- Field Map Field Type --------------------------
+ }
+ }
- public function settings_field_map( $field, $echo = true ) {
+ return false;
- $html = '';
- $field_map = rgar( $field, 'field_map' );
+ }
- if( empty( $field_map ) ) {
- return $html;
+ private function _field_condition_matches( $field_types, $form ) {
+ if ( ! is_array( $field_types ) ) {
+ $field_types = array( $field_types );
}
- $form_id = rgget( 'id' );
-
- $html .= '
-
-
-
- ' . $this->field_map_title() . '
- ' . __( "Form Field", "gravityforms" ) . '
-
-
- ';
+ $fields = GFCommon::get_fields_by_type( $form, $field_types );
+ if ( count( $fields ) > 0 ) {
+ return true;
+ }
- foreach( $field['field_map'] as $child_field ) {
+ return false;
+ }
- if( ! $this->setting_dependency_met( rgar( $child_field, 'dependency' ) ) )
- continue;
+ /**
+ * Target for the gform_noconflict_scripts filter. Adds scripts to the list of white-listed no conflict scripts.
+ *
+ * Not intended to be overridden or called directed by Add-Ons.
+ *
+ * @ignore
+ *
+ * @param array $scripts Array of scripts to be white-listed
+ *
+ * @return array
+ */
+ public function register_noconflict_scripts( $scripts ) {
+ //registering scripts with Gravity Forms so that they get enqueued when running in no-conflict mode
+ return array_merge( $scripts, $this->_no_conflict_scripts );
+ }
- $child_field['name'] = $this->get_mapped_field_name( $field, $child_field['name'] );
- $required = rgar( $child_field, 'required' ) ? $this->get_required_indicator( $child_field ) : '';
+ /**
+ * Target for the gform_noconflict_styles filter. Adds styles to the list of white-listed no conflict scripts.
+ *
+ * Not intended to be overridden or called directed by Add-Ons.
+ *
+ * @ignore
+ *
+ * @param array $styles Array of styles to be white-listed
+ *
+ * @return array
+ */
+ public function register_noconflict_styles( $styles ) {
+ //registering styles with Gravity Forms so that they get enqueued when running in no-conflict mode
+ return array_merge( $styles, $this->_no_conflict_styles );
+ }
- $html .= '
-
-
- ' . $child_field['label'] . ' ' . $required . '
-
- ' .
- $this->settings_field_map_select( $child_field, $form_id ) .
- '
- ';
- }
- $html .= '
-
-
';
- if( $echo )
- echo $html;
+ //-------------- Entry meta --------------------------------------
- return $html;
- }
+ /**
+ * Override this method to activate and configure entry meta.
+ *
+ *
+ * @param array $entry_meta An array of entry meta already registered with the gform_entry_meta filter.
+ * @param int $form_id The form id
+ *
+ * @return array The filtered entry meta array.
+ */
+ protected function get_entry_meta( $entry_meta, $form_id ) {
+ return $entry_meta;
+ }
- public function settings_field_map_select( $field, $form_id ) {
- $field['choices'] = $this->get_field_map_choices( $form_id );
- return $this->settings_select( $field, false );
- }
- protected function field_map_title(){
- return __("Field", "gravityforms");
- }
+ //-------------- Results page --------------------------------------
+ /**
+ * Returns the configuration for the results page. By default this is not activated.
+ * To activate the results page override this function and return an array with the configuration data.
+ *
+ * Example:
+ * public function get_results_page_config() {
+ * return array(
+ * "title" => 'Quiz Results',
+ * "capabilities" => array("gravityforms_quiz_results"),
+ * "callbacks" => array(
+ * "fields" => array($this, 'results_fields'),
+ * "calculation" => array($this, 'results_calculation'),
+ * "markup" => array($this, 'results_markup'),
+ * )
+ * );
+ * }
+ *
+ */
+ public function get_results_page_config() {
+ return false;
+ }
- public static function get_field_map_choices( $form_id ) {
+ /**
+ * Initializes the result page functionality. To activate result page functionality, override the get_results_page_config() function.
+ *
+ * @param $results_page_config - configuration returned by get_results_page_config()
+ */
+ protected function results_page_init( $results_page_config ) {
+ require_once( 'class-gf-results.php' );
- $form = RGFormsModel::get_form_meta($form_id);
+ if ( isset( $results_page_config['callbacks']['filters'] ) ) {
+ add_filter( 'gform_filters_pre_results', $results_page_config['callbacks']['filters'], 10, 2 );
+ }
- $fields = array();
+ if ( isset( $results_page_config['callbacks']['filter_ui'] ) ) {
+ add_filter( 'gform_filter_ui', $results_page_config['callbacks']['filter_ui'], 10, 5 );
+ }
- // Adding default fields
- $fields[] = array( "value" => "", "label" => "" );
- $fields[] = array( "value" => "date_created" , "label" => __("Entry Date", "gravityforms") );
- $fields[] = array( "value" => "ip" , "label" => __("User IP", "gravityforms") );
- $fields[] = array( "value" => "source_url" , "label" => __("Source Url", "gravityforms") );
- $fields[] = array( "value" => "form_title" , "label" => __("Form Title", "gravityforms") );
+ $gf_results = new GFResults( $this->_slug, $results_page_config );
+ $gf_results->init();
+ }
- // Populate entry meta
- $entry_meta = GFFormsModel::get_entry_meta( $form["id"] );
- foreach( $entry_meta as $meta_key => $meta ) {
- $fields[] = array( 'value' => $meta_key , 'label' => rgars($entry_meta, "{$meta_key}/label") );
- }
+ //-------------- Logging integration --------------------------------------
- // Populate form fields
- if( is_array( $form["fields"] ) ) {
- foreach( $form["fields"] as $field ) {
- if( is_array( rgar( $field, "inputs") ) ) {
+ public function set_logging_supported( $plugins ) {
+ $plugins[ $this->_slug ] = $this->_title;
- //If this is an address field, add full name to the list
- if(RGFormsModel::get_input_type($field) == "address")
- $fields[] = array( 'value' => $field["id"], 'label' => GFCommon::get_label($field) . " (" . __("Full" , "gravityforms") . ")" );
+ return $plugins;
+ }
- //If this is a name field, add full name to the list
- if(RGFormsModel::get_input_type($field) == "name")
- $fields[] = array( 'value' => $field["id"], 'label' => GFCommon::get_label($field) . " (" . __("Full" , "gravityforms") . ")" );
- //If this is a checkbox field, add to the list
- if(RGFormsModel::get_input_type($field) == "checkbox")
- $fields[] = array( 'value' => $field["id"], 'label' => GFCommon::get_label($field) . " (" . __("Selected" , "gravityforms") . ")" );
+ //-------------- Members plugin integration --------------------------------------
- foreach( $field['inputs'] as $input ) {
- if( RGFormsModel::get_input_type( $field ) == 'creditcard' ) {
- //only include the credit card type (field_id.4) and number (field_id.1)
- if ( $input['id'] == $field['id'] . '.1' || $input['id'] == $field['id'] . '.4' ) {
- $fields[] = array( 'value' => $input["id"], 'label' => GFCommon::get_label( $field, $input['id'] ) );
- }
- }
- else {
- $fields[] = array( 'value' => $input["id"], 'label' => GFCommon::get_label($field, $input["id"]) );
- }
- }
- }
- else if(!rgar($field,"displayOnly")){
- $fields[] = array( 'value' => $field["id"], 'label' => GFCommon::get_label($field));
- }
- }
- }
+ /**
+ * Checks whether the Members plugin is installed and activated.
+ *
+ * Not intended to be overridden or called directly by Add-Ons.
+ *
+ * @ignore
+ *
+ * @return bool
+ */
+ protected function has_members_plugin() {
+ return function_exists( 'members_get_capabilities' );
+ }
- return $fields;
- }
+ /**
+ * Not intended to be overridden or called directly by Add-Ons.
+ *
+ * @ignore
+ *
+ * @param $caps
+ *
+ * @return array
+ */
+ public function members_get_capabilities( $caps ) {
+ return array_merge( $caps, $this->_capabilities );
+ }
- public function get_mapped_field_name( $parent_field, $field_name ) {
- return "{$parent_field['name']}_{$field_name}";
- }
+ //-------------- Permissions: Capabilities and Roles ----------------------------
- public static function get_field_map_fields( $feed, $field_name ) {
+ /**
+ * Checks whether the current user is assigned to a capability or role.
+ *
+ * @param string|array $caps An string or array of capabilities to check
+ *
+ * @return bool Returns true if the current user is assigned to any of the capabilities.
+ */
+ protected function current_user_can_any( $caps ) {
+ return GFCommon::current_user_can_any( $caps );
+ }
- $fields = array();
- $prefix = "{$field_name}_";
- foreach( $feed['meta'] as $name => $value ) {
- if( strpos( $name, $prefix ) === 0 ) {
- $name = str_replace( $prefix, '', $name );
- $fields[$name] = $value;
- }
- }
+ //------- Settings Helper Methods (Common to all settings pages) -------------------
- return $fields;
- }
+ /***
+ * Renders the UI of all settings page based on the specified configuration array $sections
+ *
+ * @param array $sections - Configuration array containing all fields to be rendered grouped into sections
+ */
+ protected function render_settings( $sections ) {
- //----------------------------------------------------------------
+ if ( ! $this->has_setting_field_type( 'save', $sections ) ) {
+ $sections = $this->add_default_save_button( $sections );
+ }
+ ?>
- public function settings_dynamic_field_map( $field, $echo = true ) {
+
- $field['choices'] = $field['key_choices'];
- if( $field['enable_custom_key'] )
- $field['choices']['_gf_add_custom'] = array( 'value' => '_gf_add_custom', 'label' => __( 'Add Custom', 'gravityforms' ) );
+ setting_dependency_met( rgar( $section, 'dependency' ) ) ) {
+ $this->single_section( $section, $is_first );
+ }
- $value_field = $field;
- $value_field['name'] = '_value';
- $value_field['class'] = 'value_{i}';
+ $is_first = false;
+ }
+ }
- $html .= '
-
-
-
- ' . $this->field_map_title() . '
- ' . __( 'Form Field', 'gravityforms' ) . '
-
-
-
-
-
- ' .
- $this->settings_select( $key_field, false ) .
- '
- ' .
- $this->settings_field_map_select( $value_field, $form['id'] ) .
- '
- {buttons}
-
-
-
';
+ /***
+ * Displays the UI for a field section
+ *
+ * @param array $section - The section to be displayed
+ * @param bool $is_first - true for the first section in the list, false for all others
+ */
+ protected function single_section( $section, $is_first = false ) {
+
+ extract(
+ wp_parse_args(
+ $section, array(
+ 'title' => false,
+ 'description' => false,
+ 'id' => '',
+ 'class' => false,
+ 'style' => '',
+ ''
+ )
+ )
+ );
+
+ $classes = array( 'gaddon-section' );
+
+ if ( $is_first ) {
+ $classes[] = 'gaddon-first-section';
+ }
- $html .= $this->settings_hidden( $field, false );
+ if ( $class )
+ $classes[] = $class;
- if( $echo )
- echo $html;
+ ?>
- return $html;
+
- }
+
+
+
- public function settings_field_select( $field, $echo = true ) {
+
+
+
- $args = is_array( rgar( $field, 'args' ) ) ? rgar( $field, 'args' ) : array( rgar( $field, 'args' ) );
+
- if( ! empty( $args['append_choices'] ) )
- $field['choices'] = array_merge( $field['choices'], $args['append_choices'] );
+
>
+
+ single_setting_label( $field ); ?>
+
+
+ single_setting( $field ); ?>
+
+
- if( ! is_array( $form['fields'] ) )
- return $fields;
+ array(),
- 'input_types' => array()
- ) );
+ protected function single_setting_label( $field ) {
- foreach( $form['fields'] as $field ) {
+ echo $field['label'];
- $input_type = GFFormsModel::get_input_type( $field );
+ if ( isset( $field['tooltip'] ) ) {
+ echo ' ' . gform_tooltip( $field['tooltip'], rgar( $field, 'tooltip_class' ), true );
+ }
- if( ! empty( $args['input_types'] ) && ! in_array( $input_type, $args['input_types'] ) )
- continue;
+ if ( rgar( $field, 'required' ) ) {
+ echo ' ' . $this->get_required_indicator( $field );
+ }
- if( is_array( rgar( $field, 'inputs' ) ) ) {
+ }
- // if this is an address field, add full name to the list
- if( $input_type == 'address' )
- $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Full' , 'gravityforms' ) . ')' );
+ protected function single_setting_row_save( $field ) {
+ ?>
- // if this is a name field, add full name to the list
- if( $input_type == 'name' )
- $fields[] = array( 'value' => $field["id"], 'label' => GFCommon::get_label($field) . ' (' . __( 'Full', 'gravityforms' ) . ')' );
+
+
+ single_setting( $field ); ?>
+
+
- // if this is a checkbox field, add to the list
- if( $input_type == 'checkbox' )
- $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label($field) . ' (' . __( 'Selected', 'gravityforms' ) . ')' );
+ $input['id'], 'label' => GFCommon::get_label( $field, $input['id'] ) );
- }
+ /***
+ * Calls the appropriate field function to handle rendering of each specific field type
+ *
+ * @param array $field - The field to be rendered
+ */
+ protected function single_setting( $field ) {
+ if ( is_callable( rgar( $field, 'callback' ) ) ) {
+ call_user_func( $field['callback'], $field );
+ } else if ( is_callable( array( $this, "settings_{$field['type']}" ) ) ) {
+ call_user_func( array( $this, "settings_{$field['type']}" ), $field );
+ } else {
+ printf( __( "Field type '%s' has not been implemented", 'gravityforms' ), $field['type'] );
+ }
+ }
- }
- else if( ! rgar( $field, 'displayOnly' ) ) {
+ /***
+ * Sets the current saved settings to a class variable so that it can be accessed by lower level functions in order to initialize inputs with the appropriate values
+ *
+ * @param array $settings : Settings to be saved
+ */
+ protected function set_settings( $settings ) {
+ $this->_saved_settings = $settings;
+ }
- $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) );
+ /***
+ * Sets the previous settings to a class variable so that it can be accessed by lower level functions providing support for
+ * verifying whether a value was changed before executing an action
+ *
+ * @param array $settings : Settings to be stored
+ */
+ protected function set_previous_settings( $settings ) {
+ $this->_previous_settings = $settings;
+ }
- }
- }
+ protected function get_previous_settings() {
+ return $this->_previous_settings;
+ }
- return $fields;
- }
+ /***
+ * Gets settings from $_POST variable, returning a name/value collection of setting name and setting value
+ */
+ protected function get_posted_settings() {
+ global $_gaddon_posted_settings;
+ if ( isset( $_gaddon_posted_settings ) )
+ return $_gaddon_posted_settings;
+ $_gaddon_posted_settings = array();
+ if ( count( $_POST ) > 0 ) {
+ foreach ( $_POST as $key => $value ) {
+ if ( preg_match( '|_gaddon_setting_(.*)|', $key, $matches ) ) {
+ $_gaddon_posted_settings[ $matches[1] ] = self::maybe_decode_json( stripslashes_deep( $value ) );
+ }
+ }
+ }
+ return $_gaddon_posted_settings;
+ }
+ protected static function maybe_decode_json( $value ) {
+ if ( self::is_json( $value ) )
+ return json_decode( $value, ARRAY_A );
- /***
- * Renders the save button for settings pages
- *
- * @param array $field - Field array containing the configuration options of this field
- * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
- *
- * @return string The HTML
- */
- protected function settings_save( $field, $echo = true ) {
+ return $value;
+ }
- $field['type'] = 'submit';
- $field['name'] = 'gform-settings-save';
- $field['class'] = 'button-primary gfbutton';
+ protected static function is_json( $value ) {
+ if ( is_string( $value ) && in_array( substr( $value, 0, 1 ), array( '{', '[' ) ) && is_array( json_decode( $value, ARRAY_A ) ) )
+ return true;
- if( ! rgar( $field, 'value' ) )
- $field['value'] = __( 'Update Settings', 'gravityforms' );
+ return false;
+ }
- $attributes = $this->get_field_attributes( $field );
+ /***
+ * Gets the "current" settings, which are settings from $_POST variables if this is a postback request, or the current saved settings for a get request.
+ */
+ protected function get_current_settings() {
+ //try getting settings from post
+ $settings = $this->get_posted_settings();
- $html = 'checkbox_item( $choice, $horizontal, $choice_attributes, $value, $tooltip );
+
+ }
+ }
+
+ if ( $this->field_failed_validation( $field ) )
+ $html .= $this->get_error_icon( $field );
+
+ if ( $echo )
+ echo $html;
+
+ return $html;
+ }
+
+
+ /**
+ * Returns the markup for an individual checkbox item give the parameters
+ *
+ * @param $choice - Choice array with all configured properties
+ * @param $horizontal_class - CSS class to style checkbox items horizontally
+ * @param $attributes - String containing all the attributes for the input tag.
+ * @param $value - Currently selection (1 if field has been checked. 0 or null otherwise)
+ * @param $tooltip - String containing a tooltip for this checkbox item.
+ *
+ * @return string - The markup of an individual checkbox item
+ */
+ protected function checkbox_item( $choice, $horizontal_class, $attributes, $value, $tooltip ) {
+ $hidden_field_value = $value == '1' ? '1' : '0';
+ $checkbox_item = '
+
+
';
+
+ return $checkbox_item;
+ }
+
+ /**
+ * Returns the markup for an individual checkbox input and its associated label
+ *
+ * @param $choice - Choice array with all configured properties
+ * @param $attributes - String containing all the attributes for the input tag.
+ * @param $value - Currently selection (1 if field has been checked. 0 or null otherwise)
+ * @param $tooltip - String containing a tooltip for this checkbox item.
+ *
+ * @return string - The markup of an individual checkbox input and its associated label
+ */
+ protected function checkbox_input( $choice, $attributes, $value, $tooltip ) {
+ $markup = '' . esc_html( $choice['label'] ) . ' ' . $tooltip . ' ';
+
+ return $markup;
+ }
+
+
+ /***
+ * Renders and initializes a radio field or a collection of radio fields based on the $field array
+ *
+ * @param array $field - Field array containing the configuration options of this field
+ * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
+ *
+ * @return string Returns the markup for the radio buttons
+ *
+ */
+ protected function settings_radio( $field, $echo = true ) {
+
+ $field['type'] = 'radio'; //making sure type is set to radio
+
+ $selected_value = $this->get_setting( $field['name'], rgar( $field, 'default_value' ) );
+ $field_attributes = $this->get_field_attributes( $field );
+ $horizontal = rgar( $field, 'horizontal' ) ? ' gaddon-setting-inline' : '';
+ $html = '';
+ if ( is_array( $field['choices'] ) ) {
+ foreach ( $field['choices'] as $i => $choice ) {
+ $choice['id'] = $field['name'] . $i;
+ $choice_attributes = $this->get_choice_attributes( $choice, $field_attributes );
+
+ $tooltip = isset( $choice['tooltip'] ) ? gform_tooltip( $choice['tooltip'], rgar( $choice, 'tooltip_class' ), true ) : '';
+
+ $radio_value = isset( $choice['value'] ) ? $choice['value'] : $choice['label'];
+ $checked = checked( $selected_value, $radio_value, false );
+ $html .= '
+
+
+ ' . esc_html( $choice['label'] ) . ' ' . $tooltip . '
+
+
+ ';
+ }
+ }
+
+ if ( $this->field_failed_validation( $field ) )
+ $html .= $this->get_error_icon( $field );
+
+ if ( $echo )
+ echo $html;
+
+ return $html;
+ }
+
+ /***
+ * Renders and initializes a drop down field based on the $field array
+ *
+ * @param array $field - Field array containing the configuration options of this field
+ * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
+ *
+ * @return string The HTML for the field
+ */
+ protected function settings_select( $field, $echo = true ) {
+
+ $field['type'] = 'select'; // making sure type is set to select
+ $attributes = $this->get_field_attributes( $field );
+ $value = $this->get_setting( $field['name'], rgar( $field, 'default_value' ) );
+ $name = '' . esc_attr( $field['name'] );
+
+ $html = sprintf(
+ '%3$s ',
+ '_gaddon_setting_' . $name, implode( ' ', $attributes ), $this->get_select_options( $field['choices'], $value )
+ );
+
+ if ( $this->field_failed_validation( $field ) )
+ $html .= $this->get_error_icon( $field );
+
+ if ( $echo )
+ echo $html;
+
+ return $html;
+ }
+
+ public function get_select_options( $choices, $selected_value ) {
+
+ $options = '';
+
+ foreach ( $choices as $choice ) {
+
+ if ( isset( $choice['choices'] ) ) {
+
+ $options .= sprintf( '%2$s ', $choice['label'], $this->get_select_options( $choice['choices'], $selected_value ) );
+
+ } else {
+
+ if ( ! isset( $choice['value'] ) )
+ $choice['value'] = $choice['label'];
+
+ $options .= $this->get_select_option( $choice, $selected_value );
+
+ }
+ }
+
+ return $options;
+ }
+
+ protected function get_select_option( $choice, $selected_value ) {
+ if ( is_array( $selected_value ) ) {
+ $selected = in_array( $choice['value'], $selected_value ) ? "selected='selected'" : '';
+ } else {
+ $selected = selected( $selected_value, $choice['value'], false );
+ }
+
+ return sprintf( '%3$s ', esc_attr( $choice['value'] ), $selected, $choice['label'] );
+ }
+
+
+ //------------- Field Map Field Type --------------------------
+
+ public function settings_field_map( $field, $echo = true ) {
+
+ $html = '';
+ $field_map = rgar( $field, 'field_map' );
+
+ if ( empty( $field_map ) )
+ return $html;
+
+ $form_id = rgget( 'id' );
+
+ $html .= '
+
+
+
+ ' . $this->field_map_title() . '
+ ' . __( 'Form Field', 'gravityforms' ) . '
+
+
+ ';
+
+ foreach ( $field['field_map'] as $child_field ) {
+
+ if ( ! $this->setting_dependency_met( rgar( $child_field, 'dependency' ) ) )
+ continue;
+
+ $child_field['name'] = $this->get_mapped_field_name( $field, $child_field['name'] );
+ $required = rgar( $child_field, 'required' ) ? $this->get_required_indicator( $child_field ) : '';
+
+ $html .= '
+
+
+ ' . $child_field['label'] . ' ' . $required . '
+
+ ' .
+ $this->settings_field_map_select( $child_field, $form_id ) .
+ '
+ ';
+ }
+
+ $html .= '
+
+
';
+
+ if ( $echo )
+ echo $html;
+
+ return $html;
+ }
+
+ public function settings_field_map_select( $field, $form_id ) {
+ $field['choices'] = $this->get_field_map_choices( $form_id );
+
+ return $this->settings_select( $field, false );
+ }
+
+ protected function field_map_title() {
+ return __( 'Field', 'gravityforms' );
+ }
+
+ public static function get_field_map_choices( $form_id ) {
+
+ $form = RGFormsModel::get_form_meta( $form_id );
+
+ $fields = array();
+
+ // Adding default fields
+ $fields[] = array( 'value' => '', 'label' => '' );
+ $fields[] = array( 'value' => 'date_created', 'label' => __( 'Entry Date', 'gravityforms' ) );
+ $fields[] = array( 'value' => 'ip', 'label' => __( 'User IP', 'gravityforms' ) );
+ $fields[] = array( 'value' => 'source_url', 'label' => __( 'Source Url', 'gravityforms' ) );
+ $fields[] = array( 'value' => 'form_title', 'label' => __( 'Form Title', 'gravityforms' ) );
+
+ // Populate entry meta
+ $entry_meta = GFFormsModel::get_entry_meta( $form['id'] );
+ foreach ( $entry_meta as $meta_key => $meta ) {
+ $fields[] = array( 'value' => $meta_key, 'label' => rgars( $entry_meta, "{$meta_key}/label" ) );
+ }
+
+ // Populate form fields
+ if ( is_array( $form['fields'] ) ) {
+ foreach ( $form['fields'] as $field ) {
+ if ( is_array( rgar( $field, 'inputs' ) ) ) {
+
+ //If this is an address field, add full name to the list
+ if ( RGFormsModel::get_input_type( $field ) == 'address' ) {
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Full', 'gravityforms' ) . ')' );
+ }
+ //If this is a name field, add full name to the list
+ if ( RGFormsModel::get_input_type( $field ) == 'name' ){
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Full', 'gravityforms' ) . ')' );
+ }
+ //If this is a checkbox field, add to the list
+ if ( RGFormsModel::get_input_type( $field ) == 'checkbox' ) {
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Selected', 'gravityforms' ) . ')' );
+ }
+ foreach ( $field['inputs'] as $input ) {
+ if( RGFormsModel::get_input_type( $field ) == 'creditcard' ) {
+ //only include the credit card type (field_id.4) and number (field_id.1)
+ if ( $input['id'] == $field['id'] . '.1' || $input['id'] == $field['id'] . '.4' ) {
+ $fields[] = array( 'value' => $input['id'], 'label' => GFCommon::get_label( $field, $input['id'] ) );
+ }
+ }
+ else {
+ $fields[] = array( 'value' => $input['id'], 'label' => GFCommon::get_label( $field, $input['id'] ) );
+ }
+ }
+ }
+ else if ( ! rgar( $field, 'displayOnly' ) ) {
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) );
+ }
+ }
+ }
+
+ return $fields;
+ }
+
+ public function get_mapped_field_name( $parent_field, $field_name ) {
+ return "{$parent_field['name']}_{$field_name}";
+ }
+
+ public static function get_field_map_fields( $feed, $field_name ) {
+
+ $fields = array();
+ $prefix = "{$field_name}_";
+
+ foreach ( $feed['meta'] as $name => $value ) {
+ if ( strpos( $name, $prefix ) === 0 ) {
+ $name = str_replace( $prefix, '', $name );
+ $fields[ $name ] = $value;
+ }
+ }
+
+ return $fields;
+ }
+
+ //----------------------------------------------------------------
+
+
+ public function settings_dynamic_field_map( $field, $echo = true ) {
+
+ $html = '';
+ $form = $this->get_current_form();
+
+ $field = wp_parse_args(
+ $field, array(
+ 'label' => false,
+ 'name' => false,
+ 'key_choices' => array(),
+ 'enable_custom_key' => true,
+ )
+ );
+
+ $field['choices'] = $field['key_choices'];
+ if ( $field['enable_custom_key'] )
+ $field['choices']['_gf_add_custom'] = array( 'value' => '_gf_add_custom', 'label' => __( 'Add Custom', 'gravityforms' ) );
+
+ $key_field = $field;
+ $key_field['name'] .= '_key';
+ $key_field['class'] = 'key_{i}';
+
+ $value_field = $field;
+ $value_field['name'] = '_value';
+ $value_field['class'] = 'value_{i}';
+
+ $html .= '
+
+
+
+ ' . $this->field_map_title() . '
+ ' . __( 'Form Field', 'gravityforms' ) . '
+
+
+
+
+
+ ' .
+ $this->settings_select( $key_field, false ) .
+ '
+ ' .
+ $this->settings_field_map_select( $value_field, $form['id'] ) .
+ '
+ {buttons}
+
+
+
';
+
+ $html .= $this->settings_hidden( $field, false );
+
+ if ( $echo )
+ echo $html;
+
+ return $html;
+
+ }
+
+ public function settings_field_select( $field, $echo = true ) {
+
+ $args = is_array( rgar( $field, 'args' ) ) ? rgar( $field, 'args' ) : array( rgar( $field, 'args' ) );
+
+ $args = wp_parse_args(
+ $args, array(
+ 'append_choices' => array(),
+ 'disable_first_choice' => false,
+ )
+ );
+
+ $field['choices'] = array();
+
+ if ( ! $args['disable_first_choice'] )
+ $field['choices'][] = array( 'value' => '', 'label' => '' );
+
+ $field['choices'] = array_merge( $field['choices'], $this->get_form_fields_as_choices( $this->get_current_form(), $args ) );
+
+ if ( ! empty( $args['append_choices'] ) )
+ $field['choices'] = array_merge( $field['choices'], $args['append_choices'] );
+
+ $html = $this->settings_select( $field, false );
+
+ if ( $echo )
+ echo $html;
+
+ return $html;
+ }
+
+ public function get_form_fields_as_choices( $form, $args = array() ) {
+
+ $fields = array();
+
+ if ( ! is_array( $form['fields'] ) )
+ return $fields;
+
+ $args = wp_parse_args(
+ $args, array(
+ 'field_types' => array(),
+ 'input_types' => array()
+ )
+ );
+
+ foreach ( $form['fields'] as $field ) {
+
+ $input_type = GFFormsModel::get_input_type( $field );
+
+ if ( ! empty( $args['input_types'] ) && ! in_array( $input_type, $args['input_types'] ) )
+ continue;
+
+ if ( is_array( rgar( $field, 'inputs' ) ) ) {
+
+ // if this is an address field, add full name to the list
+ if ( $input_type == 'address' )
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Full', 'gravityforms' ) . ')' );
+
+ // if this is a name field, add full name to the list
+ if ( $input_type == 'name' )
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Full', 'gravityforms' ) . ')' );
+
+ // if this is a checkbox field, add to the list
+ if ( $input_type == 'checkbox' )
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) . ' (' . __( 'Selected', 'gravityforms' ) . ')' );
+
+ foreach ( $field['inputs'] as $input ) {
+ $fields[] = array( 'value' => $input['id'], 'label' => GFCommon::get_label( $field, $input['id'] ) );
+ }
+ } else if ( ! rgar( $field, 'displayOnly' ) ) {
+
+ $fields[] = array( 'value' => $field['id'], 'label' => GFCommon::get_label( $field ) );
+
+ }
+ }
+
+ return $fields;
+ }
+
+
+ /***
+ * Renders the save button for settings pages
+ *
+ * @param array $field - Field array containing the configuration options of this field
+ * @param bool $echo = true - true to echo the output to the screen, false to simply return the contents as a string
+ *
+ * @return string The HTML
+ */
+ protected function settings_save( $field, $echo = true ) {
+
+ $field['type'] = 'submit';
+ $field['name'] = 'gform-settings-save';
+ $field['class'] = 'button-primary gfbutton';
+
+ if ( ! rgar( $field, 'value' ) )
+ $field['value'] = __( 'Update Settings', 'gravityforms' );
+
+ $attributes = $this->get_field_attributes( $field );
+
+ $html = '
';
- }
-
- /**
- * Gets the required indicator
- * Gets the markup of the required indicator symbol to highlight fields that are required
- * @param $field - The field meta.
- * @return string - Returns markup of the required indicator symbol
- */
- protected function get_required_indicator( $field ) {
- return '* ';
- }
-
- /**
- * Checks if the specified field failed validation
- *
- * @param $field - The field meta to be checked
- * @return bool|mixed - Returns a validation error string if the field has failed validation. Otherwise returns false
- */
- protected function field_failed_validation( $field ) {
- $field_error = $this->get_field_errors( $field );
- return !empty( $field_error ) ? $field_error : false;
- }
-
- protected function add_field_before( $name, $fields, $settings ) {
- return $this->add_field( $name, $fields, $settings, 'before' );
- }
-
- protected function add_field_after( $name, $fields, $settings ) {
- return $this->add_field( $name, $fields, $settings, 'after' );
- }
-
- protected function add_field( $name, $fields, $settings, $pos ) {
-
- if( rgar( $fields, 'name' ) )
- $fields = array( $fields );
-
- $pos_mod = $pos == 'before' ? 0 : 1;
-
- foreach( $settings as &$section ) {
- for( $i = 0; $i < count( $section['fields'] ); $i++ ) {
- if( $section['fields'][$i]['name'] == $name ) {
- array_splice( $section['fields'], $i + $pos_mod, 0, $fields );
- break 2;
- }
- }
- }
-
- return $settings;
- }
-
- protected function remove_field( $name, $settings ) {
-
- foreach( $settings as &$section ) {
- for( $i = 0; $i < count( $section['fields'] ); $i++ ) {
- if( $section['fields'][$i]['name'] == $name ) {
- array_splice( $section['fields'], $i, 1 );
- break 2;
- }
- }
- }
-
- return $settings;
- }
-
- protected function replace_field( $name, $fields, $settings ) {
-
- if( rgar( $fields, 'name' ) )
- $fields = array( $fields );
-
- foreach( $settings as &$section ) {
- for( $i = 0; $i < count( $section['fields'] ); $i++ ) {
- if( $section['fields'][$i]['name'] == $name ) {
- array_splice( $section['fields'], $i, 1, $fields );
- break 2;
- }
- }
- }
-
- return $settings;
-
- }
-
- protected function get_field( $name, $settings ) {
- foreach( $settings as $section ) {
- for( $i = 0; $i < count( $section['fields'] ); $i++ ) {
- if( $section['fields'][$i]['name'] == $name )
- return $section['fields'][$i];
- }
- }
- return false;
- }
-
- public function build_choices( $key_value_pairs ) {
-
- $choices = array();
-
- if( ! is_array( $key_value_pairs ) )
- return $choices;
-
- $first_key = key( $key_value_pairs );
- $is_numeric = is_int( $first_key ) && $first_key === 0;
-
- foreach( $key_value_pairs as $value => $label ) {
- if( $is_numeric )
- $value = $label;
- $choices[] = array( 'value' => $value, 'label' => $label );
- }
-
- return $choices;
- }
-
- //-------------- Form settings ---------------------------------------------------
-
- /**
- * Initializes form settings page
- * Hooks up the required scripts and actions for the Form Settings page
- */
- protected function form_settings_init() {
- $view = rgget("view");
- $subview = rgget("subview");
- if($this->current_user_can_any($this->_capabilities_form_settings)){
- add_action('gform_form_settings_menu', array($this, 'add_form_settings_menu'), 10, 2);
- }
-
- if (rgget("page") == "gf_edit_forms" && $view == "settings" && $subview == $this->_slug && $this->current_user_can_any($this->_capabilities_form_settings)) {
- require_once(GFCommon::get_base_path() . "/tooltips.php");
- add_action("gform_form_settings_page_" . $this->_slug, array($this, 'form_settings_page'));
- }
- }
-
- /**
- * Initializes plugin settings page
- * Hooks up the required scripts and actions for the Plugin Settings page
- */
- protected function plugin_page_init(){
-
- if($this->current_user_can_any($this->_capabilities_plugin_page)){
- //creates the subnav left menu
- add_filter("gform_addon_navigation", array($this, 'create_plugin_page_menu'));
- }
-
- }
-
- /**
- * Creates plugin page menu item
- * Target of gform_addon_navigation filter. Creates a menu item in the left nav, linking to the plugin page
- *
- * @param $menus - Current list of menu items
- * @return array - Returns a new list of menu items
- */
- public function create_plugin_page_menu($menus){
-
- $menus[] = array("name" => $this->_slug, "label" => $this->get_short_title(), "callback" => array($this, "plugin_page_container"), "permission" => $this->_capabilities_plugin_page);
-
- return $menus;
- }
-
- /**
- * Renders the form settings page.
- *
- * Not intended to be overridden or called directly by Add-Ons.
- * Sets up the form settings page.
- *
- * @ignore
- */
- public function form_settings_page() {
-
- GFFormSettings::page_header($this->_title);
- ?>
-
-
-
-
-
- is_save_postback() ){
-
- // store a copy of the previous settings for cases where action whould only happen if value has changed
- $this->set_previous_settings( $this->get_form_settings( $form ) );
-
- $settings = $this->get_posted_settings();
- $sections = $this->form_settings_fields($form);
-
- $is_valid = $this->validate_settings( $sections, $settings );
- $result = false;
-
- if( $is_valid )
- $result = $this->save_form_settings($form, $settings);
-
- if( $result ) {
- GFCommon::add_message( $this->get_save_success_message($sections) );
- } else {
- GFCommon::add_error_message( $this->get_save_error_message($sections) );
- }
-
- return $result;
- }
-
- }
-
- /***
- * Saves form settings to form object
- *
- * @param array $form
- * @param array $settings
- * @return true|false True on success or false on error
- */
- public function save_form_settings($form, $settings){
- $form[$this->_slug] = $settings;
- $result = GFFormsModel::update_form_meta($form["id"], $form);
- return ! (false === $result);
- }
-
- /**
- * Checks whether the current Add-On has a form settings page.
- *
- * @return bool
- */
- private function has_form_settings_page() {
- return $this->method_is_overridden('form_settings_fields') || $this->method_is_overridden('form_settings');
- }
-
- /**
- * Custom form settings page
- * Override this function to implement a complete custom form settings page.
- * Before overriding this function, consider using the form_settings_fields() and specifying your field meta.
- */
- protected function form_settings($form){}
-
- /**
- * Custom form settings title
- * Override this function to display a custom title on the Form Settings Page.
- * By default, the first section in the configuration done in form_settings_fields() will be used as the page title.
- * Use this function to override that behavior and add a custom page title.
- */
- protected function form_settings_page_title(){
- return "";
- }
-
- /**
- * Override this function to customize the form settings icon
- */
- protected function form_settings_icon(){
- return "";
- }
-
- /**
- * Checks whether the current Add-On has a plugin page.
- *
- * @return bool
- */
- private function has_plugin_page() {
- return $this->method_is_overridden('plugin_page');
- }
-
- /**
- * Override this function to create a custom plugin page
- */
- protected function plugin_page(){
- }
-
- /**
- * Override this function to customize the plugin page icon
- */
- protected function plugin_page_icon(){
- return "";
- }
-
- /**
- * Override this function to customize the plugin page title
- */
- protected function plugin_page_title(){
- return $this->_title;
- }
-
- /**
- * Plugin page container
- * Target of the plugin menu left nav icon. Displays the outer plugin page markup and calls plugin_page() to render the actual page.
- * Override plugin_page() in order to provide a custom plugin page
- */
- public function plugin_page_container(){
- ?>
-
- plugin_page_icon();
- if(!empty($icon)){
- ?>
-
-
-
-
plugin_page_title() ?>
- plugin_page();
- ?>
-
_slug . '">' . __( 'Settings', 'gravityforms' ) . ' ');
-
- return $links;
- }
-
- /**
- * Plugin settings page
- */
- public function plugin_settings_page() {
- $icon = $this->plugin_settings_icon();
- if (empty($icon)){
+ }
+
+ /**
+ * Gets the required indicator
+ * Gets the markup of the required indicator symbol to highlight fields that are required
+ *
+ * @param $field - The field meta.
+ *
+ * @return string - Returns markup of the required indicator symbol
+ */
+ protected function get_required_indicator( $field ) {
+ return '* ';
+ }
+
+ /**
+ * Checks if the specified field failed validation
+ *
+ * @param $field - The field meta to be checked
+ *
+ * @return bool|mixed - Returns a validation error string if the field has failed validation. Otherwise returns false
+ */
+ protected function field_failed_validation( $field ) {
+ $field_error = $this->get_field_errors( $field );
+
+ return ! empty( $field_error ) ? $field_error : false;
+ }
+
+ protected function add_field_before( $name, $fields, $settings ) {
+ return $this->add_field( $name, $fields, $settings, 'before' );
+ }
+
+ protected function add_field_after( $name, $fields, $settings ) {
+ return $this->add_field( $name, $fields, $settings, 'after' );
+ }
+
+ protected function add_field( $name, $fields, $settings, $pos ) {
+
+ if ( rgar( $fields, 'name' ) )
+ $fields = array( $fields );
+
+ $pos_mod = $pos == 'before' ? 0 : 1;
+
+ foreach ( $settings as &$section ) {
+ for ( $i = 0; $i < count( $section['fields'] ); $i ++ ) {
+ if ( $section['fields'][ $i ]['name'] == $name ) {
+ array_splice( $section['fields'], $i + $pos_mod, 0, $fields );
+ break 2;
+ }
+ }
+ }
+
+ return $settings;
+ }
+
+ protected function remove_field( $name, $settings ) {
+
+ foreach ( $settings as &$section ) {
+ for ( $i = 0; $i < count( $section['fields'] ); $i ++ ) {
+ if ( $section['fields'][ $i ]['name'] == $name ) {
+ array_splice( $section['fields'], $i, 1 );
+ break 2;
+ }
+ }
+ }
+
+ return $settings;
+ }
+
+ protected function replace_field( $name, $fields, $settings ) {
+
+ if ( rgar( $fields, 'name' ) )
+ $fields = array( $fields );
+
+ foreach ( $settings as &$section ) {
+ for ( $i = 0; $i < count( $section['fields'] ); $i ++ ) {
+ if ( $section['fields'][ $i ]['name'] == $name ) {
+ array_splice( $section['fields'], $i, 1, $fields );
+ break 2;
+ }
+ }
+ }
+
+ return $settings;
+
+ }
+
+ protected function get_field( $name, $settings ) {
+ foreach ( $settings as $section ) {
+ for ( $i = 0; $i < count( $section['fields'] ); $i ++ ) {
+ if ( $section['fields'][ $i ]['name'] == $name )
+ return $section['fields'][ $i ];
+ }
+ }
+
+ return false;
+ }
+
+ public function build_choices( $key_value_pairs ) {
+
+ $choices = array();
+
+ if ( ! is_array( $key_value_pairs ) )
+ return $choices;
+
+ $first_key = key( $key_value_pairs );
+ $is_numeric = is_int( $first_key ) && $first_key === 0;
+
+ foreach ( $key_value_pairs as $value => $label ) {
+ if ( $is_numeric )
+ $value = $label;
+ $choices[] = array( 'value' => $value, 'label' => $label );
+ }
+
+ return $choices;
+ }
+
+ //-------------- Form settings ---------------------------------------------------
+
+ /**
+ * Initializes form settings page
+ * Hooks up the required scripts and actions for the Form Settings page
+ */
+ protected function form_settings_init() {
+ $view = rgget( 'view' );
+ $subview = rgget( 'subview' );
+ if ( $this->current_user_can_any( $this->_capabilities_form_settings ) ) {
+ add_action( 'gform_form_settings_menu', array( $this, 'add_form_settings_menu' ), 10, 2 );
+ }
+
+ if ( rgget( 'page' ) == 'gf_edit_forms' && $view == 'settings' && $subview == $this->_slug && $this->current_user_can_any( $this->_capabilities_form_settings ) ) {
+ require_once( GFCommon::get_base_path() . '/tooltips.php' );
+ add_action( 'gform_form_settings_page_' . $this->_slug, array( $this, 'form_settings_page' ) );
+ }
+ }
+
+ /**
+ * Initializes plugin settings page
+ * Hooks up the required scripts and actions for the Plugin Settings page
+ */
+ protected function plugin_page_init() {
+
+ if ( $this->current_user_can_any( $this->_capabilities_plugin_page ) ) {
+ //creates the subnav left menu
+ add_filter( 'gform_addon_navigation', array( $this, 'create_plugin_page_menu' ) );
+ }
+
+ }
+
+ /**
+ * Creates plugin page menu item
+ * Target of gform_addon_navigation filter. Creates a menu item in the left nav, linking to the plugin page
+ *
+ * @param $menus - Current list of menu items
+ *
+ * @return array - Returns a new list of menu items
+ */
+ public function create_plugin_page_menu( $menus ) {
+
+ $menus[] = array( 'name' => $this->_slug, 'label' => $this->get_short_title(), 'callback' => array( $this, 'plugin_page_container' ), 'permission' => $this->_capabilities_plugin_page );
+
+ return $menus;
+ }
+
+ /**
+ * Renders the form settings page.
+ *
+ * Not intended to be overridden or called directly by Add-Ons.
+ * Sets up the form settings page.
+ *
+ * @ignore
+ */
+ public function form_settings_page() {
+
+ GFFormSettings::page_header( $this->_title );
+ ?>
+
+
+ get_current_form();
+
+ $form_id = $form['id'];
+ $form = apply_filters( "gform_admin_pre_render_{$form_id}", apply_filters( 'gform_admin_pre_render', $form ) );
+
+ if ( $this->method_is_overridden( 'form_settings' ) ) {
+
+ //enables plugins to override settings page by implementing a form_settings() function
+ $this->form_settings( $form );
+ } else {
+
+ //saves form settings if save button was pressed
+ $this->maybe_save_form_settings( $form );
+
+ //reads current form settings
+ $settings = $this->get_form_settings( $form );
+ $this->set_settings( $settings );
+
+ //reading addon fields
+ $sections = $this->form_settings_fields( $form );
+
+ GFCommon::display_admin_message();
+
+ $page_title = $this->form_settings_page_title();
+ if ( empty( $page_title ) ) {
+ $page_title = rgar( $sections[0], 'title' );
+
+ //using first section title as page title, so disable section title
+ $sections[0]['title'] = false;
+ }
+ $icon = $this->form_settings_icon();
+ if ( empty( $icon ) ) {
+ $icon = '
+ plugin_page_icon();
+ if ( ! empty( $icon ) ) {
+ ?>
+
+
+
+
plugin_page_title() ?>
+ plugin_page();
+ ?>
+
' . __( 'Settings', 'gravityforms' ) . ' ' );
+
+ return $links;
+ }
+
+ /**
+ * Plugin settings page
+ */
+ public function plugin_settings_page() {
+ $icon = $this->plugin_settings_icon();
+ if ( empty( $icon ) ) {
+ $icon = ' plugin_settings_title() ?>
+
+
+
+
+ method_is_overridden( 'plugin_settings' ) ) {
+ //enables plugins to override settings page by implementing a plugin_settings() function
+ $this->plugin_settings();
+ } else if ( $this->maybe_uninstall() ) {
+ ?>
+
+ _title, "
", ' ' ), 'gravityforms' ) ?>
+
+ _title, "
", ' ' ), 'gravityforms' ) ?>
+
![](" . GFCommon::get_base_url() . "/images/calendar.png)
![](" . GFCommon::get_base_url() . "/images/delete.png)
" . esc_html($file_info["uploaded_filename"]) . "![reCAPTCHA](" . GFCommon::get_base_url() . "/images/captcha_$theme.jpg "reCAPTCHA")