== 1.4.0 to 1.5.0 ==
Apply the patches in patch/ from the root of your Kitto install.
 
There are no database schema changes.
 
== 1.3.1 to 1.4.0 ==
Apply the patches in patch/ from the root of your Kitto install.
 
Be sure to update the external_libs/aphp folder to the latest version of aphp.
 
There are no database schema changes.
 
== 1.3.0.1 to 1.3.1 ==
Apply the following patches from the root of your Kitto install:
 
* 0001-Refactored-board-news-code-to-use-ActiveTable-s-sl.patch
* 0002-Refactored-pagination-in-the-inventory-to-use-the.patch
* 0003-Refactored-mail-code-to-work-with-ActiveTable-s-ne.patch
* 0004-Pagination-refactored.patch
 
Delete the external_libs/aphp folder in your Kitto install and upload
the updated version from this archive.
 
There are no database schema changes to be performed.
 
== 1.3.0 to 1.3.0.1 ==
 
Apply the following patches from the root of your Kitto install:
 
* patches/users_online-1.3.0.1.patch
 
== 1.2.2.4 to 1.3.0 ==
To upgrade from Kitto 1.2.2.4 to 1.3.0, run the following SQL:
 
    ALTER TABLE `user_item` ADD `quantity` INT UNSIGNED DEFAULT '1' NOT NULL ;
    ALTER TABLE `item_class` ADD `one_per_use` ENUM( 'N', 'Y' ) DEFAULT 'N' NOT NULL AFTER `verb` ;
 
    CREATE TABLE `board_category` (
      `board_category_id` INT NOT NULL AUTO_INCREMENT ,
      `category_name` VARCHAR( 50 ) NOT NULL ,
      `order_by` TINYINT DEFAULT '0' NOT NULL ,
      `required_permission_id` INT NOT NULL ,
      PRIMARY KEY ( `board_category_id` ) ,
      INDEX ( `required_permission_id` )
    ) TYPE = innodb;
 
    ALTER TABLE `board` ADD `board_category_id` INT NOT NULL AFTER `board_id` ;
    ALTER TABLE `board` ADD INDEX ( `board_category_id` ) ;
 
