1 === Plugin Name ===

     2 Contributors: wordpressdotorg

     3 Donate link: 

     4 Tags: importer, wordpress

     5 Requires at least: 3.0

     6 Tested up to: 3.4

     7 Stable tag: 0.6

     8 

     9 Import posts, pages, comments, custom fields, categories, tags and more from a WordPress export file.

    10 

    11 == Description ==

    12 

    13 The WordPress Importer will import the following content from a WordPress export file:

    14 

    15 * Posts, pages and other custom post types

    16 * Comments

    17 * Custom fields and post meta

    18 * Categories, tags and terms from custom taxonomies

    19 * Authors

    20 

    21 For further information and instructions please see the [Codex page on Importing Content](http://codex.wordpress.org/Importing_Content#WordPress)

    22 

    23 == Installation ==

    24 

    25 The quickest method for installing the importer is:

    26 

    27 1. Visit Tools -> Import in the WordPress dashboard

    28 1. Click on the WordPress link in the list of importers

    29 1. Click "Install Now"

    30 1. Finally click "Activate Plugin & Run Importer"

    31 

    32 If you would prefer to do things manually then follow these instructions:

    33 

    34 1. Upload the `wordpress-importer` folder to the `/wp-content/plugins/` directory

    35 1. Activate the plugin through the 'Plugins' menu in WordPress

    36 1. Go to the Tools -> Import screen, click on WordPress

    37 

    38 == Changelog ==

    39 

    40 = 0.6 =

    41 * Support for WXR 1.2 and multiple CDATA sections

    42 * Post aren't duplicates if their post_type's are different

    43 

    44 = 0.5.2 =

    45 * Double check that the uploaded export file exists before processing it. This prevents incorrect error messages when

    46 an export file is uploaded to a server with bad permissions and WordPress 3.3 or 3.3.1 is being used.

    47 

    48 = 0.5 =

    49 * Import comment meta (requires export from WordPress 3.2)

    50 * Minor bugfixes and enhancements

    51 

    52 = 0.4 =

    53 * Map comment user_id where possible

    54 * Import attachments from `wp:attachment_url`

    55 * Upload attachments to correct directory

    56 * Remap resized image URLs correctly

    57 

    58 = 0.3 =

    59 * Use an XML Parser if possible

    60 * Proper import support for nav menus

    61 * ... and much more, see [Trac ticket #15197](http://core.trac.wordpress.org/ticket/15197)

    62 

    63 = 0.1 =

    64 * Initial release

    65 

    66 == Upgrade Notice ==

    67 

    68 = 0.6 =

    69 Support for exports from WordPress 3.4.

    70 

    71 = 0.5.2 =

    72 Fix incorrect error message when the export file could not be uploaded.

    73 

    74 = 0.5 =

    75 Import comment meta and other minor bugfixes and enhancements.

    76 

    77 = 0.4 =

    78 Bug fixes for attachment importing and other small enhancements.

    79 

    80 = 0.3 =

    81 Upgrade for a more robust and reliable experience when importing WordPress export files, and for compatibility with WordPress 3.1.

    82 

    83 == Frequently Asked Questions ==

    84 

    85 = Help! I'm getting out of memory errors or a blank screen. =

    86 If your exported file is very large, the import script may run into your host's configured memory limit for PHP.

    87 

    88 A message like "Fatal error: Allowed memory size of 8388608 bytes exhausted" indicates that the script can't successfully import your XML file under the current PHP memory limit. If you have access to the php.ini file, you can manually increase the limit; if you do not (your WordPress installation is hosted on a shared server, for instance), you might have to break your exported XML file into several smaller pieces and run the import script one at a time.

    89 

    90 For those with shared hosting, the best alternative may be to consult hosting support to determine the safest approach for running the import. A host may be willing to temporarily lift the memory limit and/or run the process directly from their end.

    91 

    92 -- [WordPress Codex: Importing Content](http://codex.wordpress.org/Importing_Content#Before_Importing)

    93 

    94 == Filters ==

    95 

    96 The importer has a couple of filters to allow you to completely enable/block certain features:

    97 

    98 * `import_allow_create_users`: return false if you only want to allow mapping to existing users

    99 * `import_allow_fetch_attachments`: return false if you do not wish to allow importing and downloading of attachments

   100 * `import_attachment_size_limit`: return an integer value for the maximum file size in bytes to save (default is 0, which is unlimited)

   101 

   102 There are also a few actions available to hook into:

   103 

   104 * `import_start`: occurs after the export file has been uploaded and author import settings have been chosen

   105 * `import_end`: called after the last output from the importer