WackoWiki: 6.0 Release Notes

https://wackowiki.org/doc     Version: 303 (14.12.2023 14:36)

6.0 Release Notes

R6.0

(10.03.2023) a31bc75[link1] -> M37 (Change Log[link2])



This is a major release.
The 6.0 release serves mainly two purposes: Migration to Unicode and PHP 8.0 compatibility.

Unicode

1. Notable in this release

  1. UTF-8 support
    • यूनिकोड, Юникод, ইউনিক’ড, 유니코드
  2. accent and case-sensitive page tag
  3. implemented full support for relative path
  4. new info, chat and details formatter along with new wrapper options
  5. complete PHP 8.0 compatibility

milestones

2. Download


wackowiki-6.0.37.zip[link4]

Repo files (including community[link5] folder)


Clone repo (see Repository[link9])
git clone -b 6.0.37 https://github.com/WackoWiki/wackowiki.git

3. Upgrade path

R5.x –> R5.5[link10] (requires PHP 7.0 - 7.4)
R5.5 –> R6.0[link11] (requires PHP >= 7.3)

Please read the upgrade notices[link11] carefully.

{{admin_utf8}} -- database UTF-8 conversion script[link12]

4. Installation

Installation guide[link13]

4.1. Requirements

requires now[link14]

Step by step as Installer Screenshots[link15].

Preparing the Database for Installation
CREATE DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;


4.2. File Permissions

Change the permissions[link16] on the following files and directories to be writable

Example:
touch config/config.php
chmod 666 config/config.php

chmod 0755 _cache/config/ _cache/feed/ _cache/page/ _cache/query/ _cache/session/ _cache/template/ file/backup/ file/global/ file/perpage/ file/thumb/ xml/

chmod 0660 config/lock config/lock_ap sitemap.xml

reset after installation / upgrade
chmod 644 config/config.php

4.3. Path for session values

Check if the provided path for CACHE_SESSION_DIR is correct. The default value is /tmp but may vary in your environment.
Furthermore you may want to change this to a custom folder[link17] for the application (e.g. _cache/session) .

constants.php: 
const CACHE_SESSION_DIR				= '/tmp';

5. Admin panel[link3]


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

6. Themes


If you want to keep your layout, you have to use a program like Meld or WinMerge to merge your CSS and other theme files with the new files in the folder wacko/theme/default[link18].

You can write or adapt your theme also without using the template engine[link19].

-> Themes[link20]
-> Theme guide with example templates[link21]

7. Backwards Compatibility

We dropped compatibility code for older PHP and MySQL versions. R6.0 requires at least PHP 7.3 and MySQL 5.7. To use WackoWiki with older PHP or MySQL versions, use the older branch of 5.5.x releases[link22], which you can find on the download page[link23].

8. Known Issues

All known issues[link24] are tracked in our Bug Tracker.[link25]
  1. MySQL 8: Remove the NO_AUTO_CREATE_USER in your constants.php, e.g. 
     const SQL_MODE_PERMISSIVE			= 'NO_ENGINE_SUBSTITUTION';

    Otherwise it will throw a Fatal error: Uncaught mysqli_sql_exception: Variable 'sql_mode' can't be set to the value of 'NO_AUTO_CREATE_USER' in /setup/install-database.php:180
  2. Session duration issue[link26] - FIXED partially
  3. WikiEdit Autocomplete selection ain't working (help needed)
  4. Missing route cases (needs fix)
    1. CSS files in RECOVERY mode

9. Credits