Good day, eh? Okay, READ this stuff, eh?

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.


Tools for the job

You gotta have :


Warning

LIKE, BACKUP YOUR DATA, EH?

Your blog. Your data. Your loss if it all goes like shit through a goose. Make a backup of the database AND a backup of all the WordPress files before you start the process below. I accept no responsibility for any loss of data, or for any spilled beer.

  1. Create a folder called "Full Backup" on your computer. Done? Beauty!
  2. Download ALL your WordPress files into this folder, and make sure your keg is in the cooler for later.
  3. Backup your database. Instructions to do this are here.

Prepare your files

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).

WordPress 1.5 - Beauty!

You gotta get it from http://wordpress.org/download
Unzip this on your computer, and then go to Tim Hortons for an extra-large-double-double and a honey dip. Once you're back, check your progress.
It should unzip into four folders and several files.
If it all unzips into one big folder full of files, delete them and unzip the download again. Check whichever program you use to unzip and make sure it maintains the folder structure, eh? otherwise you will hose your upgrade!

Now, you gotta move those files you were just editing into this new download. It's easier than falling on your ass while skating on a pond.

  1. Open the wordpress download
  2. Open the folder called "wp-content"
  3. See a folder called "themes" ? Open it
  4. You have a folder called "Carrots". Copy that folder into "themes". (In that folder you should now be seeing 3 folders - Default, Classic and Carrots)
  5. Close themes, close wp-content. You should see the 4 folders (wp-content, wp-images, wp-admin, wp-includes) and a list of files. Copy your wp-config.php here.

Your 1.5 upload is about ready to go - time for another honey dip and a sip of that Elixir of Life from Timmy's!

  1. Open the WordPress download
  2. Open the folder called "wp-content"
  3. See a folder called "plugins" ? Open it and delete what is in it.
  4. You have a folder called "My Plugs" (or "My Beer"). Copy everything from that folder into the plugins folder.
  5. Close the folders, and wipe the sticky stuff off of your fingers from the donuts you've been eating.

The folder wp-images has not changed since 1.2 Mingus. You don't gotta upload this if you are upgrading, and can delete this folder from the 1.5 download if you want.


The actual upgrade #1

  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:

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!


The actual upgrade #2

  1. Upload the /wp-admin directory.
  2. Upload the /wp-includes directory.
  3. Upload the /wp-content directory.
  4. Leave your /wp-images directory alone.
  5. Upload all other files that came with the 1.5 download

Check that none of the uploaded files have a size of 0 (zero). If they do, re-upload that file, 'cause a zero file size is like an instigator penalty with a game misconduct!


Upgrade !

Using your browser, check out the upgrade script that you just uploaded to your site. It will usually be located somewhere like this:
www.example.com/wp-admin/upgrade.php
or
www.example.com/wordpress/wp-admin/upgrade.php (where 'wordpress' is the name of your blog directory).

Beauty! New Site !

Scroll down for a mini-FAQ and a good poutine recipe.


You will need to reactivate your plugins and put away all the empty cans of beer.


Use your ftp client to CHMOD any directories and your cell phone to order pizza.


Use your ftp client to CHMOD your .htaccess file to 664 and regenerate your rewrite rules by going to Options > permalinks (Thanks to Au Yong)


Your site will have switched to the new default style.
Click the "Presentation" tab at the top of the screen.
Now "Select" the theme called My original layout
Have a look at your blog - and smile like you just won game seven of the Stanley Cup!

Is anything hosed? Images maybe? You may have to edit style.css to get the image paths correct - you can do this through the Theme editor (it's just under the main set of headings on the same page as the Themes list).


Clean up

You may have downloaded other files that you have changed a lot. If you just upload those and overwrite the new 1.5 code, you will get errors. If you want whatever changes you made, you will have to compare the new files and the old files and carefully make your changes.

Credits

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.


Mini FAQ

Bonus - Where are the themes at?

If there is a README provided with the themes, then don't be a hoser...READ IT, EH?

Terms of use, and other themes may be found on the WordPress Codex and in this Forum thread.


 

These pages are independent of http://wordpress.org
All design, content & images © Mark 2004-2015. All rights reserved.