2007-05-27 20:04:33 -04:00
< ? php
2008-10-01 21:03:26 -04:00
/**
2012-07-26 11:08:30 -04:00
* Functions for reading , writing , modifying , and deleting files on the file system .
2012-10-03 14:49:37 -04:00
* Includes functionality for theme - specific files as well as operations for uploading ,
2012-07-26 11:08:30 -04:00
* archiving , and rendering output when necessary .
2008-10-01 21:03:26 -04:00
*
* @ package WordPress
* @ subpackage Administration
*/
2007-05-27 20:04:33 -04:00
2008-10-01 21:03:26 -04:00
/** The descriptions for theme files. */
2010-12-03 23:22:48 -05:00
$wp_file_descriptions = array (
2008-08-23 05:49:52 -04:00
'index.php' => __ ( 'Main Index Template' ),
'style.css' => __ ( 'Stylesheet' ),
2010-04-04 07:14:29 -04:00
'editor-style.css' => __ ( 'Visual Editor Stylesheet' ),
2010-12-03 23:22:48 -05:00
'editor-style-rtl.css' => __ ( 'Visual Editor RTL Stylesheet' ),
2008-10-01 21:03:26 -04:00
'rtl.css' => __ ( 'RTL Stylesheet' ),
'comments.php' => __ ( 'Comments' ),
'comments-popup.php' => __ ( 'Popup Comments' ),
'footer.php' => __ ( 'Footer' ),
'header.php' => __ ( 'Header' ),
2008-08-23 05:49:52 -04:00
'sidebar.php' => __ ( 'Sidebar' ),
'archive.php' => __ ( 'Archives' ),
2010-04-04 07:23:09 -04:00
'author.php' => __ ( 'Author Template' ),
'tag.php' => __ ( 'Tag Template' ),
2008-08-23 05:49:52 -04:00
'category.php' => __ ( 'Category Template' ),
'page.php' => __ ( 'Page Template' ),
'search.php' => __ ( 'Search Results' ),
'searchform.php' => __ ( 'Search Form' ),
'single.php' => __ ( 'Single Post' ),
'404.php' => __ ( '404 Template' ),
'link.php' => __ ( 'Links Template' ),
'functions.php' => __ ( 'Theme Functions' ),
'attachment.php' => __ ( 'Attachment Template' ),
'image.php' => __ ( 'Image Attachment Template' ),
'video.php' => __ ( 'Video Attachment Template' ),
'audio.php' => __ ( 'Audio Attachment Template' ),
'application.php' => __ ( 'Application Attachment Template' ),
'my-hacks.php' => __ ( 'my-hacks.php (legacy hacks support)' ),
'.htaccess' => __ ( '.htaccess (for rewrite rules )' ),
2007-05-27 20:04:33 -04:00
// Deprecated files
2010-12-03 23:22:48 -05:00
'wp-layout.css' => __ ( 'Stylesheet' ),
'wp-comments.php' => __ ( 'Comments Template' ),
'wp-comments-popup.php' => __ ( 'Popup Comments Template' ),
);
2008-10-01 21:03:26 -04:00
/**
2010-10-27 18:24:06 -04:00
* Get the description for standard WordPress theme files and other various standard
* WordPress files
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ since 1.5 . 0
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ uses _cleanup_header_comment
* @ uses $wp_file_descriptions
* @ param string $file Filesystem path or filename
* @ return string Description of file from $wp_file_descriptions or basename of $file if description doesn ' t exist
2008-10-01 21:03:26 -04:00
*/
2007-05-27 20:04:33 -04:00
function get_file_description ( $file ) {
global $wp_file_descriptions ;
if ( isset ( $wp_file_descriptions [ basename ( $file )] ) ) {
return $wp_file_descriptions [ basename ( $file )];
}
2010-04-04 08:07:27 -04:00
elseif ( file_exists ( $file ) && is_file ( $file ) ) {
$template_data = implode ( '' , file ( $file ) );
2008-08-23 05:49:52 -04:00
if ( preg_match ( '|Template Name:(.*)$|mi' , $template_data , $name ))
2010-12-21 09:58:54 -05:00
return sprintf ( __ ( '%s Page Template' ), _cleanup_header_comment ( $name [ 1 ]) );
2007-05-27 20:04:33 -04:00
}
2012-03-28 23:00:38 -04:00
return trim ( basename ( $file ) );
2007-05-27 20:04:33 -04:00
}
2008-10-01 21:03:26 -04:00
/**
2010-10-27 18:24:06 -04:00
* Get the absolute filesystem path to the root of the WordPress installation
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ since 1.5 . 0
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ uses get_option
* @ return string Full filesystem path to the root of the WordPress installation
2008-10-01 21:03:26 -04:00
*/
2007-05-27 20:04:33 -04:00
function get_home_path () {
2014-06-29 06:29:14 -04:00
$home = set_url_scheme ( get_option ( 'home' ), 'http' );
$siteurl = set_url_scheme ( get_option ( 'siteurl' ), 'http' );
2012-07-06 09:54:15 -04:00
if ( ! empty ( $home ) && 0 !== strcasecmp ( $home , $siteurl ) ) {
$wp_path_rel_to_home = str_ireplace ( $home , '' , $siteurl ); /* $siteurl - $home */
2012-11-21 17:39:59 -05:00
$pos = strripos ( str_replace ( '\\' , '/' , $_SERVER [ 'SCRIPT_FILENAME' ] ), trailingslashit ( $wp_path_rel_to_home ) );
2012-07-06 09:54:15 -04:00
$home_path = substr ( $_SERVER [ 'SCRIPT_FILENAME' ], 0 , $pos );
2009-05-04 22:45:40 -04:00
$home_path = trailingslashit ( $home_path );
2007-05-27 20:04:33 -04:00
} else {
$home_path = ABSPATH ;
}
2013-03-12 07:04:14 -04:00
return str_replace ( '\\' , '/' , $home_path );
2007-05-27 20:04:33 -04:00
}
2008-10-01 21:03:26 -04:00
/**
2009-11-05 18:03:48 -05:00
* Returns a listing of all files in the specified folder and all subdirectories up to 100 levels deep .
* The depth of the recursiveness can be controlled by the $levels param .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ since 2.6 . 0
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ param string $folder Full path to folder
* @ param int $levels ( optional ) Levels of folders to follow , Default : 100 ( PHP Loop limit ) .
* @ return bool | array False on failure , Else array of files
2008-10-01 21:03:26 -04:00
*/
2008-06-16 14:35:48 -04:00
function list_files ( $folder = '' , $levels = 100 ) {
2010-01-18 15:34:48 -05:00
if ( empty ( $folder ) )
2008-06-16 14:35:48 -04:00
return false ;
2010-01-18 15:34:48 -05:00
if ( ! $levels )
2008-06-16 14:35:48 -04:00
return false ;
$files = array ();
if ( $dir = @ opendir ( $folder ) ) {
while (( $file = readdir ( $dir ) ) !== false ) {
if ( in_array ( $file , array ( '.' , '..' ) ) )
continue ;
if ( is_dir ( $folder . '/' . $file ) ) {
$files2 = list_files ( $folder . '/' . $file , $levels - 1 );
2010-01-18 15:34:48 -05:00
if ( $files2 )
2008-06-16 14:35:48 -04:00
$files = array_merge ( $files , $files2 );
else
$files [] = $folder . '/' . $file . '/' ;
} else {
$files [] = $folder . '/' . $file ;
}
}
}
@ closedir ( $dir );
return $files ;
}
2007-05-27 20:04:33 -04:00
2008-10-01 21:03:26 -04:00
/**
2009-11-05 18:03:48 -05:00
* Returns a filename of a Temporary unique file .
* Please note that the calling function must unlink () this itself .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* The filename is based off the passed parameter or defaults to the current unix timestamp ,
2011-12-14 12:36:38 -05:00
* while the directory can either be passed as well , or by leaving it blank , default to a writable temporary directory .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ since 2.6 . 0
*
* @ param string $filename ( optional ) Filename to base the Unique file off
* @ param string $dir ( optional ) Directory to store the file in
* @ return string a writable filename
2008-10-01 21:03:26 -04:00
*/
2010-04-06 07:20:51 -04:00
function wp_tempnam ( $filename = '' , $dir = '' ) {
2008-04-25 17:34:54 -04:00
if ( empty ( $dir ) )
$dir = get_temp_dir ();
$filename = basename ( $filename );
if ( empty ( $filename ) )
$filename = time ();
2009-07-14 04:12:18 -04:00
$filename = preg_replace ( '|\..*$|' , '.tmp' , $filename );
2008-04-25 17:34:54 -04:00
$filename = $dir . wp_unique_filename ( $dir , $filename );
touch ( $filename );
return $filename ;
}
2008-10-01 21:03:26 -04:00
/**
2010-10-27 18:24:06 -04:00
* Make sure that the file that was requested to edit , is allowed to be edited
*
* Function will die if if you are not allowed to edit the file
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ since 1.5 . 0
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ uses wp_die
* @ uses validate_file
* @ param string $file file the users is attempting to edit
* @ param array $allowed_files Array of allowed files to edit , $file must match an entry exactly
* @ return null
2008-10-01 21:03:26 -04:00
*/
2007-05-27 20:04:33 -04:00
function validate_file_to_edit ( $file , $allowed_files = '' ) {
$code = validate_file ( $file , $allowed_files );
if ( ! $code )
return $file ;
switch ( $code ) {
case 1 :
2014-02-21 09:46:14 -05:00
wp_die ( __ ( 'Sorry, that file cannot be edited.' ) );
2007-05-27 20:04:33 -04:00
2014-07-17 05:14:16 -04:00
// case 2 :
// wp_die( __('Sorry, can’t call files with their real path.' ));
2007-05-27 20:04:33 -04:00
case 3 :
2014-02-21 09:46:14 -05:00
wp_die ( __ ( 'Sorry, that file cannot be edited.' ) );
2007-05-27 20:04:33 -04:00
}
}
2008-10-01 21:03:26 -04:00
/**
2010-10-27 18:24:06 -04:00
* Handle PHP uploads in WordPress , sanitizing file names , checking extensions for mime type ,
* and moving the file to the appropriate directory within the uploads directory .
2008-10-01 21:03:26 -04:00
*
2013-12-24 13:57:12 -05:00
* @ since 2.0 . 0
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ uses wp_handle_upload_error
* @ uses is_multisite
* @ uses wp_check_filetype_and_ext
* @ uses current_user_can
* @ uses wp_upload_dir
* @ uses wp_unique_filename
2010-11-17 13:47:34 -05:00
* @ uses delete_transient
2008-10-01 21:03:26 -04:00
* @ param array $file Reference to a single element of $_FILES . Call the function once for each uploaded file .
2014-05-16 13:41:16 -04:00
* @ param array $overrides Optional . An associative array of names => values to override default variables .
2012-10-03 14:49:37 -04:00
* @ param string $time Optional . Time formatted in 'yyyy/mm' .
2008-10-01 21:03:26 -04:00
* @ return array On success , returns an associative array of file attributes . On failure , returns $overrides [ 'upload_error_handler' ]( & $file , $message ) or array ( 'error' => $message ) .
*/
2008-11-13 13:22:00 -05:00
function wp_handle_upload ( & $file , $overrides = false , $time = null ) {
2007-05-27 20:04:33 -04:00
// The default error handler.
2010-02-22 11:54:51 -05:00
if ( ! function_exists ( 'wp_handle_upload_error' ) ) {
2007-05-27 20:04:33 -04:00
function wp_handle_upload_error ( & $file , $message ) {
return array ( 'error' => $message );
}
}
2014-03-23 22:45:15 -04:00
/**
* Filter data for the current file to upload .
*
* @ since 2.9 . 0
*
* @ param array $file An array of data for a single file .
*/
2009-11-05 09:24:20 -05:00
$file = apply_filters ( 'wp_handle_upload_prefilter' , $file );
2007-05-27 20:04:33 -04:00
// You may define your own function and pass the name in $overrides['upload_error_handler']
$upload_error_handler = 'wp_handle_upload_error' ;
2014-05-16 12:10:38 -04:00
if ( isset ( $overrides [ 'upload_error_handler' ] ) ) {
$upload_error_handler = $overrides [ 'upload_error_handler' ];
}
2007-05-27 20:04:33 -04:00
2011-12-13 18:45:31 -05:00
// You may have had one or more 'wp_handle_upload_prefilter' functions error out the file. Handle that gracefully.
2009-12-26 03:47:47 -05:00
if ( isset ( $file [ 'error' ] ) && ! is_numeric ( $file [ 'error' ] ) && $file [ 'error' ] )
2009-11-05 09:24:20 -05:00
return $upload_error_handler ( $file , $file [ 'error' ] );
2014-05-16 12:10:38 -04:00
// Install user overrides. Did we mention that this voids your warranty?
2008-11-14 18:01:16 -05:00
// You may define your own function and pass the name in $overrides['unique_filename_callback']
$unique_filename_callback = null ;
2014-05-16 12:10:38 -04:00
if ( isset ( $overrides [ 'unique_filename_callback' ] ) ) {
$unique_filename_callback = $overrides [ 'unique_filename_callback' ];
}
2008-11-14 18:01:16 -05:00
2007-05-27 20:04:33 -04:00
// $_POST['action'] must be set and its value must equal $overrides['action'] or this:
$action = 'wp_handle_upload' ;
2014-05-16 12:10:38 -04:00
if ( isset ( $overrides [ 'action' ] ) ) {
$action = $overrides [ 'action' ];
}
2007-05-27 20:04:33 -04:00
// Courtesy of php.net, the strings that describe the error indicated in $_FILES[{form field}]['error'].
$upload_error_strings = array ( false ,
2011-06-08 12:27:57 -04:00
__ ( " The uploaded file exceeds the upload_max_filesize directive in php.ini. " ),
__ ( " The uploaded file exceeds the MAX_FILE_SIZE directive that was specified in the HTML form. " ),
2007-05-27 20:04:33 -04:00
__ ( " The uploaded file was only partially uploaded. " ),
__ ( " No file was uploaded. " ),
2008-11-27 16:19:12 -05:00
'' ,
2007-05-27 20:04:33 -04:00
__ ( " Missing a temporary folder. " ),
2009-05-12 13:02:34 -04:00
__ ( " Failed to write file to disk. " ),
__ ( " File upload stopped by extension. " ));
2007-05-27 20:04:33 -04:00
2014-07-17 05:14:16 -04:00
/*
* This may not have orignially been intended to be overrideable ,
* but historically has been .
*/
2014-05-16 12:10:38 -04:00
if ( isset ( $overrides [ 'upload_error_strings' ] ) ) {
$upload_error_strings = $overrides [ 'upload_error_strings' ];
}
2011-07-21 13:46:01 -04:00
// All tests are on by default. Most can be turned off by $overrides[{test_name}] = false;
2014-05-16 12:10:38 -04:00
$test_form = isset ( $overrides [ 'test_form' ] ) ? $overrides [ 'test_form' ] : true ;
$test_size = isset ( $overrides [ 'test_size' ] ) ? $overrides [ 'test_size' ] : true ;
$test_upload = isset ( $overrides [ 'test_upload' ] ) ? $overrides [ 'test_upload' ] : true ;
2007-05-27 20:04:33 -04:00
2014-07-17 05:14:16 -04:00
// If you override this, you must provide $ext and $type!!
2014-05-16 12:10:38 -04:00
$test_type = isset ( $overrides [ 'test_type' ] ) ? $overrides [ 'test_type' ] : true ;
$mimes = isset ( $overrides [ 'mimes' ] ) ? $overrides [ 'mimes' ] : false ;
2007-05-27 20:04:33 -04:00
// A correct form post will pass this test.
2014-05-16 12:10:38 -04:00
if ( $test_form && ( ! isset ( $_POST [ 'action' ] ) || ( $_POST [ 'action' ] != $action ) ) ) {
return call_user_func ( $upload_error_handler , $file , __ ( 'Invalid form submission.' ) );
}
2007-05-27 20:04:33 -04:00
// A successful upload will pass this test. It makes no sense to override this one.
2014-02-27 16:16:15 -05:00
if ( isset ( $file [ 'error' ] ) && $file [ 'error' ] > 0 ) {
return call_user_func ( $upload_error_handler , $file , $upload_error_strings [ $file [ 'error' ] ] );
}
2007-05-27 20:04:33 -04:00
// A non-empty file will pass this test.
2010-02-22 11:54:51 -05:00
if ( $test_size && ! ( $file [ 'size' ] > 0 ) ) {
if ( is_multisite () )
$error_msg = __ ( 'File is empty. Please upload something more substantial.' );
else
$error_msg = __ ( 'File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.' );
return call_user_func ( $upload_error_handler , $file , $error_msg );
}
2007-05-27 20:04:33 -04:00
// A properly uploaded file will pass this test. There should be no reason to override this one.
2010-02-22 11:54:51 -05:00
if ( $test_upload && ! @ is_uploaded_file ( $file [ 'tmp_name' ] ) )
return call_user_func ( $upload_error_handler , $file , __ ( 'Specified file failed upload test.' ));
2007-05-27 20:04:33 -04:00
// A correct MIME type will pass this test. Override $mimes or use the upload_mimes filter.
if ( $test_type ) {
2010-05-15 00:47:03 -04:00
$wp_filetype = wp_check_filetype_and_ext ( $file [ 'tmp_name' ], $file [ 'name' ], $mimes );
2014-05-15 00:31:14 -04:00
$ext = empty ( $wp_filetype [ 'ext' ] ) ? '' : $wp_filetype [ 'ext' ];
$type = empty ( $wp_filetype [ 'type' ] ) ? '' : $wp_filetype [ 'type' ];
$proper_filename = empty ( $wp_filetype [ 'proper_filename' ] ) ? '' : $wp_filetype [ 'proper_filename' ];
2007-05-27 20:04:33 -04:00
2010-05-15 00:47:03 -04:00
// Check to see if wp_check_filetype_and_ext() determined the filename was incorrect
2014-05-15 00:31:14 -04:00
if ( $proper_filename ) {
2010-05-15 00:47:03 -04:00
$file [ 'name' ] = $proper_filename ;
2014-05-15 00:31:14 -04:00
}
if ( ( ! $type || ! $ext ) && ! current_user_can ( 'unfiltered_upload' ) ) {
return call_user_func ( $upload_error_handler , $file , __ ( 'Sorry, this file type is not permitted for security reasons.' ) );
}
if ( ! $type ) {
2008-03-06 14:48:54 -05:00
$type = $file [ 'type' ];
2014-05-15 00:31:14 -04:00
}
2009-05-07 02:50:54 -04:00
} else {
$type = '' ;
2007-05-27 20:04:33 -04:00
}
2014-07-17 05:14:16 -04:00
/*
* A writable uploads dir will pass this test . Again , there ' s no point
* overriding this one .
*/
2008-11-13 13:22:00 -05:00
if ( ! ( ( $uploads = wp_upload_dir ( $time ) ) && false === $uploads [ 'error' ] ) )
2010-03-17 12:27:25 -04:00
return call_user_func ( $upload_error_handler , $file , $uploads [ 'error' ] );
2007-05-27 20:04:33 -04:00
2007-12-17 22:32:43 -05:00
$filename = wp_unique_filename ( $uploads [ 'path' ], $file [ 'name' ], $unique_filename_callback );
2007-05-27 20:04:33 -04:00
2014-07-17 05:14:16 -04:00
// Move the file to the uploads dir.
2011-07-29 04:59:35 -04:00
$new_file = $uploads [ 'path' ] . " / $filename " ;
2013-06-20 22:29:26 -04:00
if ( false === @ move_uploaded_file ( $file [ 'tmp_name' ], $new_file ) ) {
if ( 0 === strpos ( $uploads [ 'basedir' ], ABSPATH ) )
$error_path = str_replace ( ABSPATH , '' , $uploads [ 'basedir' ] ) . $uploads [ 'subdir' ];
else
$error_path = basename ( $uploads [ 'basedir' ] ) . $uploads [ 'subdir' ];
return $upload_error_handler ( $file , sprintf ( __ ( 'The uploaded file could not be moved to %s.' ), $error_path ) );
}
2011-10-24 15:13:23 -04:00
2014-07-17 05:14:16 -04:00
// Set correct file permissions.
2007-05-27 20:04:33 -04:00
$stat = stat ( dirname ( $new_file ));
$perms = $stat [ 'mode' ] & 0000666 ;
@ chmod ( $new_file , $perms );
2014-07-17 05:14:16 -04:00
// Compute the URL.
2007-05-27 20:04:33 -04:00
$url = $uploads [ 'url' ] . " / $filename " ;
2010-02-04 13:57:32 -05:00
if ( is_multisite () )
delete_transient ( 'dirsize_cache' );
2014-03-23 22:45:15 -04:00
/**
* Filter the data array for the uploaded file .
*
* @ since 2.1 . 0
*
* @ param array $upload {
* Array of upload data .
*
* @ type string $file Filename of the newly - uploaded file .
* @ type string $url URL of the uploaded file .
* @ type string $type File type .
* }
* @ param string $context The type of upload action . Accepts 'upload' or 'sideload' .
*/
2010-05-03 18:16:48 -04:00
return apply_filters ( 'wp_handle_upload' , array ( 'file' => $new_file , 'url' => $url , 'type' => $type ), 'upload' );
2007-05-27 20:04:33 -04:00
}
2008-10-01 21:03:26 -04:00
/**
2011-09-03 10:18:10 -04:00
* Handle sideloads , which is the process of retrieving a media item from another server instead of
2011-12-13 18:45:31 -05:00
* a traditional media upload . This process involves sanitizing the filename , checking extensions
2010-10-27 18:24:06 -04:00
* for mime type , and moving the file to the appropriate directory within the uploads directory .
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ since 2.6 . 0
2008-10-01 21:03:26 -04:00
*
2010-10-27 18:24:06 -04:00
* @ uses wp_handle_upload_error
* @ uses wp_check_filetype_and_ext
* @ uses current_user_can
* @ uses wp_upload_dir
* @ uses wp_unique_filename
* @ param array $file an array similar to that of a PHP $_FILES POST array
2014-05-16 13:41:16 -04:00
* @ param array $overrides Optional . An associative array of names => values to override default variables .
2012-10-03 14:49:37 -04:00
* @ param string $time Optional . Time formatted in 'yyyy/mm' .
2010-10-27 18:24:06 -04:00
* @ return array On success , returns an associative array of file attributes . On failure , returns $overrides [ 'upload_error_handler' ]( & $file , $message ) or array ( 'error' => $message ) .
2008-10-01 21:03:26 -04:00
*/
2012-10-03 14:49:37 -04:00
function wp_handle_sideload ( & $file , $overrides = false , $time = null ) {
2008-06-04 12:13:55 -04:00
// The default error handler.
if ( ! function_exists ( 'wp_handle_upload_error' ) ) {
function wp_handle_upload_error ( & $file , $message ) {
return array ( 'error' => $message );
}
}
2014-05-16 12:15:14 -04:00
// Install user overrides. Did we mention that this voids your warranty?
2008-06-04 12:13:55 -04:00
// You may define your own function and pass the name in $overrides['upload_error_handler']
$upload_error_handler = 'wp_handle_upload_error' ;
2014-05-16 12:15:14 -04:00
if ( isset ( $overrides [ 'upload_error_handler' ] ) ) {
$upload_error_handler = $overrides [ 'upload_error_handler' ];
}
2008-06-04 12:13:55 -04:00
2008-11-15 13:10:35 -05:00
// You may define your own function and pass the name in $overrides['unique_filename_callback']
$unique_filename_callback = null ;
2014-05-16 12:15:14 -04:00
if ( isset ( $overrides [ 'unique_filename_callback' ] ) ) {
$unique_filename_callback = $overrides [ 'unique_filename_callback' ];
}
2008-11-15 13:10:35 -05:00
2008-06-04 12:13:55 -04:00
// $_POST['action'] must be set and its value must equal $overrides['action'] or this:
$action = 'wp_handle_sideload' ;
2014-05-16 12:15:14 -04:00
if ( isset ( $overrides [ 'action' ] ) ) {
$action = $overrides [ 'action' ];
}
2008-06-04 12:13:55 -04:00
// Courtesy of php.net, the strings that describe the error indicated in $_FILES[{form field}]['error'].
$upload_error_strings = array ( false ,
2009-05-12 13:02:34 -04:00
__ ( " The uploaded file exceeds the <code>upload_max_filesize</code> directive in <code>php.ini</code>. " ),
__ ( " The uploaded file exceeds the <em>MAX_FILE_SIZE</em> directive that was specified in the HTML form. " ),
__ ( " The uploaded file was only partially uploaded. " ),
__ ( " No file was uploaded. " ),
'' ,
2008-06-04 12:13:55 -04:00
__ ( " Missing a temporary folder. " ),
2009-05-12 13:02:34 -04:00
__ ( " Failed to write file to disk. " ),
__ ( " File upload stopped by extension. " ));
2008-06-04 12:13:55 -04:00
2014-05-16 12:15:14 -04:00
// this may not have orignially been intended to be overrideable, but historically has been
if ( isset ( $overrides [ 'upload_error_strings' ] ) ) {
$upload_error_strings = $overrides [ 'upload_error_strings' ];
}
2011-07-21 13:46:01 -04:00
// All tests are on by default. Most can be turned off by $overrides[{test_name}] = false;
2014-05-16 12:15:14 -04:00
$test_form = isset ( $overrides [ 'test_form' ] ) ? $overrides [ 'test_form' ] : true ;
$test_size = isset ( $overrides [ 'test_size' ] ) ? $overrides [ 'test_size' ] : true ;
2008-06-04 12:13:55 -04:00
// If you override this, you must provide $ext and $type!!!!
2014-05-16 12:15:14 -04:00
$test_type = isset ( $overrides [ 'test_type' ] ) ? $overrides [ 'test_type' ] : true ;
$mimes = isset ( $overrides [ 'mimes' ] ) ? $overrides [ 'mimes' ] : false ;
2008-06-04 12:13:55 -04:00
// A correct form post will pass this test.
if ( $test_form && ( ! isset ( $_POST [ 'action' ] ) || ( $_POST [ 'action' ] != $action ) ) )
return $upload_error_handler ( $file , __ ( 'Invalid form submission.' ));
// A successful upload will pass this test. It makes no sense to override this one.
2010-03-26 13:42:34 -04:00
if ( ! empty ( $file [ 'error' ] ) )
2008-06-04 12:13:55 -04:00
return $upload_error_handler ( $file , $upload_error_strings [ $file [ 'error' ]] );
// A non-empty file will pass this test.
if ( $test_size && ! ( filesize ( $file [ 'tmp_name' ]) > 0 ) )
return $upload_error_handler ( $file , __ ( 'File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini.' ));
// A properly uploaded file will pass this test. There should be no reason to override this one.
if ( ! @ is_file ( $file [ 'tmp_name' ] ) )
return $upload_error_handler ( $file , __ ( 'Specified file does not exist.' ));
// A correct MIME type will pass this test. Override $mimes or use the upload_mimes filter.
if ( $test_type ) {
2010-05-15 00:47:03 -04:00
$wp_filetype = wp_check_filetype_and_ext ( $file [ 'tmp_name' ], $file [ 'name' ], $mimes );
2014-05-15 00:29:15 -04:00
$ext = empty ( $wp_filetype [ 'ext' ] ) ? '' : $wp_filetype [ 'ext' ];
$type = empty ( $wp_filetype [ 'type' ] ) ? '' : $wp_filetype [ 'type' ];
$proper_filename = empty ( $wp_filetype [ 'proper_filename' ] ) ? '' : $wp_filetype [ 'proper_filename' ];
2008-06-04 12:13:55 -04:00
2010-05-15 00:47:03 -04:00
// Check to see if wp_check_filetype_and_ext() determined the filename was incorrect
2014-05-15 00:29:15 -04:00
if ( $proper_filename ) {
2010-05-15 00:47:03 -04:00
$file [ 'name' ] = $proper_filename ;
2014-05-15 00:29:15 -04:00
}
if ( ( ! $type || ! $ext ) && ! current_user_can ( 'unfiltered_upload' ) ) {
return $upload_error_handler ( $file , __ ( 'Sorry, this file type is not permitted for security reasons.' ) );
}
if ( ! $type ) {
2008-06-04 12:13:55 -04:00
$type = $file [ 'type' ];
2014-05-15 00:29:15 -04:00
}
2014-05-16 12:15:14 -04:00
} else {
$type = '' ;
2008-06-04 12:13:55 -04:00
}
// A writable uploads dir will pass this test. Again, there's no point overriding this one.
2012-10-03 14:49:37 -04:00
if ( ! ( ( $uploads = wp_upload_dir ( $time ) ) && false === $uploads [ 'error' ] ) )
2008-06-04 12:13:55 -04:00
return $upload_error_handler ( $file , $uploads [ 'error' ] );
$filename = wp_unique_filename ( $uploads [ 'path' ], $file [ 'name' ], $unique_filename_callback );
2008-08-09 01:36:14 -04:00
2008-06-25 12:45:04 -04:00
// Strip the query strings.
$filename = str_replace ( '?' , '-' , $filename );
$filename = str_replace ( '&' , '-' , $filename );
2008-08-09 01:36:14 -04:00
2008-06-04 12:13:55 -04:00
// Move the file to the uploads dir
$new_file = $uploads [ 'path' ] . " / $filename " ;
if ( false === @ rename ( $file [ 'tmp_name' ], $new_file ) ) {
2013-06-20 22:29:26 -04:00
if ( 0 === strpos ( $uploads [ 'basedir' ], ABSPATH ) )
$error_path = str_replace ( ABSPATH , '' , $uploads [ 'basedir' ] ) . $uploads [ 'subdir' ];
else
$error_path = basename ( $uploads [ 'basedir' ] ) . $uploads [ 'subdir' ];
return $upload_error_handler ( $file , sprintf ( __ ( 'The uploaded file could not be moved to %s.' ), $error_path ) );
2008-06-04 12:13:55 -04:00
}
// Set correct file permissions
$stat = stat ( dirname ( $new_file ));
$perms = $stat [ 'mode' ] & 0000666 ;
@ chmod ( $new_file , $perms );
// Compute the URL
$url = $uploads [ 'url' ] . " / $filename " ;
2014-03-23 22:45:15 -04:00
/** This filter is documented in wp-admin/includes/file.php */
2010-05-03 18:16:48 -04:00
$return = apply_filters ( 'wp_handle_upload' , array ( 'file' => $new_file , 'url' => $url , 'type' => $type ), 'sideload' );
2008-06-04 12:13:55 -04:00
return $return ;
}
2007-05-27 20:04:33 -04:00
2008-02-11 00:45:54 -05:00
/**
2009-11-05 18:03:48 -05:00
* Downloads a url to a local temporary file using the WordPress HTTP Class .
2011-12-14 12:36:38 -05:00
* Please note , That the calling function must unlink () the file .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
* @ param string $url the URL of the file to download
2010-12-07 07:45:24 -05:00
* @ param int $timeout The timeout for the request to download the file default 300 seconds
2008-10-01 21:03:26 -04:00
* @ return mixed WP_Error on failure , string Filename on success .
*/
2010-12-07 07:45:24 -05:00
function download_url ( $url , $timeout = 300 ) {
2008-02-11 00:45:54 -05:00
//WARNING: The file is not automatically deleted, The script must unlink() the file.
2008-10-15 12:35:35 -04:00
if ( ! $url )
2010-01-21 16:37:43 -05:00
return new WP_Error ( 'http_no_url' , __ ( 'Invalid URL Provided.' ));
2008-02-11 00:45:54 -05:00
2008-04-25 17:34:54 -04:00
$tmpfname = wp_tempnam ( $url );
2008-10-15 12:35:35 -04:00
if ( ! $tmpfname )
2010-01-21 16:37:43 -05:00
return new WP_Error ( 'http_no_file' , __ ( 'Could not create Temporary file.' ));
2008-02-11 00:45:54 -05:00
2013-07-31 02:52:13 -04:00
$response = wp_safe_remote_get ( $url , array ( 'timeout' => $timeout , 'stream' => true , 'filename' => $tmpfname ) );
2008-03-02 15:17:30 -05:00
2011-03-24 22:42:20 -04:00
if ( is_wp_error ( $response ) ) {
unlink ( $tmpfname );
2008-10-15 12:35:35 -04:00
return $response ;
}
2011-05-14 15:45:07 -04:00
if ( 200 != wp_remote_retrieve_response_code ( $response ) ){
2011-03-24 22:42:20 -04:00
unlink ( $tmpfname );
2011-05-14 15:45:07 -04:00
return new WP_Error ( 'http_404' , trim ( wp_remote_retrieve_response_message ( $response ) ) );
2008-03-27 03:36:30 -04:00
}
2008-10-14 12:37:08 -04:00
2013-09-21 02:54:09 -04:00
$content_md5 = wp_remote_retrieve_header ( $response , 'content-md5' );
if ( $content_md5 ) {
$md5_check = verify_file_md5 ( $tmpfname , $content_md5 );
if ( is_wp_error ( $md5_check ) ) {
unlink ( $tmpfname );
return $md5_check ;
}
}
2008-02-11 00:45:54 -05:00
return $tmpfname ;
}
2013-09-21 02:54:09 -04:00
/**
2014-04-03 20:03:14 -04:00
* Calculates and compares the MD5 of a file to its expected value .
2013-09-21 02:54:09 -04:00
*
* @ since 3.7 . 0
*
* @ param string $filename The filename to check the MD5 of .
* @ param string $expected_md5 The expected MD5 of the file , either a base64 encoded raw md5 , or a hex - encoded md5
* @ return bool | object WP_Error on failure , true on success , false when the MD5 format is unknown / unexpected
*/
function verify_file_md5 ( $filename , $expected_md5 ) {
if ( 32 == strlen ( $expected_md5 ) )
$expected_raw_md5 = pack ( 'H*' , $expected_md5 );
elseif ( 24 == strlen ( $expected_md5 ) )
$expected_raw_md5 = base64_decode ( $expected_md5 );
else
return false ; // unknown format
$file_md5 = md5_file ( $filename , true );
if ( $file_md5 === $expected_raw_md5 )
return true ;
return new WP_Error ( 'md5_mismatch' , sprintf ( __ ( 'The checksum of the file (%1$s) does not match the expected checksum value (%2$s).' ), bin2hex ( $file_md5 ), bin2hex ( $expected_raw_md5 ) ) );
}
2008-10-01 21:03:26 -04:00
/**
2011-09-03 10:18:10 -04:00
* Unzips a specified ZIP file to a location on the Filesystem via the WordPress Filesystem Abstraction .
2010-05-02 19:24:36 -04:00
* Assumes that WP_Filesystem () has already been called and set up . Does not extract a root - level __MACOSX directory , if present .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* Attempts to increase the PHP Memory limit to 256 M before uncompressing ,
* However , The most memory required shouldn ' t be much larger than the Archive itself .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ since 2.5 . 0
*
* @ param string $file Full path and filename of zip archive
* @ param string $to Full path on the filesystem to extract archive to
* @ return mixed WP_Error on failure , True on success
2008-10-01 21:03:26 -04:00
*/
2008-02-11 00:45:54 -05:00
function unzip_file ( $file , $to ) {
global $wp_filesystem ;
if ( ! $wp_filesystem || ! is_object ( $wp_filesystem ) )
return new WP_Error ( 'fs_unavailable' , __ ( 'Could not access filesystem.' ));
2008-03-02 15:17:30 -05:00
2010-02-06 23:52:35 -05:00
// Unzip can use a lot of memory, but not this much hopefully
2014-03-23 22:45:15 -04:00
/** This filter is documented in wp-admin/admin.php */
2011-04-28 12:25:36 -04:00
@ ini_set ( 'memory_limit' , apply_filters ( 'admin_memory_limit' , WP_MAX_MEMORY_LIMIT ) );
2008-11-11 14:11:48 -05:00
2010-01-22 06:02:09 -05:00
$needed_dirs = array ();
2008-09-08 23:24:05 -04:00
$to = trailingslashit ( $to );
2010-01-22 06:02:09 -05:00
// Determine any parent dir's needed (of the upgrade directory)
if ( ! $wp_filesystem -> is_dir ( $to ) ) { //Only do parents if no children exist
$path = preg_split ( '![/\\\]!' , untrailingslashit ( $to ));
for ( $i = count ( $path ); $i >= 0 ; $i -- ) {
2008-09-13 14:06:20 -04:00
if ( empty ( $path [ $i ]) )
continue ;
2008-02-11 00:45:54 -05:00
2010-01-22 06:02:09 -05:00
$dir = implode ( '/' , array_slice ( $path , 0 , $i + 1 ) );
2010-02-06 23:52:35 -05:00
if ( preg_match ( '!^[a-z]:$!i' , $dir ) ) // Skip it if it looks like a Windows Drive letter.
2010-01-22 06:02:09 -05:00
continue ;
if ( ! $wp_filesystem -> is_dir ( $dir ) )
$needed_dirs [] = $dir ;
else
break ; // A folder exists, therefor, we dont need the check the levels below this
2008-08-07 15:15:04 -04:00
}
2008-02-11 00:45:54 -05:00
}
2010-01-22 06:02:09 -05:00
2014-03-23 22:45:15 -04:00
/**
* Filter whether to use ZipArchive to unzip archives .
*
* @ since 3.0 . 0
*
* @ param bool $ziparchive Whether to use ZipArchive . Default true .
*/
if ( class_exists ( 'ZipArchive' ) && apply_filters ( 'unzip_file_use_ziparchive' , true ) ) {
2010-02-19 05:59:32 -05:00
$result = _unzip_file_ziparchive ( $file , $to , $needed_dirs );
if ( true === $result ) {
return $result ;
} elseif ( is_wp_error ( $result ) ) {
if ( 'incompatible_archive' != $result -> get_error_code () )
return $result ;
}
}
// Fall through to PclZip if ZipArchive is not available, or encountered an error opening the file.
return _unzip_file_pclzip ( $file , $to , $needed_dirs );
2010-02-06 23:52:35 -05:00
}
2010-02-07 00:07:36 -05:00
/**
* This function should not be called directly , use unzip_file instead . Attempts to unzip an archive using the ZipArchive class .
* Assumes that WP_Filesystem () has already been called and set up .
*
2010-03-26 15:13:36 -04:00
* @ since 3.0 . 0
2010-02-07 00:07:36 -05:00
* @ see unzip_file
* @ access private
*
* @ param string $file Full path and filename of zip archive
* @ param string $to Full path on the filesystem to extract archive to
* @ param array $needed_dirs A partial list of required folders needed to be created .
* @ return mixed WP_Error on failure , True on success
*/
2010-02-07 16:28:05 -05:00
function _unzip_file_ziparchive ( $file , $to , $needed_dirs = array () ) {
2010-02-06 23:52:35 -05:00
global $wp_filesystem ;
$z = new ZipArchive ();
2010-02-07 16:28:05 -05:00
2013-10-14 17:55:09 -04:00
$zopen = $z -> open ( $file , ZIPARCHIVE :: CHECKCONS );
2010-05-29 09:16:35 -04:00
if ( true !== $zopen )
2013-10-14 17:55:09 -04:00
return new WP_Error ( 'incompatible_archive' , __ ( 'Incompatible Archive.' ), array ( 'ziparchive_error' => $zopen ) );
2010-02-06 23:52:35 -05:00
2013-10-14 16:15:09 -04:00
$uncompressed_size = 0 ;
2010-02-06 23:52:35 -05:00
for ( $i = 0 ; $i < $z -> numFiles ; $i ++ ) {
if ( ! $info = $z -> statIndex ( $i ) )
2013-10-11 12:06:11 -04:00
return new WP_Error ( 'stat_failed_ziparchive' , __ ( 'Could not retrieve file from archive.' ) );
2010-02-06 23:52:35 -05:00
2010-05-02 19:24:36 -04:00
if ( '__MACOSX/' === substr ( $info [ 'name' ], 0 , 9 ) ) // Skip the OS X-created __MACOSX directory
continue ;
2013-10-14 16:15:09 -04:00
$uncompressed_size += $info [ 'size' ];
2010-02-06 23:52:35 -05:00
if ( '/' == substr ( $info [ 'name' ], - 1 ) ) // directory
$needed_dirs [] = $to . untrailingslashit ( $info [ 'name' ]);
else
$needed_dirs [] = $to . untrailingslashit ( dirname ( $info [ 'name' ]));
}
2010-02-08 13:02:23 -05:00
2013-10-14 16:58:09 -04:00
/*
* disk_free_space () could return false . Assume that any falsey value is an error .
* A disk that has zero free bytes has bigger problems .
* Require we have enough space to unzip the file and copy its contents , with a 10 % buffer .
*/
2013-10-24 18:59:29 -04:00
if ( defined ( 'DOING_CRON' ) && DOING_CRON ) {
$available_space = @ disk_free_space ( WP_CONTENT_DIR );
if ( $available_space && ( $uncompressed_size * 2.1 ) > $available_space )
return new WP_Error ( 'disk_full_unzip_file' , __ ( 'Could not copy files. You may have run out of disk space.' ), compact ( 'uncompressed_size' , 'available_space' ) );
}
2013-10-14 16:15:09 -04:00
2010-02-06 23:52:35 -05:00
$needed_dirs = array_unique ( $needed_dirs );
2010-05-23 01:56:31 -04:00
foreach ( $needed_dirs as $dir ) {
2010-05-25 22:42:15 -04:00
// Check the parent folders of the folders all exist within the creation array.
2010-05-23 01:56:31 -04:00
if ( untrailingslashit ( $to ) == $dir ) // Skip over the working directory, We know this exists (or will exist)
continue ;
2010-06-07 07:19:51 -04:00
if ( strpos ( $dir , $to ) === false ) // If the directory is not within the working directory, Skip it
continue ;
2010-05-23 01:56:31 -04:00
$parent_folder = dirname ( $dir );
while ( ! empty ( $parent_folder ) && untrailingslashit ( $to ) != $parent_folder && ! in_array ( $parent_folder , $needed_dirs ) ) {
$needed_dirs [] = $parent_folder ;
$parent_folder = dirname ( $parent_folder );
}
}
2010-02-06 23:52:35 -05:00
asort ( $needed_dirs );
2010-02-08 13:02:23 -05:00
2010-02-06 23:52:35 -05:00
// Create those directories if need be:
foreach ( $needed_dirs as $_dir ) {
if ( ! $wp_filesystem -> mkdir ( $_dir , FS_CHMOD_DIR ) && ! $wp_filesystem -> is_dir ( $_dir ) ) // Only check to see if the Dir exists upon creation failure. Less I/O this way.
2013-10-14 18:25:08 -04:00
return new WP_Error ( 'mkdir_failed_ziparchive' , __ ( 'Could not create directory.' ), substr ( $_dir , strlen ( $to ) ) );
2010-02-06 23:52:35 -05:00
}
unset ( $needed_dirs );
2010-02-08 13:02:23 -05:00
2010-02-06 23:52:35 -05:00
for ( $i = 0 ; $i < $z -> numFiles ; $i ++ ) {
if ( ! $info = $z -> statIndex ( $i ) )
2013-10-11 12:06:11 -04:00
return new WP_Error ( 'stat_failed_ziparchive' , __ ( 'Could not retrieve file from archive.' ) );
2010-02-06 23:52:35 -05:00
if ( '/' == substr ( $info [ 'name' ], - 1 ) ) // directory
continue ;
2010-05-02 19:24:36 -04:00
if ( '__MACOSX/' === substr ( $info [ 'name' ], 0 , 9 ) ) // Don't extract the OS X-created __MACOSX directory files
2010-05-03 16:26:11 -04:00
continue ;
2010-05-02 19:24:36 -04:00
2010-02-07 00:02:24 -05:00
$contents = $z -> getFromIndex ( $i );
if ( false === $contents )
2013-10-11 12:06:11 -04:00
return new WP_Error ( 'extract_failed_ziparchive' , __ ( 'Could not extract file from archive.' ), $info [ 'name' ] );
2010-02-07 00:02:24 -05:00
if ( ! $wp_filesystem -> put_contents ( $to . $info [ 'name' ], $contents , FS_CHMOD_FILE ) )
2013-10-14 18:25:08 -04:00
return new WP_Error ( 'copy_failed_ziparchive' , __ ( 'Could not copy file.' ), $info [ 'name' ] );
2010-02-06 23:52:35 -05:00
}
2010-02-19 05:59:32 -05:00
$z -> close ();
2010-02-06 23:52:35 -05:00
return true ;
}
2010-02-07 00:07:36 -05:00
/**
* This function should not be called directly , use unzip_file instead . Attempts to unzip an archive using the PclZip library .
* Assumes that WP_Filesystem () has already been called and set up .
*
2010-03-26 15:13:36 -04:00
* @ since 3.0 . 0
2010-02-07 00:07:36 -05:00
* @ see unzip_file
* @ access private
*
* @ param string $file Full path and filename of zip archive
* @ param string $to Full path on the filesystem to extract archive to
* @ param array $needed_dirs A partial list of required folders needed to be created .
* @ return mixed WP_Error on failure , True on success
*/
2010-02-06 23:52:35 -05:00
function _unzip_file_pclzip ( $file , $to , $needed_dirs = array ()) {
global $wp_filesystem ;
2013-09-11 04:09:08 -04:00
mbstring_binary_safe_encoding ();
2011-04-03 08:32:06 -04:00
2010-02-06 23:52:35 -05:00
require_once ( ABSPATH . 'wp-admin/includes/class-pclzip.php' );
$archive = new PclZip ( $file );
2011-04-03 08:32:06 -04:00
$archive_files = $archive -> extract ( PCLZIP_OPT_EXTRACT_AS_STRING );
2013-09-11 04:09:08 -04:00
reset_mbstring_encoding ();
2011-04-03 08:32:06 -04:00
2010-02-06 23:52:35 -05:00
// Is the archive valid?
2011-04-23 10:30:44 -04:00
if ( ! is_array ( $archive_files ) )
2010-02-06 23:52:35 -05:00
return new WP_Error ( 'incompatible_archive' , __ ( 'Incompatible Archive.' ), $archive -> errorInfo ( true ));
if ( 0 == count ( $archive_files ) )
2013-10-11 12:06:11 -04:00
return new WP_Error ( 'empty_archive_pclzip' , __ ( 'Empty archive.' ) );
2010-02-06 23:52:35 -05:00
2013-10-14 16:15:09 -04:00
$uncompressed_size = 0 ;
2010-01-22 06:02:09 -05:00
// Determine any children directories needed (From within the archive)
2010-05-02 19:24:36 -04:00
foreach ( $archive_files as $file ) {
2010-05-03 16:26:11 -04:00
if ( '__MACOSX/' === substr ( $file [ 'filename' ], 0 , 9 ) ) // Skip the OS X-created __MACOSX directory
2010-05-02 19:24:36 -04:00
continue ;
2010-05-03 16:26:11 -04:00
2013-10-14 16:15:09 -04:00
$uncompressed_size += $file [ 'size' ];
2010-01-22 06:02:09 -05:00
$needed_dirs [] = $to . untrailingslashit ( $file [ 'folder' ] ? $file [ 'filename' ] : dirname ( $file [ 'filename' ]) );
2010-05-02 19:24:36 -04:00
}
2010-01-22 06:02:09 -05:00
2013-10-14 16:58:09 -04:00
/*
* disk_free_space () could return false . Assume that any falsey value is an error .
* A disk that has zero free bytes has bigger problems .
* Require we have enough space to unzip the file and copy its contents , with a 10 % buffer .
*/
2013-10-24 18:59:29 -04:00
if ( defined ( 'DOING_CRON' ) && DOING_CRON ) {
$available_space = @ disk_free_space ( WP_CONTENT_DIR );
if ( $available_space && ( $uncompressed_size * 2.1 ) > $available_space )
return new WP_Error ( 'disk_full_unzip_file' , __ ( 'Could not copy files. You may have run out of disk space.' ), compact ( 'uncompressed_size' , 'available_space' ) );
}
2013-10-14 16:15:09 -04:00
2010-01-22 06:02:09 -05:00
$needed_dirs = array_unique ( $needed_dirs );
2010-05-23 01:56:31 -04:00
foreach ( $needed_dirs as $dir ) {
2010-05-25 22:42:15 -04:00
// Check the parent folders of the folders all exist within the creation array.
2010-05-23 01:56:31 -04:00
if ( untrailingslashit ( $to ) == $dir ) // Skip over the working directory, We know this exists (or will exist)
continue ;
2010-06-07 07:19:51 -04:00
if ( strpos ( $dir , $to ) === false ) // If the directory is not within the working directory, Skip it
continue ;
2010-05-23 01:56:31 -04:00
$parent_folder = dirname ( $dir );
while ( ! empty ( $parent_folder ) && untrailingslashit ( $to ) != $parent_folder && ! in_array ( $parent_folder , $needed_dirs ) ) {
$needed_dirs [] = $parent_folder ;
$parent_folder = dirname ( $parent_folder );
}
}
2010-01-22 06:02:09 -05:00
asort ( $needed_dirs );
// Create those directories if need be:
foreach ( $needed_dirs as $_dir ) {
2013-10-15 17:24:09 -04:00
// Only check to see if the dir exists upon creation failure. Less I/O this way.
if ( ! $wp_filesystem -> mkdir ( $_dir , FS_CHMOD_DIR ) && ! $wp_filesystem -> is_dir ( $_dir ) )
2013-10-14 18:25:08 -04:00
return new WP_Error ( 'mkdir_failed_pclzip' , __ ( 'Could not create directory.' ), substr ( $_dir , strlen ( $to ) ) );
2010-01-22 06:02:09 -05:00
}
2010-02-06 23:52:35 -05:00
unset ( $needed_dirs );
2010-01-22 06:02:09 -05:00
// Extract the files from the zip
foreach ( $archive_files as $file ) {
if ( $file [ 'folder' ] )
continue ;
2010-05-02 19:24:36 -04:00
if ( '__MACOSX/' === substr ( $file [ 'filename' ], 0 , 9 ) ) // Don't extract the OS X-created __MACOSX directory files
continue ;
2010-01-22 06:02:09 -05:00
if ( ! $wp_filesystem -> put_contents ( $to . $file [ 'filename' ], $file [ 'content' ], FS_CHMOD_FILE ) )
2013-10-14 18:25:08 -04:00
return new WP_Error ( 'copy_failed_pclzip' , __ ( 'Could not copy file.' ), $file [ 'filename' ] );
2010-01-22 06:02:09 -05:00
}
2008-03-01 16:20:23 -05:00
return true ;
2008-02-11 00:45:54 -05:00
}
2008-10-01 21:03:26 -04:00
/**
2009-11-05 18:03:48 -05:00
* Copies a directory from one location to another via the WordPress Filesystem Abstraction .
* Assumes that WP_Filesystem () has already been called and setup .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ param string $from source directory
* @ param string $to destination directory
2011-03-31 09:28:36 -04:00
* @ param array $skip_list a list of files / folders to skip copying
2009-11-05 18:03:48 -05:00
* @ return mixed WP_Error on failure , True on success .
2008-10-01 21:03:26 -04:00
*/
2011-03-31 09:28:36 -04:00
function copy_dir ( $from , $to , $skip_list = array () ) {
2008-02-11 00:45:54 -05:00
global $wp_filesystem ;
$dirlist = $wp_filesystem -> dirlist ( $from );
$from = trailingslashit ( $from );
$to = trailingslashit ( $to );
foreach ( ( array ) $dirlist as $filename => $fileinfo ) {
2013-09-21 02:49:11 -04:00
if ( in_array ( $filename , $skip_list ) )
continue ;
2011-03-31 09:28:36 -04:00
2008-03-01 16:20:23 -05:00
if ( 'f' == $fileinfo [ 'type' ] ) {
2011-03-21 20:04:15 -04:00
if ( ! $wp_filesystem -> copy ( $from . $filename , $to . $filename , true , FS_CHMOD_FILE ) ) {
2008-11-03 12:16:41 -05:00
// If copy failed, chmod file to 0644 and try again.
2013-10-15 15:14:10 -04:00
$wp_filesystem -> chmod ( $to . $filename , FS_CHMOD_FILE );
2011-03-21 20:04:15 -04:00
if ( ! $wp_filesystem -> copy ( $from . $filename , $to . $filename , true , FS_CHMOD_FILE ) )
2013-10-11 12:06:11 -04:00
return new WP_Error ( 'copy_failed_copy_dir' , __ ( 'Could not copy file.' ), $to . $filename );
2008-11-03 12:16:41 -05:00
}
2008-03-01 16:20:23 -05:00
} elseif ( 'd' == $fileinfo [ 'type' ] ) {
2008-08-08 18:49:35 -04:00
if ( ! $wp_filesystem -> is_dir ( $to . $filename ) ) {
2008-12-04 16:58:46 -05:00
if ( ! $wp_filesystem -> mkdir ( $to . $filename , FS_CHMOD_DIR ) )
2013-10-11 12:06:11 -04:00
return new WP_Error ( 'mkdir_failed_copy_dir' , __ ( 'Could not create directory.' ), $to . $filename );
2008-08-08 18:49:35 -04:00
}
2013-09-21 02:49:11 -04:00
// generate the $sub_skip_list for the subdirectory as a sub-set of the existing $skip_list
$sub_skip_list = array ();
foreach ( $skip_list as $skip_item ) {
if ( 0 === strpos ( $skip_item , $filename . '/' ) )
$sub_skip_list [] = preg_replace ( '!^' . preg_quote ( $filename , '!' ) . '/!i' , '' , $skip_item );
}
$result = copy_dir ( $from . $filename , $to . $filename , $sub_skip_list );
2008-05-29 13:29:32 -04:00
if ( is_wp_error ( $result ) )
return $result ;
2008-02-11 00:45:54 -05:00
}
}
2009-11-05 18:03:48 -05:00
return true ;
2008-02-11 00:45:54 -05:00
}
2008-10-01 21:03:26 -04:00
/**
2009-11-05 18:03:48 -05:00
* Initialises and connects the WordPress Filesystem Abstraction classes .
* This function will include the chosen transport and attempt connecting .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* Plugins may add extra transports , And force WordPress to use them by returning the filename via the 'filesystem_method_file' filter .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ since 2.5 . 0
*
* @ param array $args ( optional ) Connection args , These are passed directly to the WP_Filesystem_ * () classes .
* @ param string $context ( optional ) Context for get_filesystem_method (), See function declaration for more information .
* @ return boolean false on failure , true on success
2008-10-01 21:03:26 -04:00
*/
2009-05-31 17:08:03 -04:00
function WP_Filesystem ( $args = false , $context = false ) {
2008-02-11 00:45:54 -05:00
global $wp_filesystem ;
2008-05-29 13:29:32 -04:00
require_once ( ABSPATH . 'wp-admin/includes/class-wp-filesystem-base.php' );
2009-05-31 17:08:03 -04:00
$method = get_filesystem_method ( $args , $context );
2008-05-05 13:06:29 -04:00
2008-02-11 00:45:54 -05:00
if ( ! $method )
return false ;
2009-05-30 13:14:07 -04:00
if ( ! class_exists ( " WP_Filesystem_ $method " ) ) {
2014-03-23 22:45:15 -04:00
/**
* Filter the path for a specific filesystem method class file .
*
* @ since 2.6 . 0
*
* @ see get_filesystem_method ()
*
* @ param string $path Path to the specific filesystem method class file .
* @ param string $method The filesystem method to use .
*/
$abstraction_file = apply_filters ( 'filesystem_method_file' , ABSPATH . 'wp-admin/includes/class-wp-filesystem-' . $method . '.php' , $method );
2010-01-18 15:34:48 -05:00
if ( ! file_exists ( $abstraction_file ) )
2009-05-30 13:14:07 -04:00
return ;
2009-09-14 10:03:32 -04:00
2009-05-30 13:14:07 -04:00
require_once ( $abstraction_file );
}
2008-02-11 00:45:54 -05:00
$method = " WP_Filesystem_ $method " ;
$wp_filesystem = new $method ( $args );
2009-08-15 08:01:04 -04:00
//Define the timeouts for the connections. Only available after the construct is called to allow for per-transport overriding of the default.
if ( ! defined ( 'FS_CONNECT_TIMEOUT' ) )
define ( 'FS_CONNECT_TIMEOUT' , 30 );
if ( ! defined ( 'FS_TIMEOUT' ) )
define ( 'FS_TIMEOUT' , 30 );
2009-04-19 15:36:28 -04:00
if ( is_wp_error ( $wp_filesystem -> errors ) && $wp_filesystem -> errors -> get_error_code () )
2008-02-11 00:45:54 -05:00
return false ;
if ( ! $wp_filesystem -> connect () )
2011-09-03 10:18:10 -04:00
return false ; //There was an error connecting to the server.
2008-02-11 00:45:54 -05:00
2008-12-04 16:58:46 -05:00
// Set the permission constants if not already set.
if ( ! defined ( 'FS_CHMOD_DIR' ) )
2013-10-09 12:47:09 -04:00
define ( 'FS_CHMOD_DIR' , ( fileperms ( ABSPATH ) & 0777 | 0755 ) );
2008-12-04 16:58:46 -05:00
if ( ! defined ( 'FS_CHMOD_FILE' ) )
2013-10-09 12:47:09 -04:00
define ( 'FS_CHMOD_FILE' , ( fileperms ( ABSPATH . 'index.php' ) & 0777 | 0644 ) );
2008-12-04 16:58:46 -05:00
2008-02-11 00:45:54 -05:00
return true ;
}
2008-10-01 21:03:26 -04:00
/**
2009-11-05 18:03:48 -05:00
* Determines which Filesystem Method to use .
2011-09-03 10:18:10 -04:00
* The priority of the Transports are : Direct , SSH2 , FTP PHP Extension , FTP Sockets ( Via Sockets class , or fsockopen ())
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* Note that the return value of this function can be overridden in 2 ways
* - By defining FS_METHOD in your < code > wp - config . php </ code > file
* - By using the filesystem_method filter
2014-03-14 23:09:16 -04:00
* Valid values for these are : 'direct' , 'ssh2' , 'ftpext' or 'ftpsockets'
2009-11-05 18:03:48 -05:00
* Plugins may also define a custom transport handler , See the WP_Filesystem function for more information .
*
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* @ param array $args Connection details .
2009-05-31 17:08:03 -04:00
* @ param string $context Full path to the directory that is tested for being writable .
2009-11-05 18:03:48 -05:00
* @ return string The transport to use , see description for valid return values .
2008-10-01 21:03:26 -04:00
*/
2009-05-31 17:08:03 -04:00
function get_filesystem_method ( $args = array (), $context = false ) {
2014-03-14 23:09:16 -04:00
$method = defined ( 'FS_METHOD' ) ? FS_METHOD : false ; // Please ensure that this is either 'direct', 'ssh2', 'ftpext' or 'ftpsockets'
2009-05-25 06:39:21 -04:00
2010-01-18 15:34:48 -05:00
if ( ! $method && function_exists ( 'getmyuid' ) && function_exists ( 'fileowner' ) ){
2009-05-31 17:08:03 -04:00
if ( ! $context )
$context = WP_CONTENT_DIR ;
2013-10-16 00:15:09 -04:00
// If the directory doesn't exist (wp-content/languages) then use the parent directory as we'll create it.
if ( WP_LANG_DIR == $context && ! is_dir ( $context ) )
$context = dirname ( $context );
2009-05-31 17:08:03 -04:00
$context = trailingslashit ( $context );
2009-08-15 04:03:48 -04:00
$temp_file_name = $context . 'temp-write-test-' . time ();
2009-05-25 06:39:21 -04:00
$temp_handle = @ fopen ( $temp_file_name , 'w' );
2009-05-26 20:56:32 -04:00
if ( $temp_handle ) {
2009-08-15 04:03:48 -04:00
if ( getmyuid () == @ fileowner ( $temp_file_name ) )
2009-05-26 20:56:32 -04:00
$method = 'direct' ;
@ fclose ( $temp_handle );
2009-08-15 04:03:48 -04:00
@ unlink ( $temp_file_name );
2009-05-26 20:56:32 -04:00
}
2009-05-25 06:39:21 -04:00
}
2008-02-11 00:45:54 -05:00
2009-06-23 17:54:53 -04:00
if ( ! $method && isset ( $args [ 'connection_type' ]) && 'ssh' == $args [ 'connection_type' ] && extension_loaded ( 'ssh2' ) && function_exists ( 'stream_get_contents' ) ) $method = 'ssh2' ;
2008-04-25 17:34:54 -04:00
if ( ! $method && extension_loaded ( 'ftp' ) ) $method = 'ftpext' ;
if ( ! $method && ( extension_loaded ( 'sockets' ) || function_exists ( 'fsockopen' ) ) ) $method = 'ftpsockets' ; //Sockets: Socket extension; PHP Mode: FSockopen / fwrite / fread
2014-03-23 22:45:15 -04:00
/**
* Filter the filesystem method to use .
*
* @ since 2.6 . 0
*
* @ param string $method Filesystem method to return .
* @ param array $args An array of connection details for the method .
*/
return apply_filters ( 'filesystem_method' , $method , $args );
2008-02-11 00:45:54 -05:00
}
2008-10-01 21:03:26 -04:00
/**
2011-12-14 12:36:38 -05:00
* Displays a form to the user to request for their FTP / SSH details in order to connect to the filesystem .
2009-11-05 18:03:48 -05:00
* All chosen / entered details are saved , Excluding the Password .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* Hostnames may be in the form of hostname : portnumber ( eg : wordpress . org : 2467 ) to specify an alternate FTP / SSH port .
2008-10-01 21:03:26 -04:00
*
2009-11-05 18:03:48 -05:00
* Plugins may override this form by returning true | false via the < code > request_filesystem_credentials </ code > filter .
*
* @ since 2.5 . 0
*
* @ param string $form_post the URL to post the form to
* @ param string $type the chosen Filesystem method in use
* @ param boolean $error if the current request has failed to connect
2011-12-14 12:36:38 -05:00
* @ param string $context The directory which is needed access to , The write - test will be performed on this directory by get_filesystem_method ()
2010-03-03 14:53:39 -05:00
* @ param string $extra_fields Extra POST fields which should be checked for to be included in the post .
2009-11-05 18:03:48 -05:00
* @ return boolean False on failure . True on success .
2008-10-01 21:03:26 -04:00
*/
2010-03-03 14:53:39 -05:00
function request_filesystem_credentials ( $form_post , $type = '' , $error = false , $context = false , $extra_fields = null ) {
2014-03-23 22:45:15 -04:00
/**
* Filter the filesystem credentials form output .
*
* Returning anything other than an empty string will effectively short - circuit
* output of the filesystem credentials form , returning that value instead .
*
* @ since 2.5 . 0
*
* @ param mixed $output Form output to return instead . Default empty .
* @ param string $form_post URL to POST the form to .
* @ param string $type Chosen type of filesystem .
* @ param bool $error Whether the current request has failed to connect .
* Default false .
* @ param string $context Full path to the directory that is tested for
* being writable .
* @ param array $extra_fields Extra POST fields .
*/
2010-03-03 14:53:39 -05:00
$req_cred = apply_filters ( 'request_filesystem_credentials' , '' , $form_post , $type , $error , $context , $extra_fields );
2008-08-04 17:01:09 -04:00
if ( '' !== $req_cred )
return $req_cred ;
if ( empty ( $type ) )
2009-05-31 17:08:03 -04:00
$type = get_filesystem_method ( array (), $context );
2008-08-04 17:01:09 -04:00
if ( 'direct' == $type )
return true ;
2008-08-09 01:36:14 -04:00
2010-03-03 14:53:39 -05:00
if ( is_null ( $extra_fields ) )
$extra_fields = array ( 'version' , 'locale' );
2009-04-22 19:38:01 -04:00
$credentials = get_option ( 'ftp_credentials' , array ( 'hostname' => '' , 'username' => '' ));
2008-08-04 17:01:09 -04:00
// If defined, set it to that, Else, If POST'd, set it to that, If not, Set it to whatever it previously was(saved details in option)
2013-03-01 12:00:25 -05:00
$credentials [ 'hostname' ] = defined ( 'FTP_HOST' ) ? FTP_HOST : ( ! empty ( $_POST [ 'hostname' ]) ? wp_unslash ( $_POST [ 'hostname' ] ) : $credentials [ 'hostname' ]);
$credentials [ 'username' ] = defined ( 'FTP_USER' ) ? FTP_USER : ( ! empty ( $_POST [ 'username' ]) ? wp_unslash ( $_POST [ 'username' ] ) : $credentials [ 'username' ]);
$credentials [ 'password' ] = defined ( 'FTP_PASS' ) ? FTP_PASS : ( ! empty ( $_POST [ 'password' ]) ? wp_unslash ( $_POST [ 'password' ] ) : '' );
2008-12-09 13:03:31 -05:00
2008-09-11 13:44:43 -04:00
// Check to see if we are setting the public/private keys for ssh
2013-03-01 12:00:25 -05:00
$credentials [ 'public_key' ] = defined ( 'FTP_PUBKEY' ) ? FTP_PUBKEY : ( ! empty ( $_POST [ 'public_key' ]) ? wp_unslash ( $_POST [ 'public_key' ] ) : '' );
$credentials [ 'private_key' ] = defined ( 'FTP_PRIKEY' ) ? FTP_PRIKEY : ( ! empty ( $_POST [ 'private_key' ]) ? wp_unslash ( $_POST [ 'private_key' ] ) : '' );
2008-12-09 13:03:31 -05:00
2014-07-17 05:14:16 -04:00
// Sanitize the hostname, Some people might pass in odd-data:
2008-12-12 15:12:16 -05:00
$credentials [ 'hostname' ] = preg_replace ( '|\w+://|' , '' , $credentials [ 'hostname' ]); //Strip any schemes off
2009-11-05 18:03:48 -05:00
if ( strpos ( $credentials [ 'hostname' ], ':' ) ) {
2008-09-08 23:24:05 -04:00
list ( $credentials [ 'hostname' ], $credentials [ 'port' ] ) = explode ( ':' , $credentials [ 'hostname' ], 2 );
2009-11-05 18:03:48 -05:00
if ( ! is_numeric ( $credentials [ 'port' ]) )
unset ( $credentials [ 'port' ]);
} else {
2008-12-12 15:12:16 -05:00
unset ( $credentials [ 'port' ]);
2009-11-05 18:03:48 -05:00
}
2008-09-08 23:24:05 -04:00
2014-03-14 23:09:16 -04:00
if ( ( defined ( 'FTP_SSH' ) && FTP_SSH ) || ( defined ( 'FS_METHOD' ) && 'ssh2' == FS_METHOD ) )
2008-09-05 01:35:58 -04:00
$credentials [ 'connection_type' ] = 'ssh' ;
2009-11-23 16:52:13 -05:00
else if ( ( defined ( 'FTP_SSL' ) && FTP_SSL ) && 'ftpext' == $type ) //Only the FTP Extension understands SSL
2008-09-05 01:35:58 -04:00
$credentials [ 'connection_type' ] = 'ftps' ;
2009-05-30 13:14:07 -04:00
else if ( ! empty ( $_POST [ 'connection_type' ]) )
2013-03-01 12:00:25 -05:00
$credentials [ 'connection_type' ] = wp_unslash ( $_POST [ 'connection_type' ] );
2012-12-20 10:55:32 -05:00
else if ( ! isset ( $credentials [ 'connection_type' ]) ) //All else fails (And it's not defaulted to something else saved), Default to FTP
2008-09-05 01:35:58 -04:00
$credentials [ 'connection_type' ] = 'ftp' ;
2008-08-04 17:01:09 -04:00
2009-05-24 19:47:49 -04:00
if ( ! $error &&
2009-04-22 19:38:01 -04:00
(
( ! empty ( $credentials [ 'password' ]) && ! empty ( $credentials [ 'username' ]) && ! empty ( $credentials [ 'hostname' ]) ) ||
( 'ssh' == $credentials [ 'connection_type' ] && ! empty ( $credentials [ 'public_key' ]) && ! empty ( $credentials [ 'private_key' ]) )
) ) {
2008-08-04 17:01:09 -04:00
$stored_credentials = $credentials ;
2008-12-12 15:12:16 -05:00
if ( ! empty ( $stored_credentials [ 'port' ]) ) //save port as part of hostname to simplify above code.
$stored_credentials [ 'hostname' ] .= ':' . $stored_credentials [ 'port' ];
unset ( $stored_credentials [ 'password' ], $stored_credentials [ 'port' ], $stored_credentials [ 'private_key' ], $stored_credentials [ 'public_key' ]);
2008-08-04 17:01:09 -04:00
update_option ( 'ftp_credentials' , $stored_credentials );
return $credentials ;
}
2014-05-16 14:26:15 -04:00
$hostname = isset ( $credentials [ 'hostname' ] ) ? $credentials [ 'hostname' ] : '' ;
$username = isset ( $credentials [ 'username' ] ) ? $credentials [ 'username' ] : '' ;
$public_key = isset ( $credentials [ 'public_key' ] ) ? $credentials [ 'public_key' ] : '' ;
$private_key = isset ( $credentials [ 'private_key' ] ) ? $credentials [ 'private_key' ] : '' ;
$port = isset ( $credentials [ 'port' ] ) ? $credentials [ 'port' ] : '' ;
$connection_type = isset ( $credentials [ '' ] ) ? $credentials [ '' ] : '' ;
2008-09-05 01:35:58 -04:00
if ( $error ) {
2011-09-30 13:18:35 -04:00
$error_string = __ ( '<strong>ERROR:</strong> There was an error connecting to the server, Please verify the settings are correct.' );
2008-09-05 01:35:58 -04:00
if ( is_wp_error ( $error ) )
2011-01-01 17:14:42 -05:00
$error_string = esc_html ( $error -> get_error_message () );
echo '<div id="message" class="error"><p>' . $error_string . '</p></div>' ;
2008-09-05 01:35:58 -04:00
}
2009-11-05 18:03:48 -05:00
$types = array ();
if ( extension_loaded ( 'ftp' ) || extension_loaded ( 'sockets' ) || function_exists ( 'fsockopen' ) )
$types [ 'ftp' ] = __ ( 'FTP' );
if ( extension_loaded ( 'ftp' ) ) //Only this supports FTPS
$types [ 'ftps' ] = __ ( 'FTPS (SSL)' );
if ( extension_loaded ( 'ssh2' ) && function_exists ( 'stream_get_contents' ) )
$types [ 'ssh' ] = __ ( 'SSH2' );
2014-03-23 22:45:15 -04:00
/**
* Filter the connection types to output to the filesystem credentials form .
*
* @ since 2.9 . 0
*
* @ param array $types Types of connections .
* @ param array $credentials Credentials to connect with .
* @ param string $type Chosen filesystem method .
* @ param object $error Error object .
* @ param string $context Full path to the directory that is tested
* for being writable .
*/
$types = apply_filters ( 'fs_ftp_connection_types' , $types , $credentials , $type , $error , $context );
2009-11-05 18:03:48 -05:00
2008-08-04 17:01:09 -04:00
?>
2008-09-11 13:44:43 -04:00
< script type = " text/javascript " >
<!--
jQuery ( function ( $ ){
jQuery ( " #ssh " ) . click ( function () {
2008-09-13 14:06:20 -04:00
jQuery ( " #ssh_keys " ) . show ();
2008-09-11 13:44:43 -04:00
});
2008-09-13 14:06:20 -04:00
jQuery ( " #ftp, #ftps " ) . click ( function () {
jQuery ( " #ssh_keys " ) . hide ();
2008-12-09 13:03:31 -05:00
});
2009-03-17 22:43:45 -04:00
jQuery ( 'form input[value=""]:first' ) . focus ();
2008-09-11 13:44:43 -04:00
});
-->
</ script >
2013-03-18 10:01:25 -04:00
< form action = " <?php echo esc_url( $form_post ) ?> " method = " post " >
2013-10-16 00:15:09 -04:00
< div >
< h3 >< ? php _e ( 'Connection Information' ) ?> </h3>
2010-06-01 16:35:59 -04:00
< p >< ? php
2010-06-03 14:58:41 -04:00
$label_user = __ ( 'Username' );
$label_pass = __ ( 'Password' );
2010-09-07 11:11:43 -04:00
_e ( 'To perform the requested action, WordPress needs to access your web server.' );
2010-06-01 17:57:26 -04:00
echo ' ' ;
2010-06-01 16:35:59 -04:00
if ( ( isset ( $types [ 'ftp' ] ) || isset ( $types [ 'ftps' ] ) ) ) {
2010-06-03 14:58:41 -04:00
if ( isset ( $types [ 'ssh' ] ) ) {
2010-06-01 16:35:59 -04:00
_e ( 'Please enter your FTP or SSH credentials to proceed.' );
2010-06-03 14:58:41 -04:00
$label_user = __ ( 'FTP/SSH Username' );
$label_pass = __ ( 'FTP/SSH Password' );
} else {
2010-06-01 16:35:59 -04:00
_e ( 'Please enter your FTP credentials to proceed.' );
2010-06-03 14:58:41 -04:00
$label_user = __ ( 'FTP Username' );
$label_pass = __ ( 'FTP Password' );
}
2010-06-01 17:57:26 -04:00
echo ' ' ;
2010-06-01 16:35:59 -04:00
}
_e ( 'If you do not remember your credentials, you should contact your web host.' );
?> </p>
2008-08-04 17:01:09 -04:00
< table class = " form-table " >
2014-01-24 14:06:15 -05:00
< tr >
2008-09-05 01:35:58 -04:00
< th scope = " row " >< label for = " hostname " >< ? php _e ( 'Hostname' ) ?> </label></th>
2010-03-11 12:12:23 -05:00
< td >< input name = " hostname " type = " text " id = " hostname " value = " <?php echo esc_attr( $hostname ); if ( !empty( $port ) ) echo " : $port " ; ?> " < ? php disabled ( defined ( 'FTP_HOST' ) ); ?> size="40" /></td>
2008-08-04 17:01:09 -04:00
</ tr >
2008-12-02 20:43:11 -05:00
2014-01-24 14:06:15 -05:00
< tr >
2010-06-03 14:58:41 -04:00
< th scope = " row " >< label for = " username " >< ? php echo $label_user ; ?> </label></th>
2010-03-11 12:12:23 -05:00
< td >< input name = " username " type = " text " id = " username " value = " <?php echo esc_attr( $username ) ?> " < ? php disabled ( defined ( 'FTP_USER' ) ); ?> size="40" /></td>
2008-08-04 17:01:09 -04:00
</ tr >
2008-12-02 20:43:11 -05:00
2014-01-24 14:06:15 -05:00
< tr >
2010-06-03 14:58:41 -04:00
< th scope = " row " >< label for = " password " >< ? php echo $label_pass ; ?> </label></th>
2013-08-21 03:07:09 -04:00
< td >< div >< input name = " password " type = " password " id = " password " value = " <?php if ( defined('FTP_PASS') ) echo '*****'; ?> " < ? php disabled ( defined ( 'FTP_PASS' ) ); ?> size="40" /></div>
< div >< em >< ? php if ( ! defined ( 'FTP_PASS' ) ) _e ( 'This password will not be stored on the server.' ); ?> </em></div></td>
2008-08-04 17:01:09 -04:00
</ tr >
2008-12-02 20:43:11 -05:00
2009-11-05 18:03:48 -05:00
< ? php if ( isset ( $types [ 'ssh' ]) ) : ?>
2014-01-24 14:06:15 -05:00
< tr id = " ssh_keys " style = " <?php if ( 'ssh' != $connection_type ) echo 'display:none' ?> " >
2008-12-02 20:43:11 -05:00
< th scope = " row " >< ? php _e ( 'Authentication Keys' ) ?>
< div class = " key-labels textright " >
< label for = " public_key " >< ? php _e ( 'Public Key:' ) ?> </label ><br />
< label for = " private_key " >< ? php _e ( 'Private Key:' ) ?> </label>
</ div ></ th >
2014-05-16 14:26:15 -04:00
< td >< br />< input name = " public_key " type = " text " id = " public_key " value = " <?php echo esc_attr( $public_key ) ?> " < ? php disabled ( defined ( 'FTP_PUBKEY' ) ); ?> size="40" />
< br />< input name = " private_key " type = " text " id = " private_key " value = " <?php echo esc_attr( $private_key ) ?> " < ? php disabled ( defined ( 'FTP_PRIKEY' ) ); ?> size="40" />
2008-12-02 20:43:11 -05:00
< div >< ? php _e ( 'Enter the location on the server where the keys are located. If a passphrase is needed, enter that in the password field above.' ) ?> </div></td>
2008-09-11 13:44:43 -04:00
</ tr >
2009-05-30 13:14:07 -04:00
< ? php endif ; ?>
2008-12-02 20:43:11 -05:00
2014-01-24 14:06:15 -05:00
< tr >
2008-09-05 01:35:58 -04:00
< th scope = " row " >< ? php _e ( 'Connection Type' ) ?> </th>
2008-08-04 17:01:09 -04:00
< td >
2009-05-12 18:40:56 -04:00
< fieldset >< legend class = " screen-reader-text " >< span >< ? php _e ( 'Connection Type' ) ?> </span></legend>
2010-03-11 12:21:18 -05:00
< ? php
$disabled = disabled ( ( defined ( 'FTP_SSL' ) && FTP_SSL ) || ( defined ( 'FTP_SSH' ) && FTP_SSH ), true , false );
foreach ( $types as $name => $text ) : ?>
2009-11-06 05:53:41 -05:00
< label for = " <?php echo esc_attr( $name ) ?> " >
2010-03-11 12:21:18 -05:00
< input type = " radio " name = " connection_type " id = " <?php echo esc_attr( $name ) ?> " value = " <?php echo esc_attr( $name ) ?> " < ? php checked ( $name , $connection_type ); echo $disabled ; ?> />
2009-11-05 18:03:48 -05:00
< ? php echo $text ?>
</ label >
< ? php endforeach ; ?>
2008-09-05 01:35:58 -04:00
</ fieldset >
2008-08-04 17:01:09 -04:00
</ td >
</ tr >
</ table >
2008-12-02 20:43:11 -05:00
2010-03-03 14:53:39 -05:00
< ? php
foreach ( ( array ) $extra_fields as $field ) {
if ( isset ( $_POST [ $field ] ) )
2013-03-01 12:00:25 -05:00
echo '<input type="hidden" name="' . esc_attr ( $field ) . '" value="' . esc_attr ( wp_unslash ( $_POST [ $field ] ) ) . '" />' ;
2010-03-03 14:53:39 -05:00
}
2010-10-28 17:56:43 -04:00
submit_button ( __ ( 'Proceed' ), 'button' , 'upgrade' );
2010-03-03 14:53:39 -05:00
?>
2008-08-04 17:01:09 -04:00
</ div >
</ form >
< ? php
return false ;
}