View source for R5.0 Release Notes

(01.12.2019) ((Commit:95c416fc2f607e5dd6cb85ed3f109befde198e4f 95c416f)) -> M5 ++(((/Dev/Release/R5.0/ChangeLog Change Log)))++

{{toc numerate=1 from="h3" to="h6"}}

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====
  * normalized database
  * new default theme
  * back ported most new features from openSpace fork
  * 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
  * updated installer
  * implemented ((/Dev/Components/Lib/PHPMailer PHPMailer)) support
  * fixed a number of localisation issues
  * complete PHP 5.3 compatibility 

  * 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
  * m5 - 01.12.19

  * SHA1: 966927135d6025b7cd49eeb0f117154e09b438a1

Repo files
  * **(( R5.0.5 (zip) ))**
  * **(( R5.0.5 (tar.gz) ))**

Clone repo
%%git clone -b 5.0.5

  * 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.

====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 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. 


requires now
  * PHP >= 5.2.0  &  !!**< 5.4.0**!! (PHP 5.3 recommended)
  * Apache >= 2.0
  * MySql >= 5.0.3 

Not compatible with PHP 5.4!

=====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##

=====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 |*
||TextSearch|~((TextSearch)) ||
||Users/WikiAdmin |~((Users/WikiAdmin)) ||

  * ##'enable_security_headers' => 1,##
    * If you’re wanting to load your WackoWiki installation in an IFrame or using it via different domains you’ll need to modify the function.

=====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

====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##

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.

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

====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 download page)). 

====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:
    * ((CaptchaAndSession Fixing Captcha And Session))
  2. ((bugs:405 toc action does not recognize include page structure))
  3. 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
  1. !!**Not compatible with PHP 5.4!**!! - see bugs:422

  * ((user:KlePy Kle Py)) - Spanish translation
  * ((user:DidierSpaier DidierSpaier)) -- French translation, testing
  * ((user:EvaggelosBalaskas EvaggelosBalaskas)) --   Greek translation
  * ((user:DrFreeman DrFreeman)) --   Russian translation
  * ((user:EoNy EoNy)) -- documentation
  * ((user:DaCon DaCon)) -- patches, support, testing, nifty theme
  * ((user:Elar9000 Elar9000)) -- patches, support, testing
  * ((user:WikiAdmin SkipPer)) -- coordinator
  * ((user:Eye48 haschek)) -- theme, CSS
  * ((user:SatTva SATtva)) -- (( openSpace)) port of the original ((/WackoWiki WackoWiki)) engine

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