View source for 6.3 Release Notes

===R6.3===
(2026-07-18) ((commit:7e860c190bf06feb98f6207ea4d1b88365078669 7e860c1)) -> **Final** ++(((/Dev/Release/R6.3/ChangeLog Change Log)))++

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

This is a major release. Version 6.3  focuses on two main improvements: modernizing WikiEdit and preparing the codebase for refactoring.

file:/JavaScript_logo.svg?right&100
====Notable in this release====
  1. WikiEdit modernization
  2. Phiki implementation
  3. Composer support
  4. Dark mode


milestones
  * beta 8 - 2026-07-10
  * final - 2026-07-18

=====Caveats=====
%%(info type="example")
If you have a large installation with many users, **you may want to wait** for one of the next minor versions. In any case, be sure to perform a test upgrade using your current data. 
"" ""
For new installations and personal wikis, you should not encounter any problems when upgrading or installing this version. The improvements and new features far outweigh any **remaining inconveniences and inconsistencies**. 
"" ""
However, there are a few points you should keep in mind:
  1. Your browser should support at least **ES2023** (ES14)
  1. You should be able to upgrade your stack to at least **PHP 8.4**
  1. Typography: The font root size in the default theme changed from **0.875rem** to **1rem** (This equals a 114.28% total zoom level)
    * This may change the way a page is typically read—including paragraphs, line breaks, and page layout.
"" ""
This is the **first version** of the new WikiEdit. Please send us your feedback so we can improve the new codebase.
%%


====Upgrade path====
((/Dev/Release/R6.3/Upgrade R6.1 → R6.3)) 
  * requires at least WackoWiki **!!(blue)6.1.29!!**
  * **!!(blue)6.1.29!!** → **!!(green)6.3.x!!**

Please read the **((/Dev/Release/R6.3/Upgrade upgrade notices))** carefully.

