R5.0 Release Notes

1. R5.0

(14.03.2017) Revision:3430 -> M4 (Change Log)

This is a major feature release.
The 5.0 release serves mainly three purposes. The first is to normalize database second to back port and merge openSpace features and last PHP 5.3 compatibility.

Notable in this release:

  • Fixed a number of localisation issues
  • complete PHP 5.3 compatibility
  • Implemented PHPMailer support
  • Added new default theme
  • Updated installer
  • normalized data base
  • major code refactoring and cleanup
    • made all function and variable names lower case, e.g. LoadAll() -> load_all()
    • replaced double quotes with single quotes wherever possible
    • tabs for indention
  • more XHTML compliance


  • beta – 01.06.2011
  • rc1 – 12.09.2011
  • rc2 – 06.02.2012
  • rc3 – 20.3.12
  • final – 22.04.12
  • m1 – 17.06.12
  • m2 – 24.11.15
  • m3 – 07.08.16
  • m4 – 14.03.17

1.1. Download


  • SHA1: 32f176d72f395c7ad69241f55416b1ed20cb2303

Repo files

Clone repo

hg clone https://bitbucket.org/wackowiki/wackowiki-stable -r 5.0.4

1.2. Translations

  • we renamed the function GetResourceValue to get_translation
  • Call for Localization
    • If you can help with languages other than English and German, it would be appreciated.

1.3. Upgrade path

R4.0 -> R4.3 (requires PHP 4)
R4.x -> R5.0 (requires PHP >= 5.2)
R4.3 -> R5.0 (requires PHP >= 5.2)

Please read the upgrade notices carefully.
Don't miss to run the adminupdate action after the upgrade to migrate your old data, it is only in this release available.

1.4. Installation

1.4.1. Requirements

requires now

  • PHP >= 5.2.0 (PHP 5.3 recommended)
  • Apache >= 2.0
  • MySql >= 5.0.3

Not compatible with PHP 5.4!

1.4.2. File Permissions

touch config/config.php
chmod 666 config/config.php

Example: chmod 0755 xml files/global files/perpage sitemap.xml _cache/config/ _cache/queries/ _cache/pages/ _cache/feeds/

chmod 644 config/config.php

1.4.3. new config settings

  • WikiLinks and TikiLinks are now entirely disabled by default
    • To re-enable them, set disable_wikilinks or disable_tikilinks = 0 via config table or Admin panel
    • with wikilinks disabled all internal links must be set in double brackets
      • enabled disabled
        Users/WikiAdmin ((Users/WikiAdmin))

1.4.4. SQL Mode

If you work on a home-brew stack using MySQL 5.6 or 5.7, please check your sql_mode settings.
MySQL switched the SQL-Mode to 'strict' as default since 5.6 and all versions of WackoWiki prior to 5.5 will fail with SQL-Mode 'strict' on. You must turn it off. We working on a patch.

SELECT @@GLOBAL.sql_mode, @@SESSION.sql_mode;



# The MySQL server

1.5. Admin Panel

The new Admin panel is still in its Beta stage.

  • to login define the recovery_password in the config file first
    1. call the {{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

If your Admin panel gets locked reset config/lock_ap from 1 to 0

1.6. Themes

Themes for earlier versions will no longer work without modification.
When you upgrade WackoWiki all of your Themes will be reset to 'default' theme for each user account to ensure that nothing breaks.
Please ensure that your Themes that either

  1. they are compatible with this release or 
  2. there are newer versions available that are compatible.

-> Themes

1.7. Extensions

Extensions installed under previous versions of WackoWiki may be incompatible and/or require updates to work with WackoWiki.

1.8. Backwards Compatibility

  • replaced GetConfigValue("setting") with config['setting']
  • replaced config['root_url'] with config['base_url'] – since mode_rewrite is handled in the run function root_url became obsolete

We dropped compatibility code for older PHP and MySQL versions. R5.x and later requires at least PHP 5.2 and MySQL 5. To use with older PHP or MySQL versions, use the older (but still maintained) branch of 4.3.x releases, which you can find on the download page.

1.9. Known Issues

All known issues are tracked in our Bug Tracker.

  1. To use Captcha, you must ensure that the session settings in freecap.php do not differ from the default values or your config settings, else Captcha can't pass its values to the session. In the following link you find a workaround:
  2. Do not use Latin1 code page for non-Latin1 content if not necessary, switch the page language accordingly
  3. toc action does not recognize include page structure
  4. broken POST & reset of Session in menu section via user settings which requires you to logout and login to refresh the changed bookmarks / menu
    • HOTFIX: add the {{menu}} action into a seperate page and edit the menu items / bokkmarks there
  5. Not compatible with PHP 5.4! – see bugs:422

1.10. Credits

If we have missed someone`s contribution — we are very sorry for that. Please fill this page with actual information.

Read comment (1 comment)