===R6.0== (29.05.2020) ((Commit:4363763ec9f01f6226a9782f6eda94bc08701cc7 4363763)) -> **M7** ++(((/Dev/Release/R6.0/ChangeLog Change Log)))++ As work on WackoWiki 6.0 is ((/Dev/Release/R6.0/ToDo still underway)), this is an incomplete list of changes. {{toc numerate=1 from="h3" to="h6"}} This is a major release. The 6.0 release serves mainly two purposes: Migration to **Unicode** and PHP 7.4/8.0 compatibility. file:/unicode.svg?right&100 ====Notable in this release==== 1. added support for UTF-8 * यूनिकोड, Юникод, ইউনিক’ড 1. complete PHP 7.4 compatibility 2. new info formatter and wrapper options milestones * beta1 - 13.10.2019 * rc1 - 12.11.2019 * stable - 15.12.2019 * m7 - 29.05.2020 ====Download== **((https://downloads.sourceforge.net/wackowiki/wacko.r6.0.7.zip wacko.r6.0.7.zip))** * SHA1: 5881a10c52c1bd09ee6600b271b9f22bb78ea35a * File updated to change set 4363763ec9f01f6226a9782f6eda94bc08701cc7 **Repo files** (including ((source:master/community community)) folder) * **6.0.6 ((https://bitbucket.org/wackowiki/wackowiki/get/6.0.7.zip zip)) ((https://bitbucket.org/wackowiki/wackowiki/get/6.0.7.tar.gz gz)) ((https://bitbucket.org/wackowiki/wackowiki/get/6.0.7.tar.bz2 bz2))** Clone repo (((/Org/Tools/Repository see Repository))) %%git clone -b 6.0.7 https://github.com/WackoWiki/wackowiki.git%% ====Upgrade path== ((/Dev/Release/R5.0/Upgrade R4.x –> R5.0)) (requires PHP 5.2 / 5.3) ((/Dev/Release/R5.5/Upgrade R5.x –> R5.5)) (requires PHP >= 7.0) ((/Dev/Release/R6.0/Upgrade R5.5 –> R6.0)) (requires **PHP >= 7.2**) Please read the **((/Dev/Release/R6.0/Upgrade upgrade notices))** carefully. ##""{{admin_utf8}}""## -- ((/Dev/Release/R6.0/Upgrade/DatabaseConversion database UTF-8 conversion script)) ====Installation== ((/Doc/English/Installation Installation guide)) =====Requirements===== ((/Dev/Release/R6.0/Dependencies requires now)) * PHP >= 7.2 (PHP 7.3 recommended) * PHP Extensions * bcmath, ctype, gd, iconv, intl, json, mbstring, openssl, pcre, spl * Apache >= 2.4 * mod_rewrite (recommended) * SQL database system, one of: * MariaDB >= 10 (10.2.2 recommended) * MySQL >= 5.6 (5.7.7 recommended) Step by step as **((/Doc/English/Installation/Screenshots Installer Screenshots))**. Preparing the Database for Installation %%(sql)CREATE DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;%% =====File Permissions===== ((/Doc/English/FilePermissions Change the permissions)) on the following directories to be writable ##touch config/config.php## ##chmod 666 config/config.php## Example: ##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## =====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 ((/Dev/Components/SessionHandling custom folder)) for the application (e.g. ##_cache/session##) . **constants.php**: %%define('CACHE_SESSION_DIR', '/tmp'); %% =====RewriteBase== If your webserver's URLs are not directly related to physical file paths, you will need to use ((https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewritebase RewriteBase)) in every .htaccess file where you want to use ((/Doc/English/ModRewrite RewriteRule directives)). %% RewriteBase /folder/ %% =====New config settings== Please check the ((/Dev/Release/R6.0/ChangeLog Change Log)) for more details. ====((/Doc/English/AdminPanel Admin panel))== * to login define the ##recovery_password## in the config.php 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. * **you must be logged in as member of the Admin group** in the first place **to access the admin panel** * call yourwiki/admin.php * enter your recovery_password If your Admin panel gets locked reset **config/lock_ap** from ##1## to ##0## ====Themes== {{anchor href="theme_migration"}} 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 **((source:master/wacko/theme/default wacko/theme/default))**. You can write or adapt your theme also without using the ((/Dev/Projects/Templatest/Usage template engine)). -> ((/Dev/Themes Themes)) -> ((/Doc/English/ThemeGuide Theme guide with example templates)) ====Extensions== * ((/Dev/PatchesHacks/Gallery Gallery)) * ((/Dev/PatchesHacks/GeSHi Formatter: GeSHi Code Highlighting)) ====Backwards Compatibility== We dropped compatibility code for older PHP and MySQL versions. R6.0 requires at least PHP 7.2 and MySQL 5.7. To use WackoWiki with older PHP or MySQL versions, use the older (but still maintained) branch of ((/Dev/Release/R5.5/ReleaseNotes 5.5.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/ToDo/SessionTimedOut Session duration issue))** - FIXED partially 1. Missing route cases (needs fix) 2. CSS files in RECOVERY mode ====Developers== Ensure that the function or filter you use ((/Dev/Release/R6.0/Unicode supports Unicode)) when you need to process Unicode strings. Missing Unicode support will be added as needed, please provided us with feedback. =====Debug functions===== 1. to write a parameter in the debug log * ##Ut::dbg('debug_variable', $parameter);## 1. add debug output to DEBUG file and popup-window in browser * ##Diag::dbg($parameter);## * to highlight the debug output in the console add ##'[BLUE|GOLD|ORANGE|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 ##wacko/DEBUG## when the config ##debug## is enabled. Be aware the log isn't emptied automatically. **Ensure** that the file ##wacko/DEBUG## can be created and is writable. %% touch DEBUG chmod 0664 DEBUG %% ====Documentation== * URL: https://wackowiki.org * Repository ##~https://github.com/WackoWiki/wackowiki.git## * Documentation https://wackowiki.org/doc/ ====What's Planned== WackoWiki is pretty usable now. There are of course few peculiarities and bugs, some old ones and some new ones which are waiting to be fixed. Now the main task is to make the Wiki engine better and reduce bugs. Apart from that 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. Libsodium, ((https://wiki.php.net/rfc/argon2_password_hash Argon2 Password Hash)) 1. archive table 1. guest settings ====Contribute==== Those interested in following and contributing to the development of WackoWiki can check out the repository, and participate in the discussions on the WackoWiki Development and contribute 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)) ====Feedback== {{comment page="/Dev/Release/R6.0/ReleaseNotes/" text="Leave a comment here"}} if something is not clear or you have further questions. ====Credits== * ((user:RideSnowNow RideSnowNow)) -- developer, translation * 王彥傑 (Yan-Jie Wang) - initial ((https://gitorious.org/wackowiki-tchinese/wackowiki-unicode Unicode fork)) * ((user:Raysir Raysir)) -- testing, translation * ((user:Elar9000 Elar9000)) -- developer, translation, support * ((user:EoNy EoNy)) -- translation, documentation, screenshots, support * ((user:KlePy KlePy)) -- Spanish translation * ((user:Abram4 Abram4)) -- Russian translation , testing