5.4 Release Notes
1. R5.4
(12.07.2014) 3679c8e[link1] -> M3 (Change Log[link2])This is a minor release.
In addition to miscellaneous fixes the 5.4 release serves mainly one purposes: PHP 5.4 - 5.6 compatibility.
For major changes please read the Release Notes of R5.0[link3].
Notable in this release:
- complete PHP 5.4 - 5.6 compatibility
- Removed legacy MySQL extension. Instead, use the MySQLi or PDO_MySQL extensions.
- Fixed a number of localization issues
- Fixed: toc action does not recognize include page structure[link4]
- minor fixes
milestones
- final - 17.04.14
- maintenance3 – 12.07.14
1.1. Download
wacko.r5.4.3.zip[link5]- SHA1: f772e1ff54727d5f17664edd07d44f6f92bdf7a9
- File updated to change set 3679c8e51cc52770361678d93dc2b4148471acae
Repo files
- R5.4.3 (zip)[link6]
- R5.4.3 (tar.gz)[link7]
Clone repo
git clone -b 5.4.3 https://bitbucket.org/wackowiki/wackowiki.git
1.2. Translations
- Call for Localization
- If you can help with languages other than English and German, it would be appreciated.
1.3. Upgrade path
R4.x -> R5.0 (requires PHP >= 5.2)R5.x -> R5.4 (requires PHP >= 5.4)
Please read the upgrade notices[link8] carefully.
1.3.1. Upgrade from R5.4.0
If you want upgrade from R5.4.0 to R5.4.3 then just copy the new files over the old ones except:folders
cache/
, config/
, files/
, lib/captcha/
andfiles
.htaccess
, robots.txt
WackoWiki will still report themselves as R5.4.0 because this is a maintenance release.
1.4. Installation
1.4.1. Requirements
requires now- PHP 5.4 - 5.6 (PHP 5.5 recommended)
- Apache >= 2.0
- SQL database system, one of:
- MariaDB >= 5.5 (MariaDB 10 recommended)
- MySQL >= 5.5 (MySQL 5.6 recommended)
Step by step as Installer Screenshots[link9].
Data base configuration: If the installer asks you for charset, select the appropriate character set, e.g. [cp1252 Western European] for Latin 1.
1.4.2. File Permissions
Change the permissions on the following directories to be writabletouch 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
1.4.3. RewriteBase
If your webserver's URLs are not directly related to physical file paths, you will need to use RewriteBase[link10] in every .htaccess file where you want to use RewriteRule directives.RewriteBase /
RewriteBase /folder/
e.g. .htaccess
<IfModule mod_rewrite.c> RewriteEngine on RewriteBase /doc/ RewriteCond %{REQUEST_FILENAME} -d 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] RewriteRule ^(.*)$ index.php?page=$1 [QSA,L] </IfModule>
1.4.4. 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[link11] and all versions of WackoWiki prior to 5.5 will fail with SQL-Mode 'strict' on. So you must turn it off. We working on a patch.
SELECT @@GLOBAL.sql_mode, @@SESSION.sql_mode;
Disable: NO_ZERO_DATE, ONLY_FULL_GROUP_BY, STRICT_TRANS_TABLES, STRICT_ALL_TABLES, TRADITIONAL.
my.cnf
# The MySQL server [mysqld] sql_mode = NO_ENGINE_SUBSTITUTION,NO_AUTO_CREATE_USER
1.4.5. new config settings
primary config- 'database_charset' => '[latin1|cp1251|...]',
constants
- HTML_ENTITIES_CHARSET
1.4.6. path to user profile
To guide the link to the users page or profile((user:UserName UserName))
set in config/interwiki.conf the right path, if your Wiki does not resides in root don't forget to add the folders.
mode_rewrite on | mode_rewrite off |
---|---|
user /Users?profile= | user /?page=Users&profile= |
user /folder_test/wacko/Users?profile= | user /folder_test/wacko/?page=Users&profile= |
1.5. Backwards Compatibility
We dropped compatibility code for older PHP and MySQL versions. R5.4 and later requires at least PHP 5.4 and MySQL 5.5. To use with older PHP or MySQL versions, use the older (but still maintained) branch of 5.1.x releases, which you can find on the download page[link12].1.6. Hacks / Patches
- gallery action[link13]
1.7. Known Issues
All known issues are tracked in our Bug Tracker.[link14]- 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:
- Fixing Captcha And Session[link15]
- @@[local] in intra link may break the Formatter in combination with the toc action
- e.g.
((../Русский/WackoÑèíòàêñèñ Ðóññêèé @@ru))
- e.g.
- activate the option
multilanguage
in the installer / secondary config to avoid the following issues:- chars from another charset are not converted to HTML unicode entities
-
multilanguage
on: a user with a different but available browser default language can't access the default pages including login via the available theme because the Wacko engine will load this language and the related pages defined there are however possibly not applied / deleted or moved -> Solution: Restore / create the missing default pages for this language
1.8. Documentation
- URL: https://wackowiki.org
- Bug Tracker https://wackowiki.org/bugs/
- Repository
https://github.com/WackoWiki/wackowiki.git
- Documentation https://wackowiki.org/doc/
1.9. Credits
- varaha -- patches #425[link16], #426[link17], #422[link18], #430[link19]
- TriS[link20] -- patches #432[link21]
- Vyacheslav Belkin -- patches #405[link4]
- Raysir[link22] -- patches #445[link23], #446[link24]
- [link1] https://bitbucket.org/wackowiki/wackowiki/commits/3679c8e51cc52770361678d93dc2b4148471acae
- [link2] https://wackowiki.org/doc/Dev/Release/R5.4/ChangeLog
- [link3] https://wackowiki.org/doc/Dev/Release/R5.0/ReleaseNotes
- [link4] https://wackowiki.org/bugs/view.php?id=405
- [link5] https://downloads.sourceforge.net/wackowiki/legacy/wacko.r5.4.3.zip
- [link6] https://bitbucket.org/wackowiki/wackowiki/get/5.4.3.zip
- [link7] https://bitbucket.org/wackowiki/wackowiki/get/5.4.3.tar.gz
- [link8] https://wackowiki.org/doc/Dev/Release/R5.4/Upgrade
- [link9] https://wackowiki.org/doc/Doc/English/Installation/Screenshots
- [link10] https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewritebase
- [link11] https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html
- [link12] https://wackowiki.org/doc/Download
- [link13] https://wackowiki.org/doc/Dev/PatchesHacks/Gallery
- [link14] http://wackowiki.sourceforge.net/bugs/
- [link15] https://wackowiki.org/doc/Dev/Release/R5.0/CaptchaAndSession
- [link16] https://wackowiki.org/bugs/view.php?id=425
- [link17] https://wackowiki.org/bugs/view.php?id=426
- [link18] https://wackowiki.org/bugs/view.php?id=422
- [link19] https://wackowiki.org/bugs/view.php?id=430
- [link20] https://wackowiki.org/doc/Users?profile=TriS
- [link21] https://wackowiki.org/bugs/view.php?id=432
- [link22] https://wackowiki.org/doc/Users?profile=Raysir
- [link23] https://wackowiki.org/bugs/view.php?id=445
- [link24] https://wackowiki.org/bugs/view.php?id=446