Also available in ((/Doc/Deutsch/Fehlersuche Deutsch)), ((/Doc/Русский/РешениеПроблем Русский))
**Any problems with the install, paste below or in comments to this page or the ((/Forum/Discussion discussion section)) in the forum.**
-> see also **((FAQ))**
{{toc numerate=1}}
===Installing===
Installing is very straightforward overall, however there are two things to look out for:
1. general: the unzipped directory and all contained files and subdirectories have (secure but not web-readable) permissions set so that the web-based installer is not found. The fastest way to get things running, but which also makes the install less secure is to go into the folder that contains the 'wacko' directory and run ##chmod -R 755 wacko##. Alternatively, go through all the directories and adjust permissions as necessary.
2. perhaps a problem on some webhosts: the .htaccess file gave my web host's configuration trouble, i.e. it couldn't find anything within the wacko folders. deleting .htaccess solved the problem.
You’ll need an empty database. If you’re not sure how to create a new database or find this information, ask your web host.
===Setup===
====After installing WackoWiki I got an empty screen====
Usually this means you've got a Fatal error, this can be caused by a missing PHP extension (##intl##, ##gd##) or another issue.
Please turn PHP error reporting in your config/constants.php on, reload the page and report back the error message you got. See Enabling debug output more below.
====SessionFileStore: inaccessible directory "/tmp"====
Usually caused by a missing ##/tmp## folder on Windows. Try to create the ##/tmp## folder in root of disk or choose ((/Dev/Components/SessionHandling another option)).
====Error 403====
Please check if you've set the correct file permissions.
====Necessary adjustments for XAMPP Windows====
For XAMPP Windows you first need to enable the GD and Intl extension in php.ini, both of which are required by WackoWiki.
1. Open the ##php.ini## file (e.g. ##C:\xampp\php\php.ini##).
1. Search for ##;extension=gd## and ##;extension=intl##.
1. Remove ##;## from both entries and then restart Apache server.
Furthermore, in the ##config/constants.php## file, the value for the session directory should be changed.
##const CACHE_SESSION_DIR = '/xampp/tmp';##
Adjust the paths according to your environment, in the example above XMAPP Windows was installed under ##C:\xampp##.
====Install under subdirectory and ((/Doc/English/ModRewrite mode_rewrite))====
Went to install R5.0 on my cloud server under the subdirectory /wiki/ and was given a 404 when accessing the /devwiki/ directory. Furthermore, accessing the index.php directly was loading but not loading any CSS/JS files for the installation.
Solution:
The fix for this was to add the following line to the root directory's .htaccess, right after the line that reads ##""RewriteEngine on""##:
%%
RewriteBase /wiki/
%%
see also
* http://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewritebase
====NGINX Rewrite Rules====
WackoWiki is ((/Dev/Projects/UriRouter server-agnostic)), but if you turn rewrite_mode on, your wiki may become inaccessible.
Please turn ##rewrite_mode## in the installer or the ((/Dev/Components/Configuration secondary config)) **off**, if you haven't configure the NGINX rewrite rules yet.
#|
*| off | on |*
|| rewrite_mode ||
|| ##wiki/?page=HomePage## | ##wiki/HomePage## ||
|#
%%
location / {
rewrite ^(.*)$ /index.php break;
}
%%
1. ((/Forum/Discussion/NginxRewrite))
1. ((https://www.nginx.com/blog/converting-apache-to-nginx-rewrite-rules/ Converting Apache Rewrite Rules to NGINX Rewrite Rules))
2. ((https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/ Pitfalls and Common Mistakes))
3. ((https://www.nginx.com/blog/creating-nginx-rewrite-rules/ Creating NGINX Rewrite Rules))
====I have No WikiEdit toolbar====
* check if your client/browser settings accepts JS (e.g. white list your wiki in NoScript / uMatrix)
===Enabling debug output===
Turning PHP error reporting in **config/constants.php** on.
%%
const DB_ERROR_MODE = 1;
const PHP_ERROR_REPORTING = 6;
%%
The PHP error log will tell you what went wrong. Report back what you've got.
##\php\logs\php_error_log##
For more details read ((/Dev/Testing the Debugging section)).