Then, upload the following changed/new files. If you have customized a file in 
this list, you will need to merge the changes. If you have not customized a 
file, it is recommended that you overwrite it with the updated version.
 
    -- New Art
    * resources/items/toys (created folder)
    * resources/items/paints (created folder)
    * resources/shopkeepers (created folder)
    
    -- Item stacking
    * includes/classes/inflectors (added folder with one file)
    * scripts/items/list.php (lines 65-66)
    * scripts/items/detail.php (large number of changes; advised to upload new 
      version)
    * scripts/shops/shop.php (lines 140-174)
    * includes/classes/item/item.class.php (modified #giveItem(), added: 
      #getInflectedName(), #makeActionText())
    * includes/classes/item/food_item.class.php (modified #feedTo())
    * includes/classes/item/toy_item.class.php (modified #playWith())
    * includes/classes/item/paint_item.class.php (modified #paint())
    * template/templates/items/details.tpl (quantity stuff added)
    * template/templates/items/list.tpl (quantity stuff added)
    * template/templates/items/give_form.tpl (quantity stuff added)
    * template/templates/items/use_form.tpl (quantity stuff added)
 
    -- Board Categories
    * includes/classes/board/board_category.class.php (new file)
    * includes/classes/board/board.class.php (added 47-52, added 59-65, 
      added 67-73. Modified #hasAccess())
    * scripts/boards/create_thread.php (added line 61)
    * scripts/boards/edit_post.php (added line 86)
    * scripts/boards/edit_thread.php (added line 76)
    * scripts/boards/post_list.php (added line 82)
    * scripts/boards/board_list.php (large change, advised to upload new copy) 
    * scripts/boards/thread_list.php (added line 84)
    * template/templates/boards/board_list.tpl (breadcrumb line)
    * template/templates/boards/thread_list.tpl (breadcrumb line)
    * template/templates/boards/edit_post.tpl (breadcrumb line)
    * template/templates/boards/edit_thread.tpl (breadcrumb line)
    * template/templates/boards/post_list.tpl (breadcrumb line)
    * template/templates/boards/new_thread.tpl (breadcrumb line)
 
    -- General
    * index.php (lines 97-111 modified)
    * includes/classes/classes.config.php (37-40 added, 84 added)
 
After that, check your boards. Each one must now be underneath a board_category.
Sample categories can be found in the db/data/board_category.sql file.
 
== 1.2.2.x to 1.2.2.4 ==
To upgrade an earlier 1.2.2.x release to 1.2.2.4, update the following files or
manually merge the changes:
 
    * index.php (line 143 changed)
    * includes/config.inc.php (line 189, the require for Log.php)
    * includes/classes/user/user_online.class.php (all static methods 
      changed to use #findBy()'s new counting abilities instead of running
      queries manually, one method added)
    * scripts/meta/search.php (lines 51-53 changed)
    * external_lib/aphp (whole folder)
 
== 1.2.2.1 or 1.2.2.2 to 1.2.2.3 ==
To upgrade an earlier 1.2.2 release to 1.2.2.3, update the following files:
 
    * captcha.php
    * scripts/user/register.php (line 64 modified).
    * scripts/user/forgot_password.php (line 66 modified).
 
== 1.2.2.1, 1.2.2.2 ==
Both of these releases contained insignificant updates. 1.2.2.1 corrected
an error in the db/mysql4_ddl.sql file, and 1.2.2.2 was targetted towards
making installation easier.
 
== 1.2.1 to 1.2.2.0 ==
To upgrade from Kitto 1.2.1 to 1.2.2, run the following SQL:
 
    -- Create the new table required.
    CREATE TABLE `user_online` (
    `user_online_id` INT NOT NULL AUTO_INCREMENT ,
    `user_type` ENUM( 'user', 'guest' ) DEFAULT 'guest' NOT NULL ,
    `user_id` INT NOT NULL ,
    `client_ip` VARCHAR( 15 ) NOT NULL ,
    `client_user_agent` VARCHAR( 255 ) NOT NULL ,
    `datetime_last_active` DATETIME NOT NULL ,
    PRIMARY KEY ( `user_online_id` ) ,
    INDEX (`user_id`),
    INDEX (`client_ip`),
    ) TYPE = memory;
 
    -- Add a new column for holding the user preference in.
    ALTER TABLE `user` ADD `show_online_status` ENUM( 'Y', 'N' ) DEFAULT 'Y' NOT NULL ;
 
    -- Add the new cronjob.
    INSERT INTO `cron_tab` ( `cron_tab_id` , `cron_class` , `cron_frequency_seconds` , `unixtime_next_run` , `enabled` ) VALUES ('', 'Job_UserOnline', '300', '', 'Y');
 
    -- Add the online users page and search page.
    INSERT INTO `jump_page` ( `jump_page_id` , `page_title` , `page_html_title` , `layout_type` , `page_slug` , `access_level` , `restricted_permission_api_name` , `php_script` , `include_tinymce` , `active` ) VALUES ('', 'Online Users', 'Online Users', 'deep', 'online', 'public', '', 'meta/online.php', 'N', 'Y');
    INSERT INTO `jump_page` ( `jump_page_id` , `page_title` , `page_html_title` , `layout_type` , `page_slug` , `access_level` , `restricted_permission_api_name` , `php_script` , `include_tinymce` , `active` ) VALUES ('', 'Search', 'Search', 'deep', 'search', 'user', '', 'meta/search.php', 'N', 'Y');   
 
Then, upload the following changed/new files. If you have customized a file in this list,
you will need to merge the changes. If you have not customized a file, it is recommended
that you overwrite it with the updated version.
 
    scripts/user/register.php (change is on line 151).
    includes/classes/classes.config.php (change is online 49).
    includes/main.inc.php (lines 119 to 153 were added).
    includes/cronjobs/user_online.class.php (new file).
    includes/cronjobs/cronjobs.config.php (lines 37 to 40 were added).
    index.php (lines 142 to 144 added).
    template/templates/layout/deep/footer.tpl (changed line 9 to include 'X User(s) Online' link).
    scripts/meta/online.php (new file).
    template/templates/meta/online.tpl (new file).
    scripts/user/preferences.php (added lines 33, 57, 111, 187, 240 to 243, and 262).
    template/templates/user/preferences/pref_errors_back.tpl (added line 13).
    template/templates/user/preferences/preferences.tpl (added lines 116 to 123, modified all subsequent class='', and added line 163).
    external_lib/aphp (ActivePHP 2.2.6, upload entire external_lib/aphp/ folder).
    template/layout/user_box.tpl (added line 8).
    script/meta/search.php (new file).
    template/templates/meta/search (new folder).
    .htaccess file - you will need to set the RewriteBase as per the installation instructions (added lines 37 to 38).