Changeset 22632 for trunk/wp-admin/includes/import.php

Timestamp:

11/17/2012 07:20:04 AM (14 years ago)

Author:

nacin

Message:

Pull the list of popular importers from WordPress.org.

These are the importers we suggest on import.php, prompting the user to
install the relevant plugin for the import they want to go through.

If the API is inaccessible, it falls back to a hard-coded list that should
be kept sync'd with the API with each major version of WordPress. This API
enables us to add new importers between releases, as they are completed or
if services gain quick adoption. As a last resort, we can also temporarily
disable importers that are broken (due to API changes, for example).

The importer currently returns English strings (which are then run through
translate() for existing strings), but the locale is passed to the API,
allowing us to ship translated strings if we wish to be adventurous.

props dllh for the assist.
fixes #18977.

File:

• trunk/wp-admin/includes/import.php (modified) (1 diff)

trunk/wp-admin/includes/import.php

@@ -94 +94 @@
         return array( 'file' => $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();
+        $popular_importers = get_site_transient( 'popular_importers_' . $locale );
+
+        if ( ! $popular_importers ) {
+                $url = add_query_arg( 'locale', get_locale(), 'http://api.wordpress.org/core/importers/1.0/' );
+                $options = array( 'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url() );
+                $popular_importers = maybe_unserialize( wp_remote_retrieve_body( wp_remote_get( $url, $options ) ) );
+
+                if ( is_array( $popular_importers ) )
+                        set_site_transient( 'popular_importers_' . $locale, $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' => __( 'Install the Blogger importer to import posts, comments, and users from a Blogger blog.' ),
+                        'plugin-slug' => 'blogger-importer',
+                        'importer-id' => 'blogger',
+                ),
+                'wpcat2tag' => array(
+                        'name' => __( 'Categories and Tags Converter' ),
+                        'description' => __( 'Install the category/tag converter to convert existing categories to tags or tags to categories, selectively.' ),
+                        'plugin-slug' => 'wpcat2tag-importer',
+                        'importer-id' => 'wp-cat2tag',
+                ),
+                'livejournal' => array(
+                        'name' => __( 'LiveJournal' ),
+                        'description' => __( 'Install the LiveJournal importer to import posts from LiveJournal using their API.' ),
+                        'plugin-slug' => 'livejournal-importer',
+                        'importer-id' => 'livejournal',
+                ),
+                'movabletype' => array(
+                        'name' => __( 'Movable Type and TypePad' ),
+                        'description' => __( 'Install the Movable Type importer to import posts and comments from a Movable Type or TypePad blog.' ),
+                        'plugin-slug' => 'movabletype-importer',
+                        'importer-id' => 'mt',
+                ),
+                'opml' => array(
+                        'name' => __( 'Blogroll' ),
+                        'description' => __( 'Install the blogroll importer to import links in OPML format.' ),
+                        'plugin-slug' => 'opml-importer',
+                        'importer-id' => 'opml',
+                ),
+                'rss' => array(
+                        'name' => __( 'RSS' ),
+                        'description' => __( 'Install the RSS importer to import posts from an RSS feed.' ),
+                        'plugin-slug' => 'rss-importer',
+                        'importer-id' => 'rss',
+                ),
+                'tumblr' => array(
+                        'name' => __( 'Tumblr' ),
+                        'description' => __( 'Install the Tumblr importer to import posts & media from Tumblr using their API.' ),
+                        'plugin-slug' => 'tumblr-importer',
+                        'importer-id' => 'tumblr',
+                ),
+                'wordpress' => array(
+                        'name' => 'WordPress',
+                        'description' => __( 'Install the WordPress importer to import posts, pages, comments, custom fields, categories, and tags from a WordPress export file.' ),
+                        'plugin-slug' => 'wordpress-importer',
+                        'importer-id' => 'wordpress',
+                ),
+        );
+}