These instructions apply to upgrading any prior release of Bloo (alpha and beta releases included) to Bloo version 1.00. To go from an alpha or beta release to any release of Bloo above version 1.00, you have to first upgrade to version 1.00. You can find that release here.

Instructions for upgrading
Note: if upgrading from a release prior to Bloo Beta Two (1.00.b.002), see the section below entitled "If upgrading from a version prior to Beta Two"

1. It's a pretty good idea to backup your MySql database and all the code in the directory and subdirectories on your webserver where Bloo lives. You don't have to, but depends on if you feel lucky, punk. :-)
   
   
2. Delete the snapons directory on your webhost where the previous version of Bloo lived. You can leave other directories alone (such as the themes and extensions directories). If you don't want to delete the snapons directory that's ok, but it is no longer used by the Bloo system, having been replaced by the "core" directory.
   
   
3. Upload all the files in this release to the directory on your webhost where Bloo lives.
   
   
4. Run the bloo.upgrade.php program in the root directory of Bloo on your webhost. You will be asked for the administrator userid and password for your blog, which you should know if you're doing this.
   
   
5. If there are any problems with the upgrade (note: from a database perspective it's non-destructive so you won't lose anything) please note the reported error messages in the Bloo Feedback Page, and we'll see if we can help out.

Notes of Interest

• This version provides for a comments RSS feed. If you have customized your Page.sidebar overlay, it will not have the link to the comments RSS feed. You can add this feed to the sidebar by doing the following: edit your Page.sidebar overlay (go to the Look and Feel menu, Overlays, Overlay category: Custom, and select the edit link on Page.sidebar) and make the following change:

Change

=|RSS20.link|=

to

=|RSS20.link|=

=|RSS20.comments.link|=

• This version provides for a trackback sender. If you have customized the Post.header overlay (to change the look of your posts) and you want the Trackback Send to be available to you, edit the Post.header overlay (go to the Look and Feel menu, Overlays, Overlay Category: Post, and select the edit link on Post.header) and make the following change:

Change

_{EditPostLink}_ _{DeletePostLink}_


to

_{EditPostLink}_ _{DeletePostLink}_ _{TrackbackSendLink}_

If upgrading from a version prior to Beta Two
If you are upgrading from the a release previous to Beta Two (version 1.00.b.002), follow the instructions below. Beta Two had a lot of changes in it so the upgrade for it is slightly more involved:

1. Back up everything, as described in step 1, above.
   
   
2. Make a record of all Extension SnapOns that are currently enabled
   
   
3. If you didn't do the optional code/image backup mentioned in step 1, backup any themes that you have created on the filesystem (note: if you created them through Bloo, don't worry, they are stored in the db and are safe). Any themes that were created on the filesystem, rather than within Bloo, have to be converted to the Bloo beta 2 format, since the naming convention and descriptor format for SnapOns was changed in this version. Note: if you're not sure that you've created any filesystem-based themes, you probably haven't.
   
   
4. Delete the contents of the extensions folder, including all subfolders. If you've created your own extensions, you need to make sure that you've backed them up first. They will not work with the new version of Bloo (Bloo Beta 2) without conversion. We can help you convert them, just let us know what you need by going to the Bloo Feedback Page and sending us the details.
   
   
5. Delete the contents of the install folder
   
   
6. Delete the scripts folder (if it exists)
   
   
7. Delete the snapons folder
   
   
8. Delete the contents of the themes folder
   
   
9. Upload all the files in the new release to the directory on your webhost where Bloo lives.
   
   
10. Run the bloo.upgrade.php program in the root directory of Bloo on your webhost. You will be asked for the administrator userid and password for your blog, which you should know if you're doing this.
    
    
11. Re-activate all Extension SnapOns that were recorded as activated in step 2 (you did write them down, didn't you?). You might want to check the Bloo Release Notes to see what new Extension SnapOns are available in the new release.
    
    
12. If there are any problems with the upgrade please note the reported error messages in the Bloo Feedback Page, and we'll see if we can help out.

You also might find it helpful to visit the Bloo development blog.