X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/177fd6fefd2e3d5a0ea6591c71d660cabdb3c1a4..febc815b2c9d85be5717da9e8d164bd2daa97e31:/wp-admin/includes/import.php

diff --git a/wp-admin/includes/import.php b/wp-admin/includes/import.php
index 35fd141b..4f0b7853 100644
--- a/wp-admin/includes/import.php
+++ b/wp-admin/includes/import.php
@@ -1,12 +1,56 @@
 <?php
+/**
+ * WordPress Administration Importer API.
+ *
+ * @package WordPress
+ * @subpackage Administration
+ */
 
+/**
+ * Retrieve list of importers.
+ *
+ * @since 2.0.0
+ *
+ * @global array $wp_importers
+ * @return array
+ */
 function get_importers() {
 	global $wp_importers;
-	if ( is_array($wp_importers) )
-		uasort($wp_importers, create_function('$a, $b', 'return strcmp($a[0], $b[0]);'));
+	if ( is_array( $wp_importers ) ) {
+		uasort( $wp_importers, '_usort_by_first_member' );
+	}
 	return $wp_importers;
 }
 
+/**
+ * Sorts a multidimensional array by first member of each top level member
+ *
+ * Used by uasort() as a callback, should not be used directly.
+ *
+ * @since 2.9.0
+ * @access private
+ *
+ * @param array $a
+ * @param array $b
+ * @return int
+ */
+function _usort_by_first_member( $a, $b ) {
+	return strnatcasecmp( $a[0], $b[0] );
+}
+
+/**
+ * Register importer for WordPress.
+ *
+ * @since 2.0.0
+ *
+ * @global array $wp_importers
+ *
+ * @param string   $id          Importer tag. Used to uniquely identify importer.
+ * @param string   $name        Importer name and title.
+ * @param string   $description Importer description.
+ * @param callable $callback    Callback to run.
+ * @return WP_Error Returns WP_Error when $callback is WP_Error.
+ */
 function register_importer( $id, $name, $description, $callback ) {
 	global $wp_importers;
 	if ( is_wp_error( $callback ) )
@@ -14,34 +58,155 @@ function register_importer( $id, $name, $description, $callback ) {
 	$wp_importers[$id] = array ( $name, $description, $callback );
 }
 
+/**
+ * Cleanup importer.
+ *
+ * Removes attachment based on ID.
+ *
+ * @since 2.0.0
+ *
+ * @param string $id Importer ID.
+ */
 function wp_import_cleanup( $id ) {
 	wp_delete_attachment( $id );
 }
 
+/**
+ * Handle importer uploading and add attachment.
+ *
+ * @since 2.0.0
+ *
+ * @return array Uploaded file's details on success, error message on failure
+ */
 function wp_import_handle_upload() {
-	$overrides = array( 'test_form' => false, 'test_type' => false );
-	$_FILES['import']['name'] .= '.import';
-	$file = wp_handle_upload( $_FILES['import'], $overrides );
+	if ( ! isset( $_FILES['import'] ) ) {
+		return array(
+			'error' => __( '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.' )
+		);
+	}
 
-	if ( isset( $file['error'] ) )
-		return $file;
+	$overrides = array( 'test_form' => false, 'test_type' => false );
+	$_FILES['import']['name'] .= '.txt';
+	$upload = wp_handle_upload( $_FILES['import'], $overrides );
 
-	$url = $file['url'];
-	$type = $file['type'];
-	$file = addslashes( $file['file'] );
-	$filename = basename( $file );
+	if ( isset( $upload['error'] ) ) {
+		return $upload;
+	}
 
 	// Construct the object array
-	$object = array( 'post_title' => $filename,
-		'post_content' => $url,
-		'post_mime_type' => $type,
-		'guid' => $url
+	$object = array(
+		'post_title' => basename( $upload['file'] ),
+		'post_content' => $upload['url'],
+		'post_mime_type' => $upload['type'],
+		'guid' => $upload['url'],
+		'context' => 'import',
+		'post_status' => 'private'
 	);
 
 	// Save the data
-	$id = wp_insert_attachment( $object, $file );
+	$id = wp_insert_attachment( $object, $upload['file'] );
 
-	return array( 'file' => $file, 'id' => $id );
+	/*
+	 * Schedule a cleanup for one day from now in case of failed
+	 * import or missing wp_import_cleanup() call.
+	 */
+	wp_schedule_single_event( time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array( $id ) );
+
+	return array( 'file' => $upload['file'], 'id' => $id );
 }
 
-?>
+/**
+ * Returns a list from WordPress.org of popular importer plugins.
+ *
+ * @since 3.5.0
+ *
+ * @return array Importers with metadata for each.
+ */
+function wp_get_popular_importers() {
+	include( ABSPATH . WPINC . '/version.php' ); // include an unmodified $wp_version
+
+	$locale = get_locale();
+	$cache_key = 'popular_importers_' . md5( $locale . $wp_version );
+	$popular_importers = get_site_transient( $cache_key );
+
+	if ( ! $popular_importers ) {
+		$url = add_query_arg( array(
+			'locale'  => get_locale(),
+			'version' => $wp_version,
+		), 'http://api.wordpress.org/core/importers/1.1/' );
+		$options = array( 'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url() );
+		$response = wp_remote_get( $url, $options );
+		$popular_importers = json_decode( wp_remote_retrieve_body( $response ), true );
+
+		if ( is_array( $popular_importers ) ) {
+			set_site_transient( $cache_key, $popular_importers, 2 * DAY_IN_SECONDS );
+		} else {
+			$popular_importers = false;
+		}
+	}
+
+	if ( is_array( $popular_importers ) ) {
+		// If the data was received as translated, return it as-is.
+		if ( $popular_importers['translated'] )
+			return $popular_importers['importers'];
+
+		foreach ( $popular_importers['importers'] as &$importer ) {
+			$importer['description'] = translate( $importer['description'] );
+			if ( $importer['name'] != 'WordPress' )
+				$importer['name'] = translate( $importer['name'] );
+		}
+		return $popular_importers['importers'];
+	}
+
+	return array(
+		// slug => name, description, plugin slug, and register_importer() slug
+		'blogger' => array(
+			'name' => __( 'Blogger' ),
+			'description' => __( 'Import posts, comments, and users from a Blogger blog.' ),
+			'plugin-slug' => 'blogger-importer',
+			'importer-id' => 'blogger',
+		),
+		'wpcat2tag' => array(
+			'name' => __( 'Categories and Tags Converter' ),
+			'description' => __( 'Convert existing categories to tags or tags to categories, selectively.' ),
+			'plugin-slug' => 'wpcat2tag-importer',
+			'importer-id' => 'wp-cat2tag',
+		),
+		'livejournal' => array(
+			'name' => __( 'LiveJournal' ),
+			'description' => __( 'Import posts from LiveJournal using their API.' ),
+			'plugin-slug' => 'livejournal-importer',
+			'importer-id' => 'livejournal',
+		),
+		'movabletype' => array(
+			'name' => __( 'Movable Type and TypePad' ),
+			'description' => __( 'Import posts and comments from a Movable Type or TypePad blog.' ),
+			'plugin-slug' => 'movabletype-importer',
+			'importer-id' => 'mt',
+		),
+		'opml' => array(
+			'name' => __( 'Blogroll' ),
+			'description' => __( 'Import links in OPML format.' ),
+			'plugin-slug' => 'opml-importer',
+			'importer-id' => 'opml',
+		),
+		'rss' => array(
+			'name' => __( 'RSS' ),
+			'description' => __( 'Import posts from an RSS feed.' ),
+			'plugin-slug' => 'rss-importer',
+			'importer-id' => 'rss',
+		),
+		'tumblr' => array(
+			'name' => __( 'Tumblr' ),
+			'description' => __( 'Import posts &amp; media from Tumblr using their API.' ),
+			'plugin-slug' => 'tumblr-importer',
+			'importer-id' => 'tumblr',
+		),
+		'wordpress' => array(
+			'name' => 'WordPress',
+			'description' => __( 'Import posts, pages, comments, custom fields, categories, and tags from a WordPress export file.' ),
+			'plugin-slug' => 'wordpress-importer',
+			'importer-id' => 'wordpress',
+		),
+	);
+}