Preparing for release 0.3.0

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ./
   specs:
-    refinerycms-wordpress-import (0.2.0)
+    refinerycms-wordpress-import (0.3.0)
       bundler (~> 1.0)
       nokogiri (~> 1.4.4)
       refinerycms (~> 1.0.0)

README.rdoc

@@ -4,10 +4,7 @@ This litte project is an importer for WordPress XML dumps into refinerycms(-blog
 
 You can find the source code on github: https://github.com/mremolt/refinerycms-wordpress-import
 
-Keep in mind, this gem imports blog posts and pages, NOT the media files, as they are not
+Keep in mind that links to other pages of your blog are just copied, as WordPress exports them as <a>-Tags. 
-part of the XML dump! You have to manually readd them to Refinery. 
-
-The same goes for links to other pages on your site. WordPress exports them just as <a>-Tags. 
 If your site (blog) structure uses new urls, the links WILL break! For example, if you used 
 the popular WP blog url structure "YYYY-MM/slug", be warned that Refinery just uses "blog/slug". 
 So your inner site links will point to the old WP url. 
@@ -84,6 +81,39 @@ If you want to clean the tables and import in one task:
 
   rake wordpress:reset_and_import_pages[file_name]
 
+Finally, if you want to reset and import all data including media (see below):
+
+  rake wordpress:full_import[file_name]
+
+
+== Importing media files
+
+The WP XML dump contains absolute links to media files linked inside posts, like:
+
+http://www.mysite.com/wordpress/wp-content/uploads/2011/05/cv.txt
+
+The dump does NOT contain the files itself! To get them imported, this gem downloads the files 
+from the given URL and imports them to refinery. So for a working media import the old site with
+the media URLs must still be online. 
+
+After importing the files, this gem replaces the old links in pages and blog posts with the 
+new generated ones. It parses all existing records searching for the right pattern. That
+means, you have to import pages and posts FIRST to get the URLs replaced. 
+
+Now to the rake tasks for media import: 
+
+  rake wordpress:reset_media
+
+This task deletes all data from the media tables (images and resources), ensuring a clean import.
+
+  rake wordpress:import_and_replace_media[file_name] 
+
+This task imports all the WordPress media into Refinery. After the import it parses all
+pages and blog posts, replacing the legacy links with the current refinery ones.
+
+If you want to clean the tables and import in one task:
+
+  rake wordpress:reset_import_and_replace_media[file_name] 
 
 == Usage on ZSH
 

refinerycms-wordpress-import.gemspec

@@ -4,8 +4,8 @@ Gem::Specification.new do |s|
   s.name        = "refinerycms-wordpress-import"
   s.summary     = "Import WordPress XML dumps into refinerycms(-blog)."
   s.description = "This gem imports a WordPress XML dump into refinerycms (Page, User) and refinerycms-blog (BlogPost, BlogCategory, Tag, BlogComment)"
-  s.version     = "0.2.0"
+  s.version     = "0.3.0"
-  s.date        = "2011-06-05"
+  s.date        = "2011-06-13"
 
   s.authors     = ['Marc Remolt']
   s.email       = 'marc.remolt@googlemail.com'