Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

executable file 250 lines (180 sloc) 11.815 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250
=== e107 Importer ===
Contributors: Coolkevman
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XEXREDEHXSQUJ
Tags: importer, e107, cms, migration, bbPress
Requires at least: 3.1
Tested up to: 3.1.2
Stable tag: 1.3
License: GPLv2

e107 import plugin for WordPress.

== Description ==

This plugin allows you to extract the most important content and data from an e107 CMS instance and import them into your WordPress blog.

**Features**:

* Import news (both body and extended parts).
* Import news categories.
* Import custom pages (and take care of their private / public visibility).
* Import comments (both from news and custom pages).
* Import forums and threads to bbPress WordPress plugin.
* Import images embedded in HTML as attachments.
* Let you choose which kind of images you want to upload to WordPress (external or not).
* Import preferences (site name, description, ...).
* Import new users and their profile (or update existing users).
* Send new credentials to users by mail.
* Try to map users to an appropriate role.
* Convert embedded BBCode to plain HTML.
* Clean-up HTML to align it with what WordPress produce by default.
* Redirect old e107 news, pages, users, forums, threads and feeds URLs to new WordPress content via an integrated plugin (for SEO).
* Replace old e107 URLs in content by new WordPress permalinks.

This tool was tested with:

* [e107 0.7.25](http://e107.org/news.php?item.880),
* [WordPress 3.1.2](http://wordpress.org/news/2011/04/wordpress-3-1-2/) and
* [development version of bbPress WordPress plugin (SVN r3113)](http://trac.bbpress.org/browser/branches/plugin?rev=3113)

If you have any older versions, please upgrade first.

== Installation ==

1. Upload the `e107-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 e107

== Frequently Asked Questions ==

= What is the status of this plugin ? =

This plugin is currently actively developed and maintained.

I have personal e107 sites to migrate, and as long as I have these migrations to do, I will not officially declare my plugin dead and unmaintained. But be careful: the day I've got rid of of all my e107 personal sites, I'll stop developing this plugin.

= Why the import process fail, or do not end well ? =

While importing content from e107, you may encounter one of the following error:

* *Internal Server Error*
* *MySQL has gone away*
* *PHP Fatal error: Maximum execution time exceeded*

These means that the script has failed one way or another.

Generally, this is due to constraints set by your hosting provider, limiting the execution time of PHP scripts. This issue affect all scripts consuming lots of CPU and memory resources, like all import scripts.

The issue and [solutions are detailed in WordPress FAQ](http://codex.wordpress.org/FAQ_Working_with_WordPress#How_do_I_Import_a_WordPress_WXR_file_when_it_says_it_is_too_large_to_import.3F), please read this article before complaining to me.

= Can I import content step by step ? =

Yes, you can. I designed this plugin to let you have the opportunity to import one kind of content at a time. So you should be able to import news first, then re-run the importer process to only import pages, then do it again for forums and so on...

= Why accents in my imported content are replaced by strange characters ? =

Looks like you have some kind of Unicode transcoding errors. Before running e107 Importer, your e107 site must be fully encoded in UTF-8. If it's not the case, please have a look at the [*Upgrading database content to UTF-8*](http://wiki.e107.org/?title=Upgrading_database_content_to_UTF8) article on e107 wiki.

= Can you add import of e107 forums to BuddyPress and bbPress ? =

This plugin currently import forums to bbPress. But [the WordPress plugin version](http://wordpress.org/extend/plugins/bbpress/), not [the standalone version](http://bbpress.org/). I also don't plan to support [BuddyPress](http://buddypress.org/) forums. I'm only interested in the bbPress plugin as it currently has features I'm interested in.

I'm still happy to add support of the two others if you have code to contribute.

= Why profanities show up in imported content ? =

This plugin ignore the configuration of the profanity filter from e107. If you want to hide words, it should be done by a dedicated WordPress plug-in. As [suggested by Jon Freger](http://kevin.deldycke.com/2006/11/wordpress-to-e107-v06-better-content-rendering-and-extended-news-support/#comment-2937), you can use the [WebPurify plugin](http://wordpress.org/extend/plugins/webpurifytextreplace).

= Why links generated by e107's Linkwords plugin are not preserved ? =

This plugin disable all extra HTML rendering hooks added by e107 plugins. Which means Linkwords plugin will be ignored while rendering imported content. So as for profanities (see above), you have to use a third-party WordPress plugin to apply Linkwords-like transformations to your imported content.

= Can I give you money to fix my problem ? =

That's nice from you to propose a donation but quite frankly, money is not the kind of incentives that will push the development of my plugins. But code, bug reports and testing is the kind of contributions I'm looking for. In fact getting rid of my old e107 instances is the best motivator I have. But by popular demand, here is my [donation link](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XEXREDEHXSQUJ) anyway...

= Where can I report bugs ? =

Bug reports and feature requests must be done via [GitHub's ticket system](http://github.com/kdeldycke/e107-importer/issues).

= Can I update the plugin ? =

That's nice from you to propose to update it. All contributions are welcome ! I'll be happy to apply all your patches in the original code to let anyone benefits your work. Even after I will declare this plugin dead.

= How can I contribute code ? =

Feel free to send me patches and code by mail. Or better yet, use GitHub fork/merge features.

= Where can I find the source code ? =

Development of this plugin happen in a [dedicated GitHub repository](http://github.com/kdeldycke/e107-importer). The latter is the official repository of this plugin. All developments are done there. This repository is the reference repository.

FYI, this plugin is [also hosted on WordPress plugins' Subversion](http://plugins.svn.wordpress.org/e107-importer), but this repository is just a copy of GitHub's. **No original development should be performed in the Subversion repository**: changes made there will be ignored and deleted if not mirrored in the GitHub repository.

== Screenshots ==

1. e107 Importer options. (e107-importer 1.3)

== Tested with... ==

Here is a list of e107 and WordPress versions I tested my plugin with:

* e107-importer 1.4 : e107 0.7.25 / WordPress 3.1.2 / bbPress plugin SVN r3113
* e107-importer 1.3 : e107 0.7.25 / WordPress 3.1.2 / bbPress plugin SVN r3113
* e107-importer 1.2 : e107 0.7.25-rc1 / WordPress 3.1 / bbPress plugin SVN r2992
* e107-importer 1.1 : e107 0.7.24 / WordPress 3.1 / bbPress plugin SVN r2942
* e107-importer 1.0 : e107 0.7.24 / WordPress 3.1-RC3
* e107-importer 0.9 : e107 0.7.11 / WordPress 2.3.2
* e107-importer 0.8 : e107 0.7.8 / WordPress 2.1.3
* e107-importer 0.7 : e107 0.7.8 / WordPress 2.1.2
* e107-importer 0.6 : e107 0.7.6 / WordPress 2.0.5
* e107-importer 0.5 : e107 0.7.5 / WordPress 2.0.5
* e107-importer 0.4 : e107 0.7.5 / WordPress 2.0.4
* e107-importer 0.3 : e107 0.7.5 / WordPress 2.0.4

== Copyright notice ==

This plugin contain original code from the e107 project, licensed under the GPL.

== Changelog ==

= 1.4 =

No changes yet.

= 1.3 =
* Upgrade embedded e107 code with latest 0.7.25.
* Redirect imported images to attachments.
* Purge invalid mapping entries on import.
* Replace old e107 URLs in content by new WordPress permalinks.
* Allow both imported and already-existing content to by updated with new permalinks.
* Let user specify the list of e107 forums to import.
* Phased imports should work without major problems.

= 1.2 =
* Upgrade e107 code to match latest 0.7.25-rc1.
* Fix variable bleeding when importing items in batches.
* Add a new way of handling e107 extended news using WordPress' excerpts.
* Parse BBCode and replace e107 constants in news excerpt.
* Use internal WordPress library (kses) to parse HTML in the image upload step.
* Do not upload the same images more than once.
* Add a new enhanced BBCode parser on top of the one from e107. Make it the default parser.
* Each time we alter the original imported content, we create a post revision.

= 1.1 =
* Add import of forums and threads to bbPress WordPress plugin.
* Parse BBCode and e107 constants in forums and thread.
* Add forums and threads redirections.
* Make e107 user import optional. This needs you to set a pre-existing WordPress user that will take ownership of all imported content.
* Parse BBCode in titles too.
* Import images embedded in comments and forum threads.
* Description update of existing users is no longer destructive.
* Add an entry in the FAQ regarding script ending prematurely.
* Disable all extra HTML rendering hooks like the one coming from e107 linkwords plugin.
* Allow news and pages import to be skipped.
* Add missing news category redirects.
* Minimal requirement set to WordPress 3.1.
* Some pages are not tied to a user. In this case, default to the current user.

= 1.0 =
* Upgrade e107 code from e107 v0.7.24.
* Minimal requirement set to WordPress 3.0.0.
* Use new WordPress importer framework.
* Add an e107 to WordPress 301 redirector plugin (support news, pages, users and feeds).
* Disable the URL rewriting feature introduced in v0.9.
* Make image import optional.
* Add an option to upload images from allowed domains only.
* Align naming conventions with other WordPress importer.
* Add a complete WordPress plugin hosting compatible readme file with full metadatas.
* Add screenshots.
* List all versions of e107 and WordPress I tested this plugin with.
* Add a PayPal donation link.
* Add a minimal FAQ.
* Add an overview of features in description.
* Update source code repository location.
* Remove patching of Kubrick theme to support comments on static pages.

= 0.9 =
* "One-click migration" instead of multiple step process (more user-friendly).
* Better error management (a must-have for precise bug reports).
* Replace all links to old content with permalinks (increased SEO).
* Better database management.
* Code cleaned up.

= 0.8 =
* Import images embedded in e107 news and custom pages.
* Import e107 site preferences.
* Better import of user profile data.
* An existing user on the blog can be detected and updated automatically.
* Fix the profanity filter bug.

= 0.7 =
* Import e107 news categories.
* Mails can be sent to each user to warn them about their new password.
* Static pages can be set as private.
* Simplify the import process.
* Some little UI improvements.

= 0.6 =
* Render content according user's preferences.
* Take care of extended news.

= 0.5 =
* Add import of static pages.

= 0.4 =
* Fix lots of bugs, especially due to non-escaped SQL queries.
* Import news comments and link them to users.

= 0.3 =
* Import all users and associate them with their posts.

= 0.2 =
* Add BBCode support to news content.

= 0.1 =
* First draft of e107 to WordPress importer.

== Upgrade Notice ==

= 1.3 =
Upgraded against e107 0.7.25. Replace old e107 URLs by permalinks in content. Allow phased import.

= 1.2 =
Upgraded against e107 0.7.25-rc1. Add new enhanced BBCode parser.

= 1.1 =
Add import of forums and threads. User, news and pages import now optional.

= 1.0 =
First release compatible with the WordPress 3.x series.
Something went wrong with that request. Please try again.