OLD Manual

This page is about upgrading from version 0.8.9 to 0.9

Please see the instructions bundled with the distribution for general upgrade instructions and come back here once you have finished general upgrade.

Default skin

In some situations, you may get the following message after upgrade when trying to access a blog:

The default skin [custom] set for blog [blogname] does not exist. It must be properly set in the blog properties or properly overriden in a stub file. Contact the webmaster...

Just go to the blog's properties form, check the skin assigned by default and validate the properties (even if the default skin appears to be correct).

Upgrading your custom skin

Skin functions have changed significantly. Old calls will still work in 0.9 but they are not guaranteed on the long term. So you should think about doing a complete upgrade of your skins with a diff tool.

Anyway, below are the instructions for a minimal upgrade of your skins:

File changes

• There are files in the /skins directory. You must replace these, even if you want to continue using your old skin. Please note that _blogroll has been replaced by linkblog.

• In your skin's folder (/skin/yourskin):
• Delete the _blogroll file
• Copy a _linkblog file from a new skin

_main template

Here are the minimum changes you must do in your skin's _main.php template:

• Replace the code displaying the blogroll/linkblog with code from a new skin.

The new code to include the linkblog should look like:

<?php // -------------------------- LINKBLOG INCLUDED HERE -----------------------------
  require( dirname(__FILE__).'/_linkblog.php' );
// -------------------------------- END OF LINKBLOG ---------------------------------- ?>

• Replace the code displaying the stats with code from a new skin. The most important thing here, is to replace

<?php while($row_stats = mysql_fetch_array($res_stats)){  ?>

with

<?php if( count( $res_stats ) ) foreach( $res_stats as $row_stats ) { ?>

• For comments to work, replace:

<?php	// ------------------------------------ START OF POSTS ----------------------------------------
if( isset($MainList) ) while( $MainList->get_item() )

with

<?php	// ------------------------------------ START OF POSTS ----------------------------------------
if( isset($MainList) ) while( $Item = $MainList->get_item() )

About the Auto P plug-in

Version 0.9 ships with a plug-in called 'Auto-P' that will automatically add <p> tags to your posts.

While this is highly desirable in most situations, it may introduce some unwanted extra space in you linkblog link list.

There are two ways to deal with this:

• Edit each link in the list and uncheck "Auto P" in the "renderers" fieldset that you will find in th elower right of the edit form. (Recommended)
• Change the Auto P global $apply_when setting from "opt-out" to "opt-in". That way it will not be applied by default any more. (Not recommended).

Public blog list

If you display a blog list on your site and some of your hidden blogs reappear there after upgrade, go to admin -> Blogs -> The blog you want to hide -> Default display options and uncheck "Include in public blog list"