Upgrade notices for 5.0.x

Also available in Deutsch and Русский

Upgrade your WackoWiki from 4.x to 5.0.x.

See also the migration guides for WackoWiki versions 5.1.x, 5.4.x, 5.5.x, 6.0.x and 6.1.x.

1. Preparations

  1. Check ReleaseNotes for requirements
    1. PHP is supported only up to PHP 5.3
      • you can use XAMPP 1.7.7 (PHP: 5.3.8) to upgrade your legacy application
  2. Back up your files to save important data.
  3. Download the final version. wacko.r5.0.5.zip
  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

Call the URI in your browser -> the installer starts and tell you that you are upgrading from 4.2 / 4.3 to 5.0.x

2. Installer

  • go through all steps

Now you should have your upgraded Wiki. Login as Admin and create a page called UpgradeRoutine and add there the action {{adminupdate}} -> save (the installer will try to create this page e.g. /Users/WikiAdmin/MigrateDataToR50)

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

Action: {{adminupdate}}

The upgrade utilities are only in this release available.


  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'

adminupdate action to migrate data from R4.x to R5.0


  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

Renamed Actions

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

Renamed Formatters %%([formatter]) content %%

  • comments -> comment

You can use search to find the old strings and replace each with the new one.

change user links

  • ((/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=	

Edit default menu items

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

4. Admin Panel

The new Admin panel is in Beta stage.

  • 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

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

5. Captcha

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 for this from our Development-Blog:

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.


  1. WackoWiki Update 5.0.1 wegen PHP 5.3

    Falls noch jemand mit dem Gedanken spielt, seine WackoWiki Installation auf den neusten Stand zu bringen und es nach der Anleitung nicht klappt, hier sind meine Schritte die ich verwendet habe.

    1. Update auf 5.0.1

    1. Backup des kompletten Verzeichnisses der Wacko Wiki per FTP
    2. Backup der Datenbank per dump
    3. Durchatmen....
    4. Version 5.0.1 runterladen und auf der Festplatte entpacken
    5. Auf dem Webspace alles löschen außer:
      1. wakka.config.php (liegt im Hauptverzeichnis)
      2. files/ Ordner
      3. Eventuellen eigenen Themes (werden allerdings vermutlich eh nicht mehr funktionieren, müssen angepasst werden)
    6. Alle Daten der V5.0.1 auf den Webspace übertragen
    7. Den Inhalt .htaccess im Hauptverzeichnis mit folgendem Inhalt ersetzen (siehe unten)
    8. Mit dem Browser auf die index.php des Wikiverzeichnisses gehen
    9. Der Automatischen Anleitung folgen
    10. Ordner "setup" löschen
    11. chmod 644 für die Datei config/config.php setzen
    12. Einloggen in die Wiki ob alles geht (ansonsten Backup aufspielen)
    13. Innerhalb der Wiki eine beliebige Seite erstellen und mit folgendem Inhalt abspeichern
    14. {{adminupdate}}
    15. Punkt für Punkt die Menüpunkte auf der neu erstellten Seite abarbeiten.
    16. Fertig ist die WackoWiki 5.0.1

    1. Update auf 5.1.0

    1. Entsprechende Datei runterladen und entpacken
    2. Alle Daten überschreiben außer .htaccess (aus dem Hauptverzeichnis) und der config/config.php
    3. Alle Dateien aus dem _cache/ Ordner löschen
    4. Mit dem Browser auf die index.php des Wikiverzeichnisses gehen
    5. Der Automatischen Anleitung folgen
    6. Fertig
    7. Auf die admin.php (viele Optionen) könnt ihr zugreifen indem ihr eine Seite mit dem folgenen abspeichert.
      1. {{admin_recovery}}
    8. Den erzeugten Hash in der config.php Datei abspeichern und schon könnt ihr auf die admin.php zugreifen
    9. Ende

    Inhalt der .htaccess Datei für d(f (domainfactory)
    <IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteBase /
    RewriteRule ^$                        /index.php  [L]
    RewriteCond %{REQUEST_FILENAME}       !-f
    RewriteCond %{REQUEST_FILENAME}       !-d
    RewriteRule (.*)                      /index.php?page=$1  [QSA,L]
     RewriteRule ^(.*/[^\./]*[^/])$ $1/
     RewriteRule ^admin\.php$ admin.php [L]
     RewriteRule ^(robots\.txt)$ robots.txt [L]
     RewriteRule ^(sitemap\.xml)$ sitemap.xml [L]
     RewriteRule ^(favicon\.ico)$ favicon.ico [L]

    Wenn ihr die Standard .htaccess Datei verwendet klappts nicht...warum auch immer

    Hoffe das hilft jemand anderem....

    • gromet
    • 01.06.2016 16:59 edited