summaryrefslogtreecommitdiffstats
path: root/wp-admin/includes/import.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
commita415c29efee45520ae252d2aa28f1083a521cd7b (patch)
treef4ade4b6668ecc0765de7e1424f7c1427ad433ff /wp-admin/includes/import.php
parentInitial commit. (diff)
downloadwordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.tar.xz
wordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.zip
Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-admin/includes/import.php')
-rw-r--r--wp-admin/includes/import.php232
1 files changed, 232 insertions, 0 deletions
diff --git a/wp-admin/includes/import.php b/wp-admin/includes/import.php
new file mode 100644
index 0000000..87ee00e
--- /dev/null
+++ b/wp-admin/includes/import.php
@@ -0,0 +1,232 @@
+<?php
+/**
+ * WordPress Administration Importer API.
+ *
+ * @package WordPress
+ * @subpackage Administration
+ */
+
+/**
+ * Retrieves the 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, '_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] );
+}
+
+/**
+ * Registers 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 void|WP_Error Void on success. WP_Error when $callback is WP_Error.
+ */
+function register_importer( $id, $name, $description, $callback ) {
+ global $wp_importers;
+ if ( is_wp_error( $callback ) ) {
+ return $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 );
+}
+
+/**
+ * Handles importer uploading and adds attachment.
+ *
+ * @since 2.0.0
+ *
+ * @return array Uploaded file's details on success, error message on failure.
+ */
+function wp_import_handle_upload() {
+ if ( ! isset( $_FILES['import'] ) ) {
+ return array(
+ 'error' => sprintf(
+ /* translators: 1: php.ini, 2: post_max_size, 3: upload_max_filesize */
+ __( 'File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your %1$s file or by %2$s being defined as smaller than %3$s in %1$s.' ),
+ 'php.ini',
+ 'post_max_size',
+ 'upload_max_filesize'
+ ),
+ );
+ }
+
+ $overrides = array(
+ 'test_form' => false,
+ 'test_type' => false,
+ );
+ $_FILES['import']['name'] .= '.txt';
+ $upload = wp_handle_upload( $_FILES['import'], $overrides );
+
+ if ( isset( $upload['error'] ) ) {
+ return $upload;
+ }
+
+ // Construct the attachment array.
+ $attachment = array(
+ 'post_title' => wp_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( $attachment, $upload['file'] );
+
+ /*
+ * 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 an unmodified $wp_version.
+ require ABSPATH . WPINC . '/version.php';
+
+ $locale = get_user_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' => $locale,
+ 'version' => $wp_version,
+ ),
+ 'http://api.wordpress.org/core/importers/1.1/'
+ );
+ $options = array( 'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ) );
+
+ if ( wp_http_supports( array( 'ssl' ) ) ) {
+ $url = set_url_scheme( $url, 'https' );
+ }
+
+ $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 ) {
+ // phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText
+ $importer['description'] = translate( $importer['description'] );
+ if ( 'WordPress' !== $importer['name'] ) {
+ // phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText
+ $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',
+ ),
+ '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',
+ ),
+ );
+}