====Download====
**((https://downloads.sourceforge.net/wackowiki/wackowiki-6.3.0.zip wackowiki-6.3.0.zip))**
  * File updated to change set ##7e860c190bf06feb98f6207ea4d1b88365078669##

%%wget https://downloads.sourceforge.net/wackowiki/wackowiki-6.3.0.zip%%

=====Alternative: Installing from Source (Git)=====
If you prefer to install from Git:

%%
git clone -b 6.3.0 https://github.com/WackoWiki/wackowiki.git
php composer.phar install --no-dev --optimize-autoloader
%%
Or if you have Composer installed globally:
%%
composer install --no-dev --optimize-autoloader
%%

Clone repo (((/Org/Tools/Repository see Repository)))

====Installation====
((/Doc/English/Installation Installation guide))

It is imperative to set the password for the installer in the ##config/lock_setup## file.

=====Requirements=====
((/Dev/Release/R6.3/Dependencies requires now))
  * PHP 8.3 - 8.5 (PHP 8.4 recommended)
  * PHP Extensions
    * bcmath, ctype, gd, iconv, intl, json, mbstring, openssl, pcre, spl
  * Web server: Apache >= 2.4 / Caddy / Nginx / other
    * mod_rewrite (recommended)
  * SQL database system, one of:
    * MariaDB >= 10.6
    * MySQL >= 8.0
    * SQLite >= 3.24

Step by step as **((/Doc/English/Installation/Screenshots Installer Screenshots))**.

Preparing the Database for Installation
%%(hl sql)CREATE DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;%%


=====File Permissions=====
((/Doc/English/FilePermissions Change the permissions)) on the following files and directories to be writable.

Example:
%%
touch config/config.php
chmod 666 config/config.php config/lock config/lock_ap
%%
%%chmod 0755 _cache/config/ _cache/feed/ _cache/page/ _cache/query/ _cache/session/ _cache/template/ file/backup/ file/data/ file/global/ file/perpage/ file/thumb/ file/thumb_local/ xml/%%

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

=====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 can change this folder to a ((/Dev/Components/SessionHandling custom folder)) for the application (e.g. ##_cache/session##).

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

=====New config settings=====
Please check the ((/Dev/Release/R6.3/ChangeLog Change Log)) for more details.

=====SQLite=====
  * ((/Dev/Release/R6.2/UsingSQLite Using SQLite))
    * Install WackoWiki with SQLite 
    * Convert your WackoWiki database from MySQL or MariaDB to SQLite

=====((/Doc/English/AdminPanel Admin panel))=====
  * To log in, first define ##recovery_password## in ##config.php##
    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.
    * e.g. via ##~{{admincache}}##
  * **you must be logged in as a member of the Admin group** in the first place **to access the admin panel**
  * call yourwiki/admin.php
  * enter your recovery_password

If your ((/Doc/English/AdminPanel Admin panel)) gets locked reset **config/lock_ap** from ##1## to ##0##

====Themes====
{{anchor href="theme_migration"}}
If you want to keep your layout, use a program like Meld or WinMerge to merge your CSS and other theme files with the new files in the folder **((source:master/src/theme/default wacko/theme/default))**.

You can write or adapt your theme even without using the ((/Dev/Projects/Templatest/Usage template engine)).

-> ((/Dev/Themes Themes))
-> ((/Doc/English/ThemeGuide Theme guide with example templates))

====Translations====
WackoWiki has been translated by volunteers, and some translations might be incomplete. You can help us translate WackoWiki into your language by adding new translations or voting for existing ones.

Please join the translation project on ((https://crowdin.com/project/wackowiki Crowdin)).

Improve the translation in your language. Proofread automatically translated strings by proofreading automatically translated strings and correcting capitalization, wording, mistranslations, and untranslated strings.

For more information, see ((/Dev/Translations Translations))

====Backwards Compatibility====
We dropped compatibility code for older PHP and MySQL versions. R6.3 requires at least **PHP 8.3** and MariaDB 10.6  or MySQL 8.0. To use WackoWiki with older PHP or MySQL versions, use the older branch of ((/Dev/Release/R6.2/ReleaseNotes 6.2.x releases)), which you can find on the ((/Download/LegacyVersions download page)). 

====Known Issues====
All ((ToDo known issues)) are tracked in our ((https://wackowiki.org/bugs/ Bug Tracker.))
  1. ((/Dev/Release/R6.0/UnicodeIssues/ngramFull-TextParser ngram Full-Text Parser)), used to support Chinese, Japanese, Korean word segmentation is currently only available for MySQL.

====Developers====

=====Debug functions=====
  1. Writes a parameter to the debug log
    * ##Ut::dbg('debug_variable', $parameter);##
  1. Adds debug output to the DEBUG file and a popup window in the browser
    * ##Diag::dbg($parameter);##
    * To color the debug output in the console, pass one of ##'BLUE'##, ##'GOLD'##, ##'ORANGE'##, or ##'RED'## as the first argument. 
      * e.g. ##Diag::dbg('GOLD', $parameter);##

In both cases it writes the ##$parameter## to the log in the main directory ##src/DEBUG## when the config ##debug## is enabled. 
Be aware, the log isn't emptied automatically. **Ensure** that the file ##src/DEBUG## can be created and is writable.
%%
touch DEBUG
chmod 0664 DEBUG
%% 

====Documentation====
  * URL: https://wackowiki.org
  * ((/Org/Tools/Repository Repository)): ##~https://github.com/WackoWiki/wackowiki.git##
  * Documentation: https://wackowiki.org/doc/

====What's Planned====
WackoWiki is feature-complete for everyday use. There are of course a few peculiarities and bugs, some old ones and some new ones that are waiting to be fixed. Now the main task is to ((/Dev/Release/R6.3/ToDo make the Wiki engine better and reduce bugs)).

Apart from that, the following features are ((/Dev/Roadmap planned to be implemented)):
  1. extended ACLs
  1. WackoFormatter rewrite
  1. responsive device-agnostic theme
  1. improve GUI usability
  2. filter for lists
  1. faceted search
  1. archive table
  1. guest settings

====Contribute====
If you'd like to follow development or contribute, check out the repository, join the discussions on the WackoWiki Development page, and submit patches. Policies and the current state of the project and plans are available in the ((/Dev Dev section)) of the wiki.

  * ((/Org/Tools/Repository Repositories))
  * ((https://wackowiki.org/bugs/ Bug Tracker))
  * ((/Forum Forum))
  * ((/Dev/Translations Translations))
  * ((/Dev/Release/R6.3/ToDo ToDo))

====Feedback====
{{comment page="/Dev/Release/R6.3/ReleaseNotes/" text="Leave a comment here"}} if something is not clear or you have further questions.

====Credits====
  * ((user:Elar9000 Elar9000)) — developer, translation, support
  * ((user:EoNy EoNy)) — translation, documentation, screenshots, support
  * ((user:VictorAlx VictorAlx)) — debugging