Okay, like, a lot of work has gone into making the upgrade process as smooth as possible for you, eh? and it does work. We drank a two-four of Canadian doin' this. So, it works, eh? Really. Just do EXACTLY what is listed here and it will be slicker than fresh ice at a hockey game. Don't skip stuff, eh? or think that you know better - you'll just end up frustrated and posting to the forums, and then a big-assed moose will like, tapdance all over you, eh?

Read this first and if you are unsure, post questions to the forums, eh? Not the Montreal Forum, though, 'cause like, they tore it down. Just post to the WordPress forum. It is easier to get things right than fix a mistake you have made because you weren't skating clockwise instead of not-clockwise.

You gotta have :

• Time. Do not do this when you are tired, like after a triple-overtime Stanley Cup game or in a rush.
• FTP client.
• Text editor. Do NOT use a wordprocessor for anything here. WordPad (PC) BBEdit (Mac) are fine. Do NOT use Dreamweaver or Adobe GoLive either.
• Beer.

On your desktop, create a new folder called "WP files". Into this, download the following files (yeah, I know you've downloaded them once, eh? but you need to do this, eh?)

1. index.php
2. wp-comments.php
3. wp-comments-popup.php
4. wp-config.php
5. wp-layout.css
6. IF you use Kubrick, also download kubrick-searchform.php

Also download any other files which you have, like, changed a lot, eh? - an example would be vars.php if you have changed smilies. Smilies are what you get when you show up to your buddy's house to watch the playoffs and YOU bring the brew!
Your backup is just that - a backup - and these files will become altered which is why the double download. So, take off, eh?

Now you gotta download a few more files. Kinda like you need more back bacon with your oeufs in the morning, eh? On your desktop, create a new folder called "My Beer " (or "My Plugs"). Okay, hoser, now download all your plugins and all other folders that may be inside your plugins directory on your site.

Adjust your files #1

The following changes are needed so that your current layout is carried through into the upgraded blog. Do all of this using the files you downloaded seperately, so that your upgrade will be sweeter than a natural hattrick in the All-star game!

1. Open your index.php in your text editor.
   • Comment out the wp-blog-header require line at the top of index.php. Do this by putting // at the start of each line.

     <?php
     //* Don't remove this line. */
     //require('./wp-blog-header.php');
     ?>

   • Update the stylesheet import line in index.php. Replace this:
     @import url( <?php echo get_settings('siteurl'); ?>/wp-layout.css );
     with this:
     

     @import url( <?php bloginfo('stylesheet_url'); ?> );

   • IF you use Kubrick, you will have a line like this:
     <link rel="stylesheet" href="<?php echo get_settings('siteurl'); ?>/wp-layout.css" type="text/css" media="screen" />
     you must change that to this (for Kubrick layouts only remember):
     

     <link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>" type="text/css" media="screen" />

   • Update the wp-comments include line in index.php. Replace this:
     <?php include(ABSPATH . 'wp-comments.php'); ?>
     with this:
     

     <?php comments_template(); ?>

   • Now save index.php
   • Rename wp-comments.php to comments.php
   • Open wp-comments-popup.php. Find this line at the top : require ('wp-blog-header.php');
     You gotta comment out that line:

     // require ('wp-blog-header.php');

     The top of your wp-comments-popup.php must look like this:

     <?php
     /* Don't remove these lines. */
     $blog = 1;
     //require ('wp-blog-header.php');
     add_filter('comment_text', 'popuplinks');
     

     Save the file, and shotgun another brew. Hopefully you still have some cold ones left in the fridge.
   • Rename wp-comments-popup.php to comments-popup.php
   • Add a theme header to wp-layout.css. Something like this, eh? (you can just copy and paste this for now):
     

     /*
     Theme Name: My Original layout
     Theme URI: http://myblog.com/
     Description: Your theme
     Version: 1
     Author: You and 24 beer
     Author URI: http://myblog.com/
     */

   • Now rename wp-layout.css to style.css.
2. You should now have 6 files:
   1. index.php
   2. comments.php
   3. comments-popup.php
   4. style.css
   5. wp-config.php
   6. IF you use Kubrick, you will have 6 files - kubrick-searchform.php
3. Now create a folder called "Carrots" and put the first 4 files there into that folder (and searchform.php if you use Kubrick).

1. Login to your admin panel and DEACTIVATE every plugin. (This is VERY important, so don't hose it, eh?!)
2. Leave your /wp-images directory alone.
3. DELETE the /wp-admin directory.
4. DELETE the /wp-includes directory.
5. DELETE the /wp-content directory.

Now delete all these WP files. All of them. If you have 1.2, 1.2.1 or 1.2.2 then here is a list of what needs deleting:

• index.php
• print.css
• wp-atom.php
• wp-blog-header.php
• wp-comments-popup.php
• wp-comments-post.php
• wp-comments-reply.php
• wp-comments.php
• wp-commentsrss2.php
• wp-feed.php
• wp-layout.css
• wp-links-opml.php
• wp-locations.php
• wp-login.php
• wp-mail.php
• wp-pass.php
• wp-rdf.php
• wp-register.php
• wp-rss.php
• wp-rss2.php
• wp-settings.php
• wp-trackback.php
• wp.php
• xmlrpc.php

If you just overwrite files, you WILL get errors. Probably a whole lot of them. DELETE instead and then you can crack open another can of frosty Canadian!

Specifically for this guide, the following people should be thanked:
Ryan Boren - not only for writing lots of code in the first place, but for providing the skeleton guide from which this page has arisen.
And everyone here has helped by volunteering their time (in response to a post on my blog) by testing this guide, pointing out gaps, making suggestions and otherwise helping so that your WordPress upgrade is made as smooth as possible. In alpha order, they are: |Memo|, AJ, Bryan, ch3wbacca, Charlie, Cyndy, Gary, Shadow, SLH, Terry and the brewers of Canada, along with the Tim Hortons corporation, makers of the finest coffee and donuts in this universe.