' . __( 'This allows you to import or export Bizznis Settings.', 'bizznis' ) . '
' . '' . __( 'This is specific to Bizznis settings and does not includes posts, pages, or images, which is what the built-in WordPress import/export menu does.', 'bizznis' ) . '
' . '' . __( 'It also does not include other settings for plugins, widgets, or post/page/term/user specific settings.', 'bizznis' ) . '
'; $import_settings_help = '' . sprintf( __( 'You can import a file you\'ve previously exported. The file name will start with %s followed by one or more strings indicating which settings it contains, finally followed by the date and time it was exported.', 'bizznis' ), bizznis_code( 'bizznis-' ) ) . '
' . '' . __( 'Once you upload an import file, it will automatically overwrite your existing settings.', 'bizznis' ) . ' ' . __( 'This cannot be undone', 'bizznis' ) . '.
'; $export_settings_help = '' . sprintf( __( 'You can export your Bizznis-related settings to back them up, or copy them to another site. Child themes and plugins may add their own checkboxes to the list. The settings are exported in %s format.', 'bizznis' ), '' . __( 'JSON', 'bizznis' ) . '' ) . '
'; $screen->add_help_tab( array( 'id' => $this->pagehook . '-general-settings', 'title' => __( 'Import/Export', 'bizznis' ), 'content' => $general_settings_help, ) ); $screen->add_help_tab( array( 'id' => $this->pagehook . '-import', 'title' => __( 'Import', 'bizznis' ), 'content' => $import_settings_help, ) ); $screen->add_help_tab( array( 'id' => $this->pagehook . '-export', 'title' => __( 'Export', 'bizznis' ), 'content' => $export_settings_help, ) ); # Add help sidebar $screen->set_help_sidebar( '' . __( 'For more information:', 'bizznis' ) . '
' . '' . __( 'Get Support', 'bizznis' ) . '
' ); } /** * Callback for displaying the Bizznis Import / Export admin page. * * Call the bizznis_tools_form action after the last default table row. * * @since 1.0.0 */ public function admin() { ?>|
|
|
|
|
' . __( 'Settings successfully imported.', 'bizznis' ) . '
'; } elseif ( isset( $_REQUEST['error'] ) && 'true' === $_REQUEST['error'] ) { echo '' . __( 'There was a problem importing your settings. Please try again.', 'bizznis' ) . '
%s
', __( 'No export options available.', 'bizznis' ) ); return; } foreach ( $options as $name => $args ) { # Ensure option item has an array key, and that label and settings-field appear populated if ( is_int( $name ) || ! isset( $args['label'] ) || ! isset( $args['settings-field'] ) || '' === $args['label'] || '' === $args['settings-field'] ) { return; } printf( '', esc_attr( $name ), esc_html( $args['label'] ) ); } } /** * Generate the export file, if requested, in JSON format. * * After checking we're on the right page, and trying to export, loop through the list of requested options to * export, grabbing the settings from the database, and building up a file name that represents that collection of * settings. * * A .json file is then sent to the browser, named with "bizznis" at the start and ending with the current * date-time. * * The bizznis_export action is fired after checking we can proceed, but before the array of export options are * retrieved. * * @since 1.0.0 */ public function export() { if ( ! bizznis_is_menu_page( 'bizznis-tools' ) ) { return; } if ( empty( $_REQUEST['bizznis-export'] ) ) { return; } check_admin_referer( 'bizznis-export' ); do_action( 'bizznis_export', $_REQUEST['bizznis-export'] ); $options = $this->get_export_options(); $settings = array(); # Exported file name always starts with "bizznis" $prefix = array( 'bizznis' ); # Loop through set(s) of options foreach ( (array) $_REQUEST['bizznis-export'] as $export => $value ) { # Grab settings field name (key) $settings_field = $options[$export]['settings-field']; # Grab all of the settings from the database under that key $settings[$settings_field] = get_option( $settings_field ); # Add name of option set to build up export file name $prefix[] = $export; } if ( ! $settings ) { return; } # Complete the export file name by joining parts together $prefix = join( '-', $prefix ); $output = json_encode( (array) $settings ); # Prepare and send the export file to the browser header( 'Content-Description: File Transfer' ); header( 'Cache-Control: public, must-revalidate' ); header( 'Pragma: hack' ); header( 'Content-Type: text/plain' ); header( 'Content-Disposition: attachment; filename="' . $prefix . '-' . date( 'Ymd-His' ) . '.json"' ); header( 'Content-Length: ' . mb_strlen( $output ) ); echo $output; exit; } /** * Handle the file uploaded to import settings. * * Upon upload, the file contents are JSON-decoded. If there were errors, or no options to import, then reload the * page to show an error message. * * Otherwise, loop through the array of option sets, and update the data under those keys in the database. * Afterwards, reload the page with a success message. * * Calls bizznis_import action is fired after checking we can proceed, but before attempting to extract the contents * from the uploaded file. * * @since 1.0.0 */ public function import() { if ( ! bizznis_is_menu_page( 'bizznis-tools' ) ) { return; } if ( empty( $_REQUEST['bizznis-import'] ) ) { return; } check_admin_referer( 'bizznis-import' ); do_action( 'bizznis_import', $_REQUEST['bizznis-import'], $_FILES['bizznis-import-upload'] ); # WP filesystem check $url = wp_nonce_url( 'themes.php?page=bizznis-tools' ); if ( false === ( $creds = request_filesystem_credentials( $url, '', false, false, null ) ) ) { return; } # Try to get the filesystem running if ( ! WP_Filesystem( $creds ) ) { request_filesystem_credentials($url, '', true, false, null); return; } # Let's finally use the filesystem global $wp_filesystem; $upload = $wp_filesystem->get_contents( $_FILES['bizznis-import-upload']['tmp_name'] ); # Decode json format $options = json_decode( $upload, true ); # Check for errors if ( ! $options || $_FILES['bizznis-import-upload']['error'] ) { bizznis_admin_redirect( 'bizznis-tools', array( 'error' => 'true' ) ); exit; } # Identify the settings keys that we should import $exportables = $this->get_export_options(); $importable_keys = array(); foreach ( $exportables as $exportable ) { $importable_keys[] = $exportable['settings-field']; } # Cycle through data, import Bizznis settings foreach ( (array) $options as $key => $settings ) { if ( in_array( $key, $importable_keys ) ) { update_option( $key, $settings ); } } # Redirect, add success flag to the URI bizznis_admin_redirect( 'bizznis-tools', array( 'imported' => 'true' ) ); exit; } }