tricks/mt2drupal/README.txt

Readme
------
This is a script that will export MovableType database to Drupal database.

This will migrate 

  a) all your bloggers
  b) all your defined categories
  c) all your entries (including body, excerpt, extended, formatting rules)
  d) all your comments (with anonymous support if you have)
  e) all incoming trackbacks (store as comments)
  f) all your outgoing trackbacks (drupal 4 bloggers only)
  g) all your trackbacks trackers (drupal 4 bloggers only)
  h) keep all your path into url_alias, including your RSS feed URLs

Note: 
  1) Bloggers migrated are disabled by default. You must unblock their
     accounts after migration. Edit the account (administer->accounts)
     and then set the account's status to 'Active'.

  2) At this moment, only MySQL is supported.

  3) You need to enable 'path' module and also Clean URL in order to preserve
     the permalink of your MT in Drupal

     To enable path module, goto administer->configuration->modules
     To enable Clean URL, goto administer->configuration

  4) Trackback module is not needed for the porting but would be a useful 
     module for you to install anyway.

Usage
-----

0. IMPORTANT: This script must resides in your MT directory (see Step 3)

1. Setup your Drupal and make sure that you

   a) Setup your first account
   b) enabled blog module (administer-configuration->modules)
   c) create a vocabulary that is attached to blog
      (see http://drupal.org/book/view/299)

2. Edit mt-to-drupal.cgi and configure the following settings

   a) $blog_id 

   If you don't know your blog_id, login to MT and check your URL
   e.g.
      http://your.mt.installation/mt.cgi?__mode=menu&blog_id=1
                                                     ^^^^^^^^^

   b) $mode

   If you are migrating to Drupal 4 Bloggers, then use $mode = 0;
   If you are migrating to Drupal 4.4.1, then use $mode = 1;
   If you are migrating to Drupal CVS HEAD, then use $mode = 2;

   c) $timezone

   Set your timezone, between -12 to +12

   d) Configure your MySQL Database settings
        $db_host, $db_database, $db_user, $db_pass
        host, database, username, password respectively.

      If you don't know, consult your includes/conf.php
        http://user:password@localhost/database

3. Put mt-to-drupal.cgi into your MT directory.

   This should be in the same directory level as mt.cgi

   e.g. /home/userid/html/mt/mt-to-drupal.cgi or
        /home/userid/cgi-bin/mt-to-drupal.cgi

4. Point your browser to http://your.blog/mt-directory/mt-to-drupal.cgi

   e.g. http://abc.blog.com/mt/mt-to-drupal.cgi   or
        http://abc.blog.com/cgi-bin/mt-to-drupal.cgi

5. Enjoy your new Drupal!
1	Readme
2	------
3	This is a script that will export MovableType database to Drupal database.
4
5	This will migrate
6
7	a) all your bloggers
8	b) all your defined categories
9	c) all your entries (including body, excerpt, extended, formatting rules)
10	d) all your comments (with anonymous support if you have)
11	e) all incoming trackbacks (store as comments)
12	f) all your outgoing trackbacks (drupal 4 bloggers only)
13	g) all your trackbacks trackers (drupal 4 bloggers only)
14	h) keep all your path into url_alias, including your RSS feed URLs
15
16	Note:
17	1) Bloggers migrated are disabled by default. You must unblock their
18	accounts after migration. Edit the account (administer->accounts)
19	and then set the account's status to 'Active'.
20
21	2) At this moment, only MySQL is supported.
22
23	3) You need to enable 'path' module and also Clean URL in order to preserve
24	the permalink of your MT in Drupal
25
26	To enable path module, goto administer->configuration->modules
27	To enable Clean URL, goto administer->configuration
28
29	4) Trackback module is not needed for the porting but would be a useful
30	module for you to install anyway.
31
32	Usage
33	-----
34
35	0. IMPORTANT: This script must resides in your MT directory (see Step 3)
36
37	1. Setup your Drupal and make sure that you
38
39	a) Setup your first account
40	b) enabled blog module (administer-configuration->modules)
41	c) create a vocabulary that is attached to blog
42	(see http://drupal.org/book/view/299)
43
44	2. Edit mt-to-drupal.cgi and configure the following settings
45
46	a) $blog_id
47
48	If you don't know your blog_id, login to MT and check your URL
49	e.g.
50	http://your.mt.installation/mt.cgi?__mode=menu&blog_id=1
51	^^^^^^^^^
52
53	b) $mode
54
55	If you are migrating to Drupal 4 Bloggers, then use $mode = 0;
56	If you are migrating to Drupal 4.4.1, then use $mode = 1;
57	If you are migrating to Drupal CVS HEAD, then use $mode = 2;
58
59	c) $timezone
60
61	Set your timezone, between -12 to +12
62
63	d) Configure your MySQL Database settings
64	$db_host, $db_database, $db_user, $db_pass
65	host, database, username, password respectively.
66
67	If you don't know, consult your includes/conf.php
68	http://user:password@localhost/database
69
70	3. Put mt-to-drupal.cgi into your MT directory.
71
72	This should be in the same directory level as mt.cgi
73
74	e.g. /home/userid/html/mt/mt-to-drupal.cgi or
75	/home/userid/cgi-bin/mt-to-drupal.cgi
76
77	4. Point your browser to http://your.blog/mt-directory/mt-to-drupal.cgi
78
79	e.g. http://abc.blog.com/mt/mt-to-drupal.cgi or
80	http://abc.blog.com/cgi-bin/mt-to-drupal.cgi
81
82	5. Enjoy your new Drupal!