readme.txt 4.08 KB
Newer Older
root's avatar
root committed
1
2
3
4
5
=== Plugin Name ===
Contributors: wordpressdotorg
Donate link: 
Tags: importer, wordpress
Requires at least: 3.0
lucha's avatar
lucha committed
6
7
Tested up to: 3.4
Stable tag: 0.6
root's avatar
root committed
8
9
10
11
12

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

== Description ==

shammash's avatar
shammash committed
13
14
15
16
17
18
19
20
21
The WordPress Importer will import the following content from a WordPress export file:

* Posts, pages and other custom post types
* Comments
* Custom fields and post meta
* Categories, tags and terms from custom taxonomies
* Authors

For further information and instructions please see the [Codex page on Importing Content](http://codex.wordpress.org/Importing_Content#WordPress)
root's avatar
root committed
22
23
24

== Installation ==

shammash's avatar
shammash committed
25
26
27
28
29
30
31
32
33
The quickest method for installing the importer is:

1. Visit Tools -> Import in the WordPress dashboard
1. Click on the WordPress link in the list of importers
1. Click "Install Now"
1. Finally click "Activate Plugin & Run Importer"

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

root's avatar
root committed
34
35
36
37
38
39
1. Upload the `wordpress-importer` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go to the Tools -> Import screen, click on WordPress

== Changelog ==

lucha's avatar
lucha committed
40
41
42
43
44
45
46
47
= 0.6 =
* Support for WXR 1.2 and multiple CDATA sections
* Post aren't duplicates if their post_type's are different

= 0.5.2 =
* Double check that the uploaded export file exists before processing it. This prevents incorrect error messages when
an export file is uploaded to a server with bad permissions and WordPress 3.3 or 3.3.1 is being used.

shammash's avatar
shammash committed
48
49
50
51
52
53
54
55
56
57
= 0.5 =
* Import comment meta (requires export from WordPress 3.2)
* Minor bugfixes and enhancements

= 0.4 =
* Map comment user_id where possible
* Import attachments from `wp:attachment_url`
* Upload attachments to correct directory
* Remap resized image URLs correctly

root's avatar
root committed
58
59
60
= 0.3 =
* Use an XML Parser if possible
* Proper import support for nav menus
shammash's avatar
shammash committed
61
* ... and much more, see [Trac ticket #15197](http://core.trac.wordpress.org/ticket/15197)
root's avatar
root committed
62
63
64
65
66
67

= 0.1 =
* Initial release

== Upgrade Notice ==

lucha's avatar
lucha committed
68
69
70
71
72
73
= 0.6 =
Support for exports from WordPress 3.4.

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

shammash's avatar
shammash committed
74
75
76
77
78
79
= 0.5 =
Import comment meta and other minor bugfixes and enhancements.

= 0.4 =
Bug fixes for attachment importing and other small enhancements.

root's avatar
root committed
80
= 0.3 =
root's avatar
root committed
81
Upgrade for a more robust and reliable experience when importing WordPress export files, and for compatibility with WordPress 3.1.
root's avatar
root committed
82

shammash's avatar
shammash committed
83
84
85
86
87
88
89
90
91
92
93
== Frequently Asked Questions ==

= Help! I'm getting out of memory errors or a blank screen. =
If your exported file is very large, the import script may run into your host's configured memory limit for PHP.

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.

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.

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

root's avatar
root committed
94
95
96
== Filters ==

The importer has a couple of filters to allow you to completely enable/block certain features:
shammash's avatar
shammash committed
97

root's avatar
root committed
98
99
100
* `import_allow_create_users`: return false if you only want to allow mapping to existing users
* `import_allow_fetch_attachments`: return false if you do not wish to allow importing and downloading of attachments
* `import_attachment_size_limit`: return an integer value for the maximum file size in bytes to save (default is 0, which is unlimited)
shammash's avatar
shammash committed
101
102
103
104
105

There are also a few actions available to hook into:

* `import_start`: occurs after the export file has been uploaded and author import settings have been chosen
* `import_end`: called after the last output from the importer