Elementor #2722 - Door of Clubs

File Manager

Current Directory: wp-content/plugins/wpforms/src/Pro/Admin/Entries/Export

Linux appserver-0d5e4f1e-php-cc8da225320a42ba9b7d66cba40b1f03 6.6.123+ #1 SMP PREEMPT_DYNAMIC Wed Mar 11 09:04:28 UTC 2026 x86_64

Edit File: File.php

<?php

namespace WPForms\Pro\Admin\Entries\Export;

use Exception;
// phpcs:ignore WPForms.PHP.UseStatement.UnusedUseStatement
use WP_Filesystem_Base;
use WPForms\Helpers\Transient;
use WPForms\Vendor\XLSXWriter;
use WPForms\Pro\Admin\Entries\Export\Traits\Export as ExportTrait;

/**
 * File-related routines.
 *
 * @since 1.5.5
 */
class File {

use ExportTrait;

/**
	 * Instance of Export Class.
	 *
	 * @since 1.5.5
	 *
	 * @var \WPForms\Pro\Admin\Entries\Export\Export
	 */
	protected $export;

/**
	 * Constructor.
	 *
	 * @since 1.5.5
	 *
	 * @param \WPForms\Pro\Admin\Entries\Export\Export $export Instance of Export.
	 */
	public function __construct( $export ) {

$this->export = $export;

$this->hooks();
	}

/**
	 * Register hooks.
	 *
	 * @since 1.5.5
	 */
	public function hooks() {

add_action( 'wpforms_tools_init', [ $this, 'entries_export_download_file' ] );
		add_action( 'wpforms_tools_init', [ $this, 'single_entry_export_download_file' ] );
		add_action( Export::TASK_CLEANUP, [ $this, 'remove_old_export_files' ] );
	}

/**
	 * Export helper. Write data to a temporary .csv file.
	 *
	 * @since 1.5.5
	 *
	 * @param array $request_data Request data array.
	 *
	 * @throws Exception Exception.
	 */
	public function write_csv( $request_data ) {

$export_file = $this->get_tmpfname( $request_data );

// phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fopen
		$f         = fopen( 'php://temp', 'wb+' );
		$enclosure = '"';

fputcsv( $f, $request_data['columns_row'], $this->export->configuration['csv_export_separator'], $enclosure );

$entry_handler = wpforms()->obj( 'entry' );

for ( $i = 1; $i <= $request_data['total_steps']; $i++ ) {
			$entries = $entry_handler->get_entries( $request_data['db_args'] );

foreach ( $this->export->ajax->get_entry_data( $entries ) as $entry ) {
				fputcsv( $f, $entry, $this->export->configuration['csv_export_separator'], $enclosure );
			}

$request_data['db_args']['offset'] = $i * $this->export->configuration['entries_per_step'];
		}

rewind( $f );

$file_contents = stream_get_contents( $f );

// phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fclose
		fclose( $f );

$this->put_contents( $export_file, $file_contents );
	}

/**
	 * Write data to .xlsx file.
	 *
	 * @since 1.6.5
	 *
	 * @param array $request_data Request data array.
	 *
	 * @throws Exception Exception.
	 */
	public function write_xlsx( $request_data ) {

$export_file = $this->get_tmpfname( $request_data );

$writer = new XLSXWriter();

$writer->setTempDir( $this->get_tmpdir() );

$sheet_name = 'WPForms';

$widths = [];

$request_data['columns_row'] = $this->unique_column_labels( $request_data['columns_row'] );

foreach ( $request_data['columns_row'] as $header ) {
			$widths[] = strlen( $header ) + 2;
		}

$writer->writeSheetHeader( $sheet_name, array_fill_keys( $request_data['columns_row'], 'string' ), [ 'widths' => $widths ] );

$entry_handler = wpforms()->obj( 'entry' );

for ( $i = 1; $i <= $request_data['total_steps']; $i ++ ) {

$entries = $entry_handler->get_entries( $request_data['db_args'] );

foreach ( $this->export->ajax->get_entry_data( $entries ) as $entry ) {

$writer->writeSheetRow( $sheet_name, $entry, [ 'wrap_text' => true ] );
			}

$request_data['db_args']['offset'] = $i * $this->export->configuration['entries_per_step'];
		}

$file_contents = $writer->writeToString();

$this->put_contents( $export_file, $file_contents );
	}

/**
	 * Tmp files directory.
	 *
	 * @since 1.5.5
	 *
	 * @return string Temporary files directory path.
	 */
	public function get_tmpdir() {

$upload_dir  = wpforms_upload_dir();
		$upload_path = $upload_dir['path'];

$export_path = trailingslashit( $upload_path ) . 'export';

if ( ! file_exists( $export_path ) ) {
			wp_mkdir_p( $export_path );
		}

// Check if the .htaccess exists in the upload directory, if not - create it.
		wpforms_create_upload_dir_htaccess_file();

// Check if the index.html exists in the directories, if not - create it.
		wpforms_create_index_html_file( $upload_path );
		wpforms_create_index_html_file( $export_path );

// Normalize slashes for Windows.
		$export_path = wp_normalize_path( $export_path );

return $export_path;
	}

/**
	 * Full pathname of the tmp file.
	 *
	 * @since 1.5.5
	 * @since 1.8.0 Added exception.
	 *
	 * @param array $request_data Request data.
	 *
	 * @return string Temporary file full pathname.
	 *
	 * @throws Exception Unknown request.
	 */
	public function get_tmpfname( $request_data ) {

if ( empty( $request_data ) ) {
			throw new Exception( esc_html( $this->export->errors['unknown_request'] ) );
		}

$export_dir  = $this->get_tmpdir();
		$export_file = $export_dir . '/' . sanitize_key( $request_data['request_id'] ) . '.tmp';

// phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_touch
		touch( $export_file );

return $export_file;
	}

/**
	 * Send HTTP headers for .csv file download.
	 *
	 * @since 1.5.5.1
	 *
	 * @param string $file_name File name.
	 */
	public function http_headers( $file_name ) {

$file_name = empty( $file_name ) ? 'wpforms-entries.csv' : $file_name;

nocache_headers();
		header( 'Content-Description: File Transfer' );
		header( 'Content-Type: text/csv' );
		header( 'Content-Disposition: attachment; filename=' . $file_name );
		header( 'Content-Transfer-Encoding: binary' );
	}

/**
	 * Output the file.
	 * The WPFORMS_SAVE_ENTRIES_PATH is introduced for facilitating e2e tests.
	 * When the constant is used, download isn't prompted and the file gets downloaded in the provided path.
	 *
	 * @since 1.6.0.2
	 *
	 * @param array $request_data Request data.
	 *
	 * @throws Exception In case of file error.
	 */
	public function output_file( $request_data ) {

$export_file = $this->get_tmpfname( $request_data );

clearstatcache( true, $export_file );

$filesystem = $this->get_filesystem();

if ( ! $filesystem->is_readable( $export_file ) || $filesystem->is_dir( $export_file ) ) {
			throw new Exception( esc_html( $this->export->errors['file_not_readable'] ) );
		}

if ( $filesystem->size( $export_file ) === 0 ) {
			throw new Exception( esc_html( $export_file . $this->export->errors['file_empty'] ) );
		}

$entry_suffix = ! empty( $request_data['db_args']['entry_id'] ) ? '-entry-' . $request_data['db_args']['entry_id'] : '';

$file_name = 'wpforms-' . $request_data['db_args']['form_id'] . '-' . sanitize_file_name( get_the_title( $request_data['db_args']['form_id'] ) ) . $entry_suffix . '-' . current_time( 'Y-m-d-H-i-s' ) . '.' . $request_data['type'];

if ( defined( 'WPFORMS_SAVE_ENTRIES_PATH' ) && ! wpforms_is_empty_string( WPFORMS_SAVE_ENTRIES_PATH ) ) {
			$this->put_contents( WPFORMS_SAVE_ENTRIES_PATH . $file_name, $filesystem->get_contents( $export_file ) );
		} else {
			$this->http_headers( $file_name );

// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
			echo $filesystem->get_contents( $export_file );
		}

// Schedule clean up.
		$this->schedule_remove_old_export_files();

exit;
	}

/**
	 * Entries export file download.
	 *
	 * @since 1.5.5
	 *
	 * @throws Exception Try-catch.
	 */
	public function entries_export_download_file() {

$args = $this->export->data['get_args'];

if ( $args['action'] !== 'wpforms_tools_entries_export_download' ) {
			return;
		}

try {

// Security check.
			if (
				! wp_verify_nonce( $args['nonce'], 'wpforms-tools-entries-export-nonce' ) ||
				! wpforms_current_user_can( 'view_entries' )
			) {
				throw new Exception( $this->export->errors['security'] );
			}

// Check for request_id.
			if ( empty( $args['request_id'] ) ) {
				throw new Exception( $this->export->errors['unknown_request'] );
			}

// Get stored request data.
			$request_data = Transient::get( 'wpforms-tools-entries-export-request-' . $args['request_id'] );

$this->output_file( $request_data );

} catch ( Exception $e ) {
			// phpcs:disable
			$error = $this->export->errors['common'] . '<br>' . $e->getMessage();
			if ( wpforms_debug() ) {
				$error .= '<br><b>WPFORMS DEBUG</b>: ' . $e->__toString();
			}
			$error = str_replace( "'", '&#039;', $error );
			$js_error = str_replace( "\n", '', $error );

echo "
			<script>
				( function() {
					var w = window;
					if (
						w.frameElement !== null &&
						w.frameElement.nodeName === 'IFRAME' &&
						w.parent.jQuery
					) {
						w.parent.jQuery( w.parent.document ).trigger( 'csv_file_error', [ '" . wp_slash( $js_error ) . "' ] );
					}
				} )();
			</script>
			<pre>" . $error . '</pre>';
			exit;
			// phpcs:enable
		}
	}

/**
	 * Single entry export file download.
	 *
	 * @since 1.5.5
	 *
	 * @throws \Exception Try-catch.
	 */
	public function single_entry_export_download_file() {

$args = $this->export->data['get_args'];

if ( $args['action'] !== 'wpforms_tools_single_entry_export_download' ) {
			return;
		}

try {

// Check for form_id.
			if ( empty( $args['form_id'] ) ) {
				throw new Exception( $this->export->errors['unknown_form_id'] );
			}

// Check for entry_id.
			if ( empty( $args['entry_id'] ) ) {
				throw new Exception( $this->export->errors['unknown_entry_id'] );
			}

// Security check.
			if (
				! wp_verify_nonce( $args['nonce'], 'wpforms-tools-single-entry-export-nonce' ) ||
				! wpforms_current_user_can( 'view_entries' )
			) {
				throw new Exception( $this->export->errors['security'] );
			}

// Get stored request data.
			$request_data = $this->export->ajax->get_request_data( $args );

$this->export->ajax->request_data = $request_data;

$request_data = $this->exclude_unselected_choices( $request_data );

if ( empty( $request_data['type'] ) || $request_data['type'] === 'csv' ) {
				$this->write_csv( $request_data );
			} elseif ( $request_data['type'] === 'xlsx' ) {
				$this->write_xlsx( $request_data );
			}

$this->output_file( $request_data );

} catch ( Exception $e ) {

$error = $this->export->errors['common'] . '<br>' . $e->getMessage();

if ( wpforms_debug() ) {
				$error .= '<br><b>WPFORMS DEBUG</b>: ' . $e->__toString();
			}

\WPForms\Admin\Notice::error( $error );
		}
	}

/**
	 * Exclude unselected choices from the export.
	 *
	 * @since 1.8.6
	 *
	 * @param array $request_data Request data array.
	 *
	 * @return array Request data array.
	 */
	private function exclude_unselected_choices( array $request_data ): array {

// Skip if not AJAX request.
		if ( wpforms_is_ajax() ) {
			return $request_data;
		}

$entry = wpforms()->obj( 'entry' )->get( $request_data['db_args']['entry_id'] );

$fields = $this->export->ajax->get_entry_fields_data( $entry );

foreach ( $request_data['columns_row'] as $col_id => $col_label ) {
			if ( strpos( $col_id, 'multiple_field_' ) !== false ) {
				$col_value = $this->export->ajax->get_multiple_row_value( $fields, $col_id );

if ( $this->is_skip_value( $col_value, $fields, $col_id ) ) {
					unset( $request_data['columns_row'][ $col_id ] );
				}
			}
		}

return $request_data;
	}

/**
	 * Register a cleanup task to remove temp export files.
	 *
	 * @since 1.6.5
	 */
	public function schedule_remove_old_export_files() {

$tasks = wpforms()->obj( 'tasks' );

if ( $tasks->is_scheduled( Export::TASK_CLEANUP ) !== false ) {
			return;
		}

$tasks->create( Export::TASK_CLEANUP )
			  ->recurring( time() + 60, $this->export->configuration['request_data_ttl'] )
			  ->params()
			  ->register();
	}

/**
	 * Clear temporary files.
	 *
	 * @since 1.5.5
	 * @since 1.6.5 Stop using transients. Now we use ActionScheduler for this task.
	 */
	public function remove_old_export_files() {

$files = glob( $this->get_tmpdir() . '/*' );
		$now   = time();

foreach ( $files as $file ) {
			clearstatcache( true, $file );

if (
				is_file( $file ) &&
				pathinfo( $file, PATHINFO_BASENAME ) !== 'index.html' &&
				( $now - filemtime( $file ) ) > $this->export->configuration['request_data_ttl']
			) {
				// phpcs:ignore WordPress.WP.AlternativeFunctions.unlink_unlink
				unlink( $file );
			}
		}
	}

/**
	 * Adds numeric incrementation to the column label.
	 *
	 * PHP_XLSXWriter library has a bug resulting with malformed exported file when two or more columns has the same label.
	 * To workaround, this method adds "_{num}" at the end of duplicated labels.
	 *
	 * @see https://github.com/mk-j/PHP_XLSXWriter/issues/92
	 *
	 * @since 1.7.4
	 *
	 * @param array $columns_row Exported data header labels.
	 *
	 * @return array Exported data header labels.
	 */
	private function unique_column_labels( $columns_row ) {

$performed = [];

foreach ( $columns_row as $id => $label ) {
			if ( ! isset( $performed[ $label ] ) ) {
				$performed[ $label ] = 1;

continue;
			}

$performed[ $label ]++;

$columns_row[ $id ] = sprintf( '%s (%d)', $label, $performed[ $label ] );
		}

return $columns_row;
	}

/**
	 * Put file contents using WP Filesystem.
	 *
	 * @since 1.7.3
	 *
	 * @param string $export_file   Export filename.
	 * @param string $file_contents File contents.
	 *
	 * @throws Exception Exception.
	 * @noinspection ThrowRawExceptionInspection
	 */
	private function put_contents( $export_file, $file_contents ) {

$filesystem = $this->get_filesystem();

$filesystem->put_contents(
			$export_file,
			$file_contents
		);
	}

/**
	 * Get current filesystem.
	 *
	 * @since 1.8.0
	 *
	 * @return WP_Filesystem_Base
	 *
	 * @throws Exception File system isn't configured as well.
	 */
	private function get_filesystem() {

global $wp_filesystem;

// We have to start the buffer to prevent form output
		// when the file system is ssh/FTP but not configured.
		ob_start();

$url = add_query_arg(
			[
				'page' => 'wpforms-tools',
				'view' => 'export',
			],
			admin_url( 'admin.php' )
		);

$credentials = request_filesystem_credentials( $url, '', false, false, null );

ob_clean();

if ( $credentials === false ) {
			throw new Exception( esc_html( $this->export->errors['file_system_not_configured'] ) );
		}

WP_Filesystem( $credentials );

return $wp_filesystem;
	}
}

Upload File

Directory Listing

Name	Type	Size	Actions
.. (Parent Directory)	Dir
Admin.php	File	16.05 KB	Rename \| Delete \| Edit
Ajax.php	File	44.38 KB	Rename \| Delete \| Edit
Export.php	File	14.58 KB	Rename \| Delete \| Edit
File.php	File	13.84 KB	Rename \| Delete \| Edit
Traits	Directory		Rename \| Delete

File Manager

Edit File: File.php

Upload File

Directory Listing

Resources

Company

Office