Upgrade notices for 5.0.x

1. Preparations

1. Check ReleaseNotes^[link6] for requirements
   1. PHP is supported only up to PHP 5.3
      • you can use XAMPP 1.7.7^[link7] (PHP: 5.3.8) to upgrade your legacy application
2. Back up your files to save important data.
3. Download^[link8] the final version. wacko.r5.0.5.zip^[link9]
4. pull your site in a local htdocs/test folder
5. get the database dump
6. import the database dump (e.g. via phpMyAdmin)
7. rename or remove changed default pages, the installer can only rely on the user 'WackoInstaller' in the pages table to identify and update those pages
8. remove all files and folders under htdocs/test except wakka.config.php and files/
9. modify the wakka.config.php so it will work with your local environment (database, path, theme, etc.)
10. now pull / copy the repo head into the same folder (just the content of the wacko/ folder)
11. check database tables for abandoned or inconsistent data

2. Installer

• go through all steps

3. Migrate data from R4.x to R5.0

1. convert files per page
2. move global files to new sub folder
3. migrate user settings
4. update user statistics
5. move user pages into user name space
6. set page title based on tag
7. set page depth based on tag
8. set version_id for revision
9. set new ACL permissions 'create' and 'upload'

1. check character_set_client and character_set_connection
2. check for empty lines in the old bookmark field if conversion of user settings fails and remove them

• a -> anchor
• comments -> comment
• orphanedpages -> orphaned
• recentchanges -> changes
• recentlycommented -> commented
• recentcomments -> comments
• showparagraphs / p -> paragraphs
• tableofcontents -> toc
• wantedpages -> wanted

• comments -> comment

• ((/UserName UserName)) -> ((user:UserName UserName))
• set in config/interwiki.conf

  user /Users?profile=	

  • if your Wiki does not resides in root add the folders

    user /folder_test/wacko/Users?profile=	

• login as Admin
• via action {{menu system=1}} you can edit the default bookmarks

4. Admin Panel

• to login define the recovery_password in the config file first
  1. call ther {{admin_recovery}} action as Admin and generate the password hash for your recovery_password
  2. add the password hash: 'recovery_password' => 'add hash here',
• Don't forget to delete the _cache/config/config.php afterwards.
• call yourwiki/admin.php
• enter your recovery_password

5. Captcha

• Fixing Captcha And Session^[link13]

6. Notes

1. Leave a comment here if something is not clear or you have further questions.
2. Do not hesitate to improve this instructions and the wording.