'',
'title' => '',
'tab_label' => '',
'handler' => false,
'icon' => 'gform-icon--cog',
)
)
);
}
if ( ! isset( $tab_label ) || ! $tab_label ) {
$tab_label = $name;
}
/**
* Adds additional actions after settings pages are registered.
*
* @since Unknown
*
* @param string|array $handler The callback function being run.
*/
add_action( 'gform_settings_' . str_replace( ' ', '_', $name ), $handler );
self::$addon_pages[ $name ] = array( 'name' => $name, 'title' => $title, 'tab_label' => $tab_label, 'icon' => $icon );
}
/**
* Determines the content displayed on the Gravity Forms settings page.
*
* @since Unknown
* @access public
*
* @uses GFSettings::get_subview()
* @uses GFSettings::gravityforms_settings_page()
* @uses GFSettings::settings_uninstall_page()
* @uses GFSettings::page_header()
* @uses GFSettings::page_footer()
*
* @return void
*/
public static function settings_page() {
$subview = self::get_subview();
switch ( $subview ) {
case 'settings':
self::gravityforms_settings_page();
break;
case 'recaptcha':
self::recaptcha_page();
break;
case 'uninstall':
self::settings_uninstall_page();
break;
default:
self::page_header();
/**
* Fires in the settings page depending on which page of the settings page you are in (the Subview).
*
* @since Unknown
*
* @param mixed $subview The sub-section of the main Form's settings
*/
do_action( 'gform_settings_' . str_replace( ' ', '_', $subview ) );
self::page_footer();
}
}
/**
* Displays the Gravity Forms uninstall page.
*
* @since Unknown
* @access public
*
* @used-by GFSettings::settings_page()
* @uses GFSettings::page_header()
* @uses GFCommon::current_user_can_any()
* @uses GFFormsModel::drop_tables()
* @uses GFCommon::delete_directory()
* @uses GFFormsModel::get_upload_root()
* @uses GFCommon::current_user_can_any()
* @uses GFSettings::page_footer()
*/
public static function settings_uninstall_page() {
self::page_header( __( 'Uninstall Gravity Forms', 'gravityforms' ), '' );
if ( isset( $_POST['uninstall'] ) ) {
check_admin_referer( 'gform_uninstall', 'gform_uninstall_nonce' );
if ( ! GFCommon::current_user_can_uninstall() ) {
die( esc_html__( "You don't have adequate permission to uninstall Gravity Forms.", 'gravityforms' ) );
}
/**
* Used to perform any cleanup tasks when the uninstall button has been clicked on the Forms > Settings > Uninstall page.
*
* @since 2.6.9
*/
do_action( 'gform_uninstalling' );
// Background tasks cleanup moved to \Gravity_Forms\Gravity_Forms\Async\GF_Background_Process_Service_Provider().
// Removing cron task
wp_clear_scheduled_hook( 'gravityforms_cron' );
// Dropping all tables
RGFormsModel::drop_tables();
// Removing options
delete_option( 'rg_form_version' );
delete_option( 'rg_gforms_disable_css' );
delete_option( 'rg_gforms_enable_html5' );
delete_option( 'rg_gforms_captcha_public_key' );
delete_option( 'rg_gforms_captcha_private_key' );
delete_option( 'rg_gforms_captcha_type' );
delete_option( 'rg_gforms_message' );
delete_option( 'rg_gforms_currency' );
delete_option( 'rg_gforms_enable_akismet' );
delete_option( 'gf_dismissed_upgrades' );
delete_option( 'gf_db_version' );
delete_option( 'gf_previous_db_version' );
delete_option( 'gf_upgrade_lock' );
delete_option( 'gf_submissions_block' );
delete_option( 'gf_imported_file' );
delete_option( 'gf_imported_theme_file' );
delete_option( 'gf_rest_api_db_version' );
delete_option( 'gform_api_count' );
delete_option( 'gform_email_count' );
delete_option( 'gform_enable_toolbar_menu' );
delete_option( 'gform_enable_logging' );
delete_option( 'gform_pending_installation' );
delete_option( 'gform_version_info' );
delete_option( 'gform_enable_noconflict' );
delete_option( 'gform_enable_background_updates' );
delete_option( 'gform_sticky_admin_messages' );
delete_option( 'gform_upgrade_status' );
delete_option( 'gform_custom_choices' );
delete_option( 'gform_recaptcha_keys_status' );
delete_option( 'gform_upload_page_slug' );
delete_option( 'gravityformsaddon_gravityformswebapi_version' );
delete_option( 'gravityformsaddon_gravityformswebapi_settings' );
// Remove setup wizard data.
GFForms::get_service_container()->get( \Gravity_Forms\Gravity_Forms\Setup_Wizard\GF_Setup_Wizard_Service_Provider::SAVE_PREFS_ENDPOINT )->remove_setup_data();
// Removes license key
GFFormsModel::save_key( '' );
// Removing gravity forms upload folder
GFCommon::delete_directory( RGFormsModel::get_upload_root() );
// Delete Logging settings and logging files
gf_logging()->delete_settings();
gf_logging()->delete_log_files();
// Deactivating plugin
$plugin = 'gravityforms/gravityforms.php';
deactivate_plugins( $plugin );
update_option( 'recently_activated', array( $plugin => time() ) + (array) get_option( 'recently_activated' ) );
?>
", '' ) ?>
$addon ) {
if ( rgpost( 'addon' ) !== $addon->get_short_title() ) {
continue;
}
unset( $uninstallable_addons[ $key ] );
$addon->uninstall_addon();
break;
}
GFAddOn::addons_for_uninstall( array_values( $uninstallable_addons ) );
}
/**
* Renders the uninstall message when an addon is uninstalled.
*
* @since 2.5
*
*/
private static function uninstall_addon_message() {
if ( isset( self::$uninstalled_addon ) ) {
?>
", '' ) ?>
render();
self::page_footer();
}
/**
* Determine whether Orbital should be the default theme.
*
* @since 2.7.15
*
* @return bool
*/
public static function is_orbital_default() {
if ( 'orbital' == get_option( 'rg_gforms_default_theme' ) ) {
return true;
}
// If there is no default theme saved, and if this is an old installation, Gravity Theme should be the default.
if ( version_compare( get_option( 'rg_form_original_version', '1.0.0' ), '2.7.14.2', '<' ) ) {
return false;
}
return true;
}
/**
* Prepare Plugin Settings fields.
*
* @since 2.5
*
* @return array
*/
private static function plugin_settings_fields() {
$license_section_description = esc_html__( 'A valid license key is required for access to automatic plugin upgrades and product support.', 'gravityforms' );
$is_hidden = false;
if ( ! is_main_site() && GFCommon::is_network_active() ) {
$is_hidden = true;
$license_section_description = esc_html__( 'License key is managed by the administrator of this network', 'gravityforms' );
}
$fields = array(
'license_key' => array(
'title' => esc_html__( 'Support License Key', 'gravityforms' ),
'class' => 'gform-settings-panel--full',
'description' => $license_section_description,
'fields' => array(
array(
'name' => 'license_key',
'label' => esc_html__( 'Paste Your License Key Here', 'gravityforms' ),
'type' => 'text',
'input_type' => 'password',
'callback' => array( 'GFSettings', 'license_key_render_callback' ),
'class' => 'gform-admin-input',
'validation_callback' => array( 'GFSettings', 'license_key_validation_callback' ),
'hidden' => $is_hidden,
'after_input' => function () {
/**
* @var License\GF_License_API_Connector $license_connector
*/
$license_connector = GFForms::get_service_container()->get( License\GF_License_Service_Provider::LICENSE_API_CONNECTOR );
$is_save_postback = self::get_settings_renderer()->is_save_postback();
$license_key = $is_save_postback ? rgpost( '_gform_setting_license_key' ) : GFCommon::get_key();
if ( empty( $license_key ) ) {
delete_transient( 'rg_gforms_registration_error' );
return '';
}
$license_info = $license_connector->check_license( trim( $license_key ), ! $is_save_postback );
$usability = $license_info->get_usability();
$license_key_alert = sprintf(
'%s %s
',
$usability,
$is_save_postback && ! $license_info->can_be_used() ? __( 'Your license key was not updated. ', 'gravityforms' ) : null,
License\GF_License_Statuses::get_message_for_code( $license_info->get_status() )
);
delete_transient( 'rg_gforms_registration_error' );
return $license_key_alert;
},
'feedback_callback' => function () {
$license_key = GFCommon::get_key();
if ( empty( $license_key ) ) {
return License\GF_License_Statuses::USABILITY_ALLOWED;
}
/**
* @var License\GF_License_API_Connector $license_connector
*/
$license_connector = GFForms::get_service_container()->get( License\GF_License_Service_Provider::LICENSE_API_CONNECTOR );
$license_info = $license_connector->check_license();
return $license_info->get_usability();
},
'save_callback' => function( $field, $value ) {
// Remove non-alphanumeric characters.
$value = preg_replace( '/[^a-zA-Z0-9]/', '', $value );
if ( isset( $_POST['_gform_setting_license_key'] ) ) {
GFFormsModel::save_key( $value );
}
return $value;
},
),
),
),
'license_key_details' => array(
'id' => 'section_license_key_details',
'title' => __( 'Your License Details', 'gravityforms' ),
'class' => 'gform-settings-panel--no-padding gform-settings-panel--license-details',
'fields' => array(
array(
'name' => 'license_key_details',
'type' => 'html',
'html' => array( 'GFSettings', 'license_key_details_callback' ),
),
),
),
'currency' => array(
'id' => 'section_currency',
'title' => esc_html__( 'Default Currency', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'currency',
'description' => esc_html__( 'Select the default currency for your forms. This is used for product fields, credit card fields and others.', 'gravityforms' ),
'type' => 'select',
'choices' => RGCurrency::get_grouped_currency_options(),
'enhanced_ui' => true,
'after_select' => self::currency_message_callback(),
'save_callback' => function( $field, $value ) {
update_option( 'rg_gforms_currency', $value );
return $value;
},
),
),
),
'logging' => array(
'id' => 'section_enable_logging',
'title' => esc_html__( 'Logging', 'gravityforms' ),
'description' => esc_html__( 'Enable if you would like logging within Gravity Forms. Logging allows you to easily debug the inner workings of Gravity Forms to solve any possible issues. ', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'enable_logging',
'type' => 'toggle',
'toggle_label' => esc_html__( 'Enable Logging', 'gravityforms' ),
'save_callback' => function( $field, $value ) {
if ( (bool) $value ) {
GFSettings::enable_logging();
} else {
GFSettings::disable_logging();
}
return $value;
},
),
),
),
);
$fields['default_theme'] = array(
'id' => 'section_default_theme',
'title' => esc_html__( 'Default Form Theme', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'default_theme',
'type' => 'select',
'choices' => array(
array(
'label' => esc_html__( 'Gravity Forms 2.5 Theme', 'gravityforms' ),
'value' => 'gravity-theme',
'default' => ! self::is_orbital_default(),
),
array(
'label' => esc_html__( 'Orbital Theme (Recommended)', 'gravityforms' ),
'value' => 'orbital',
'default' => self::is_orbital_default(),
),
),
'description' => esc_html__( 'This theme will be used by default everywhere forms are embedded on your site.', 'gravityforms' ) . ' ' . esc_html__( 'Learn more about form theme and style settings.', 'gravityforms' ) . '',
'save_callback' => function( $field, $value ) {
update_option( 'rg_gforms_default_theme', $value );
return $value;
},
),
),
);
$fields['toolbar'] = array(
'id' => 'section_enable_toolbar',
'title' => esc_html__( 'Toolbar Menu', 'gravityforms' ),
'description' => esc_html__( 'Enable to display the forms menu in the WordPress top toolbar. The forms menu will display the ten forms recently opened in the form editor.', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'enable_toolbar',
'type' => 'toggle',
'toggle_label' => esc_html__( 'Enable Toolbar Menu', 'gravityforms' ),
'save_callback' => function( $field, $value ) {
update_option( 'gform_enable_toolbar_menu', (bool) $value );
return $value;
},
),
),
);
$fields['background_updates'] = array(
'id' => 'section_enable_background_updates',
'title' => esc_html__( 'Automatic Background Updates', 'gravityforms' ),
'description' => esc_html__( 'Enable to allow Gravity Forms to download and install bug fixes and security updates automatically in the background. Requires a valid license key.', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'enable_background_updates',
'type' => 'toggle',
'toggle_label' => esc_html__( 'Enable Automatic Background Updates', 'gravityforms' ),
'save_callback' => function( $field, $value ) {
update_option( 'gform_enable_background_updates', (bool) $value );
return $value;
},
),
),
);
$fields['no_conflict_mode'] = array(
'id' => 'section_conflict_mode',
'title' => esc_html__( 'No Conflict Mode', 'gravityforms' ),
'description' => esc_html__( 'Enable to prevent extraneous scripts and styles from being printed on a Gravity Forms admin pages, reducing conflicts with other plugins and themes.', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'enable_noconflict',
'type' => 'toggle',
'toggle_label' => esc_html__( 'No Conflict Mode', 'gravityforms' ),
'save_callback' => function( $field, $value ) {
update_option( 'gform_enable_noconflict', (bool) $value );
return $value;
},
),
),
);
$fields['akismet'] = array(
'id' => 'section_enable_akismet',
'title' => esc_html__( 'Akismet Integration', 'gravityforms' ),
'description' => esc_html__( 'Protect your form entries from spam using Akismet.', 'gravityforms' ),
'class' => 'gform-settings-panel--half',
'dependency' => array( 'GFCommon', 'has_akismet' ),
'fields' => array(
array(
'name' => 'enable_akismet',
'type' => 'toggle',
'toggle_label' => esc_html__( 'Enable Akismet Integration', 'gravityforms' ),
'default_value' => true,
'save_callback' => function( $field, $value ) {
update_option( 'rg_gforms_enable_akismet', (bool) $value );
return $value;
},
),
),
);
$fields['telemetry'] = array(
'id' => 'section_enable_telemetry_collection',
'title' => esc_html__( 'Data Collection', 'gravityforms' ),
'description' => sprintf( __( 'We love improving the form building experience for everyone in our community. By enabling data collection, you can help us learn more about how our customers use Gravity Forms. %1$sLearn more...%2$s', 'gravityforms' ), '', '' ),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'rg_gforms_dataCollection',
'type' => 'toggle',
'default_value' => get_option( 'rg_gforms_dataCollection', 0 ),
'toggle_label' => esc_html__( 'Enable Data Collection', 'gravityforms' ),
'save_callback' => function( $field, $value ) {
update_option( 'rg_gforms_dataCollection', (bool) $value ? 1 : 0 );
return $value;
},
),
),
);
/**
* Allows forcing the display of the disable CSS setting.
*
* @since 2.8
*
* @param bool $gform_display_disable_css_setting Indicates if the disable CSS setting should be displayed or not.
*/
$gform_display_disable_css_setting = apply_filters( 'gform_display_disable_css_setting', (bool) get_option( 'rg_gforms_disable_css' ) );
if ( $gform_display_disable_css_setting ) {
$fields['css'] = array(
'id' => 'section_default_css',
'title' => esc_html__( 'Output Default CSS', 'gravityforms' ),
'description' => sprintf(
esc_html__( 'Enable this option to output the default form CSS. Disable it if you plan to create your own CSS in a child theme. Note: after Gravity Forms 2.8, this setting will no longer appear on the settings page. If you previously had it enabled, you will need to use the %sgform_disable_css%s filter to disable it.', 'gravityforms' ),
'',
''
),
'class' => 'gform-settings-panel--half',
'fields' => array(
array(
'name' => 'disable_css',
'type' => 'toggle',
'toggle_label' => esc_html__( 'Disable CSS', 'gravityforms' ),
'save_callback' => function( $field, $value ) {
update_option( 'rg_gforms_disable_css', ! (bool) $value );
return $value;
},
),
),
);
}
// Check if user has hidden license details in the installation wizard.
$hide_license_option = get_option( 'rg_gforms_' . GF_Setup_Wizard_Endpoint_Save_Prefs::PARAM_HIDE_LICENSE, false );
// Cast license option to bool.
if ( $hide_license_option === 'true' ) {
$hide_license_option = true;
}
if ( $hide_license_option === 'false' ) {
$hide_license_option = false;
}
$display_license_details = ! $hide_license_option;
/**
* Allows display of the license details panel to be disabled.
*
* @since 2.5.17
*
* @param bool $display_license_details Indicates if the license details panel should be displayed.
*/
if ( ! apply_filters( 'gform_settings_display_license_details', $display_license_details ) ) {
unset( $fields['license_key_details'] );
}
/**
* Allows the plugin settings fields to be overridden before they are displayed.
*
* @since 2.5.17
*
* @param array $fields The plugin settings fields.
*/
return array_values( apply_filters( 'gform_plugin_settings_fields', $fields ) );
}
public static function license_key_details_callback() {
$key = GFCommon::get_key();
$empty_string = '' . __( 'Please enter a valid license key to see details.', 'gravityforms' ) . '
';
if ( empty( $key ) ) {
return $empty_string;
}
/**
* @var License\GF_License_API_Connector $license_connector
*/
$license_connector = GFForms::get_service_container()->get( License\GF_License_Service_Provider::LICENSE_API_CONNECTOR );
$license_info = $license_connector->check_license( $key );
if ( ! $license_info->can_be_used() ) {
return $empty_string;
}
$cta = $license_info->get_cta();
$days_left_header = $cta['type'] === 'text' ? __( 'Days Left', 'gravityforms' ) : '';
ob_start();
?>
markup() );
return $html;
}
/**
* Custom validation callback for the License Key Field.
*
* Callback is used so that we can skip validation if the License Key field is null.
*
* @since 2.5
*
* @param object $field The Field Object for the rendered input.
* @param mixed $value The current posted field value.
*
* @return void
*/
public static function license_key_validation_callback( $field, $value ) {
if ( is_null( $value ) ) {
return;
}
$field->do_validation( $value );
}
/**
* Initialize Plugin Settings fields renderer.
*
* @since 2.5
*/
public static function initialize_plugin_settings() {
require_once( GFCommon::get_base_path() . '/tooltips.php' );
$initial_values = array(
'license_key' => GFCommon::get_key(),
'default_theme' => get_option( 'rg_gforms_default_theme', 'gravity-theme' ),
'currency' => GFCommon::get_currency(),
'disable_css' => ! (bool) get_option( 'rg_gforms_disable_css' ),
'enable_noconflict' => (bool) get_option( 'gform_enable_noconflict' ),
'enable_akismet' => (bool) get_option( 'rg_gforms_enable_akismet', true ),
'enable_background_updates' => (bool) get_option( 'gform_enable_background_updates' ),
'enable_toolbar' => (bool) get_option( 'gform_enable_toolbar_menu' ),
'enable_logging' => (bool) get_option( 'gform_enable_logging' ),
);
$renderer = new Settings(
array(
'fields' => self::plugin_settings_fields(),
'header' => array(
'icon' => 'fa fa-gear',
'title' => esc_html__( 'Settings: General', 'gravityforms' ),
),
'input_name_prefix' => '_gform_setting',
'capability' => 'gravityforms_edit_settings',
'initial_values' => $initial_values,
'save_callback' => function( $values ) {
GFCommon::cache_remote_message();
},
)
);
self::set_settings_renderer( $renderer );
// Process save callback.
if ( self::get_settings_renderer()->is_save_postback() ) {
self::get_settings_renderer()->process_postback();
}
}
// # reCAPTCHA SETTINGS --------------------------------------------------------------------------------------------
/**
* Display reCAPTCHA Settings page.
*
* @since 2.5
*/
private static function recaptcha_page() {
if ( ! GFCommon::ensure_wp_version() ) {
return;
}
self::page_header();
wp_enqueue_style( 'gform_admin' );
// Initialize Settings renderer.
if ( ! self::get_settings_renderer() ) {
self::initialize_recaptcha_settings();
}
self::get_settings_renderer()->render();
self::page_footer();
}
/**
* Initialize reCAPTCHA Settings renderer.
*
* @since 2.5
*/
public static function initialize_recaptcha_settings() {
require_once( GFCommon::get_base_path() . '/tooltips.php' );
$renderer = new Settings(
array(
'fields' => array(
array(
'id' => 'recpatcha',
'title' => esc_html__( 'reCAPTCHA Settings', 'gravityforms' ),
'description' => sprintf(
'%s %s %s %s',
esc_html__( 'Gravity Forms integrates with reCAPTCHA, a free CAPTCHA service that uses an advanced risk analysis engine and adaptive challenges to keep automated software from engaging in abusive activities on your site. ', 'gravityforms' ),
esc_html__( 'Please note, only v2 keys are supported and checkbox keys are not compatible with invisible reCAPTCHA.', 'gravityforms' ),
esc_html__( 'These settings are required only if you decide to use the reCAPTCHA field.', 'gravityforms' ),
esc_html__( 'Get your reCAPTCHA Keys.', 'gravityforms' )
),
'class' => 'gform-settings-panel--full',
'fields' => array(
array(
'name' => 'public_key',
'label' => esc_html__( 'Site Key', 'gravityforms' ),
'tooltip' => gform_tooltip( 'settings_recaptcha_public', null, true ),
'type' => 'text',
'feedback_callback' => function( $value ) {
$key_status = get_option( 'gform_recaptcha_keys_status', null );
return is_null( $key_status ) ? ( rgblank( $value ) ? null : false ) : (bool) $key_status;
},
),
array(
'name' => 'private_key',
'label' => esc_html__( 'Secret Key', 'gravityforms' ),
'tooltip' => gform_tooltip( 'settings_recaptcha_private', null, true ),
'type' => 'text',
'feedback_callback' => function( $value ) {
$key_status = get_option( 'gform_recaptcha_keys_status', null );
return is_null( $key_status ) ? ( rgblank( $value ) ? null : false ) : (bool) $key_status;
},
),
array(
'name' => 'type',
'label' => esc_html__( 'Type', 'gravityforms' ),
'tooltip' => gform_tooltip( 'settings_recaptcha_type', null, true ),
'type' => 'radio',
'horizontal' => true,
'default_value' => 'checkbox',
'choices' => array(
array(
'label' => esc_html__( 'Checkbox', 'gravityforms' ),
'value' => 'checkbox',
),
array(
'label' => esc_html__( 'Invisible', 'gravityforms' ),
'value' => 'invisible',
),
),
),
array(
'name' => 'reset',
'label' => esc_html__( 'Validate Keys', 'gravityforms' ),
'type' => 'recaptcha_reset',
'callback' => array( 'GFSettings', 'settings_field_recaptcha_reset' ),
'hidden' => true,
'validation_callback' => function( $field, $value ) {
// If reCAPTCHA key is empty, exit.
if ( rgblank( $value ) ) {
return;
}
$values = GFSettings::get_settings_renderer()->get_posted_values();
// Get public, private keys, API response.
$public_key = rgar( $values, 'public_key' );
$private_key = rgar( $values, 'private_key' );
$response = rgpost( 'g-recaptcha-response' );
// If keys and response are provided, verify and save.
if ( $public_key && $private_key && $response ) {
// Log public, private keys, API response.
GFCommon::log_debug( __METHOD__ . '(): reCAPTCHA Site Key:' . print_r( $public_key, true ) );
GFCommon::log_debug( __METHOD__ . '(): reCAPTCHA Secret Key:' . print_r( $private_key, true ) );
GFCommon::log_debug( __METHOD__ . '(): reCAPTCHA Response:' . print_r( $response, true ) );
// Verify response.
$recaptcha = new GF_Field_CAPTCHA();
$recaptcha_response = $recaptcha->verify_recaptcha_response( $response, $private_key );
// Log verification response.
GFCommon::log_debug( __METHOD__ . '(): reCAPTCHA verification response:' . print_r( $recaptcha_response, true ) );
// If response is false, return validation error.
if ( $recaptcha_response === false ) {
$field->set_error( __( 'reCAPTCHA keys are invalid.', 'gravityforms' ) );
}
// Save status.
update_option( 'gform_recaptcha_keys_status', $recaptcha_response );
} else {
// Delete existing status.
delete_option( 'gform_recaptcha_keys_status' );
}
}
),
),
),
),
'save_button' => array(
'messages' => array(
'save' => esc_html__( 'Settings updated.', 'gravityforms' ),
'error' => __( 'reCAPTCHA keys are invalid.', 'gravityforms' ),
),
),
'input_name_prefix' => '_gform_setting',
'capability' => 'gravityforms_edit_settings',
'initial_values' => array(
'public_key' => get_option( 'rg_gforms_captcha_public_key' ),
'private_key' => get_option( 'rg_gforms_captcha_private_key' ),
'type' => get_option( 'rg_gforms_captcha_type' ),
),
'save_callback' => function( $values ) {
// reCAPTCHA.
update_option( 'rg_gforms_captcha_public_key', rgar( $values, 'public_key' ) );
update_option( 'rg_gforms_captcha_private_key', rgar( $values, 'private_key' ) );
update_option( 'rg_gforms_captcha_type', rgar( $values, 'type' ) );
},
'after_fields' => function() {
echo '';
printf( '', GFCommon::get_base_url() . '/js/plugin_settings.js' );
},
)
);
self::set_settings_renderer( $renderer );
// Process save callback.
if ( self::get_settings_renderer()->is_save_postback() ) {
self::get_settings_renderer()->process_postback();
}
}
/**
* Renders a reCAPTCHA verification field.
*
* @since 2.5
*
* @param array $props Field properties.
* @param bool $echo Output the field markup directly.
*
* @return string
*/
public static function settings_field_recaptcha_reset( $props = array(), $echo = true ) {
// Add setup message.
$html = sprintf(
'%s
',
esc_html__( 'Please complete the reCAPTCHA widget to validate your reCAPTCHA keys:', 'gravityforms' )
);
// Add reCAPTCHA container, reset input.
$html .= '';
$html .= sprintf( '', esc_attr( self::get_settings_renderer()->get_input_name_prefix() ), esc_attr( $props['name'] ) );
return $html;
}
// # SETTINGS RENDERER ---------------------------------------------------------------------------------------------
/**
* Gets the current instance of Settings handling settings rendering.
*
* @since 2.5
*
* @return false|Settings
*/
private static function get_settings_renderer() {
return self::$_settings_renderer;
}
/**
* Sets the current instance of Settings handling settings rendering.
*
* @since 2.5
*
* @param Settings $renderer Settings renderer.
*
* @return bool|WP_Error
*/
private static function set_settings_renderer( $renderer ) {
// Ensure renderer is an instance of Settings
if ( ! is_a( $renderer, 'Gravity_Forms\Gravity_Forms\Settings\Settings' ) ) {
return new WP_Error( 'Renderer must be an instance of Gravity_Forms\Gravity_Forms\Settings\Settings.' );
}
self::$_settings_renderer = $renderer;
return true;
}
/**
* Handles license upgrades from the Settings page.
*
* @since Unknown
* @access public
*
* @uses GFCommon::get_key()
* @uses GFCommon::post_to_manager()
*
* @return void
*/
public static function upgrade_license() {
$key = GFCommon::get_key();
$body = "key=$key";
$options = array( 'method' => 'POST', 'timeout' => 3, 'body' => $body );
$options['headers'] = array(
'Content-Type' => 'application/x-www-form-urlencoded; charset=' . get_option( 'blog_charset' ),
'Content-Length' => strlen( $body ),
'User-Agent' => 'WordPress/' . get_bloginfo( 'version' ),
);
$raw_response = GFCommon::post_to_manager( 'api.php', 'op=upgrade_message&key=' . GFCommon::get_key(), $options );
if ( is_wp_error( $raw_response ) || 200 != $raw_response['response']['code'] ) {
$message = '';
} else {
$message = $raw_response['body'];
}
// Validating that message is a valid Gravity Form message. If message is invalid, don't display anything.
if ( substr( $message, 0, 10 ) != '' ) {
$message = '';
}
echo $message;
exit;
}
/**
* Outputs the settings page header.
*
* @since Unknown
* @access public
*
* @uses SCRIPT_DEBUG
* @uses GFSettings::get_subview()
* @uses GFSettings::$addon_pages
* @uses GFCommon::get_browser_class()
* @uses GFCommon::display_dismissible_message()
*
* @param string $title Optional. The page title to be used. Defaults to an empty string.
* @param string $message Optional. The message to display in the header. Defaults to empty string.
*
* @return void
*/
public static function page_header( $title = '', $message = '' ) {
// Print admin styles.
wp_print_styles( array( 'jquery-ui-styles', 'gform_admin', 'gform_settings' ) );
$current_tab = self::get_subview();
// Build left side options, always have GF Settings first and Uninstall last, put add-ons in the middle.
$setting_tabs = array(
'10' => array( 'name' => 'settings', 'label' => __( 'Settings', 'gravityforms' ), 'icon' => 'gform-icon--cog' ),
'11' => array( 'name' => 'recaptcha', 'label' => __( 'reCAPTCHA', 'gravityforms' ), 'icon' => 'gform-icon--recaptcha' ),
);
// Remove an addon from the sidebar if it is uninstalled from the main uninstall page.
if ( rgpost( 'uninstall_addon' ) ) {
check_admin_referer( 'uninstall', 'gf_addon_uninstall' );
foreach ( self::$addon_pages as $key => $addon ) {
if ( $_POST['addon'] == $addon['tab_label'] ) {
unset( self::$addon_pages[ $key ] );
break;
}
}
// Set the uninstalled addon variable to display a success message.
self::$uninstalled_addon = $_POST['addon'];
}
if ( ! empty( self::$addon_pages ) ) {
$sorted_addons = self::$addon_pages;
asort( $sorted_addons );
// Add add-ons to menu
foreach ( $sorted_addons as $sorted_addon ) {
$setting_tabs[] = array(
'name' => urlencode( $sorted_addon['name'] ),
'label' => esc_html( $sorted_addon['tab_label'] ),
'title' => esc_html( rgar( $sorted_addon, 'title' ) ),
'icon' => rgar( $sorted_addon, 'icon', 'gform-icon--cog' ),
);
}
}
// Prevent Uninstall tab from being added for users that don't have gravityforms_uninstall capability.
if ( GFCommon::current_user_can_uninstall() ) {
$setting_tabs[] = array(
'name' => 'uninstall',
'label' => __( 'Uninstall', 'gravityforms' ),
'icon' => 'gform-icon--trash',
);
}
/**
* Filters the Settings menu tabs.
*
* @since Unknown
*
* @param array $setting_tabs The settings tab names and labels.
*/
$setting_tabs = apply_filters( 'gform_settings_menu', $setting_tabs );
ksort( $setting_tabs, SORT_NUMERIC );
// Kind of boring having to pass the title, optionally get it from the settings tab.
if ( ! $title ) {
foreach ( $setting_tabs as $tab ) {
if ( $tab['name'] == urlencode( $current_tab ) ) {
$title = ! empty( $tab['title'] ) ? $tab['title'] : $tab['label'];
}
}
}
?>
gf_logging()->get_slug(),
'tab_label' => gf_logging()->get_short_title(),
'title' => gf_logging()->plugin_settings_title(),
'handler' => array( gf_logging(), 'plugin_settings_page' ),
'icon' => gf_logging()->get_menu_icon(),
),
null,
null
);
// Enabling all loggers by default.
gf_logging()->enable_all_loggers();
}
return $enabled;
}
/**
* Disable the GFLogging class.
*
* @since 2.4.4.2
*
* @return bool
*/
public static function disable_logging() {
// Update option.
$disabled = update_option( 'gform_enable_logging', false );
// Remove settings page, log files.
if ( function_exists( 'gf_logging' ) ) {
unset( self::$addon_pages[ gf_logging()->get_slug() ] );
gf_logging()->delete_log_files();
}
return $disabled;
}
}