Installing Wikka Wiki
Uniform Server 3.5-Apollo. |
Wikka Wiki is a flexible, standards-compliant and lightweight wiki engine written in PHP, uses MySQL server to store pages. Easy to install on either a test or live server the latest release runs smoothly on Uniform Server. The following step-by-step guide will have you up and running in no time.
Wikka Wiki Download
The latest stable version (Wikka-1.1.6.4) can be found on the home page Wikka Wiki
Archived versions can be found at their download site.
They offer several compressed file formats I will use the .zip version in this tutorial.
Interestingly I noticed a subtle folder name change in uncompressed versions; for completeness I have included uncompressing versions Wikka-1.1.6.2.zip and Wikka-1.1.6.4.zip. Installation remains unchanged.
Always download and install the latest version especially if it contain security fixes.
Preperation
Un-Zip Wikka-1.1.6.2.zip
Download and un-zip. (Note: This is an older version shown only for completeness)
|
Copy to Uniform Server Root
Copy to correct location. (Note: This is an older version shown only for completeness)
|
Un-Zip Wikka-1.1.6.4.zip
Download and un-zip.
|
Copy to Uniform Server Root
Copy to correct location.
|
Create a database for Wikka
Uniform Server lets you create any number of databases we need to create one named wikka.
Note: If you have closed apanel re-start by typing http://localhost/apanel/ into your browser address bar.
From apanel click on phpMyAdmin (menu on left) this opens phpMyAdmin in a new browser window.
|
That completes the preparation.
Note: During installation I will assume you are using Uniform Server defaults for the database, User Name = root and Password = root.
Installing Wikka
Only two steps to go to complete installation:
- Start the Wikka installer by typing http://localhost/wikka/ into your browser address bar.
- Follow the instructions of the installer.
Do not be surprised when you see a message similar to this:
Forbidden |
Open .htaccess
The forbidden error occurs because an additional two lines are required in Wikka .htaccess file.
Open file .htaccess located in folder W:\www\Wikka and add the lines shown highlighted in bold:
<IfModule mod_rewrite.c> |
First line informs Apache to follow the newly created link names. Second line forces a base address (strictly not be required).
Installation Single Page form
After making the above modification, refresh page or re-type http://localhost/wikka/ into your browser address bar.
Installation consists of filling in a single form reproduced here with comments. The values highlighted either need entering or changing all other values leave as default.
Field Name | Values | Comments | |
---|---|---|---|
Database Configuration | |||
MySQL host: | localhost | ||
MySQL database: | wikka | ||
MySQL user name | root | ||
MySQL password: | root | Read this security check list before going live | |
Table prefix: | wikka_ | ||
Wikka Site Configuration | |||
Your Wikka site's name: | Max International | You can use spaces | |
Home page: | HomePage | No spaces use capitals as shown (Wiki convention) | |
Your Wiki suffix: | @wikka | ||
Meta Keywords: | test,suppot,pub | Used by search engines separate with commas | |
Meta Description: | My site is the best | Short description of your site | |
Syntax Highlighting | |||
GeSHi path: | 3rdparty/plugins/geshi | ||
GeSHi language files path: | 3rdparty/plugins/geshi/geshi | ||
Code wrapper (div or pre): | div | ||
Disable line numbers | 1 | ||
Tab width: | 4 | ||
Administrative Account Config | |||
Admin name: | JohnSmith | No spaces use capitals (Wiki convention) | |
Enter password: | abc123 | Use real password | |
Confirm password: | abc123 | ||
Email: | smith@fred.com | Use real email | |
Wikka URL Configuration | |||
Base URL: | http://localhost/wikka/ | ||
Rewrite mode: | ticked [Enabled] |
During installation a checklist is displayed make sure OK is assigned to each result. On success you will be presented with the following message:
That's all! You can now return to your Wikka site. However, you are advised to remove write access to wikka.config.php again now that it's been written. Leaving the file writable can be a security risk!
Running Wikka Wiki
Run Wikka Wiki by typing http://localhost/wikka/ or localhost/wikka/ into your browser address bar. Your site index page is displayed note the site title Max Internation.
|
|
Note: Once a page is created (or already exists) clicking on it's link name opens it, you can then view the page or edit it's content.
Going Live
The above test installation allows you to test Wikka Wiki and become familiar with its operation. Putting it online from your home web server requires changing the base URL in the configuration file.
Suppose your web server URL is http://www.me.gotdns.com the Wikka base URL becomes http://www.me.gotdns.com/wikka/.
Open file wikka.config.php located in folder Wikka replace the highlighted line below with your own URL:
<?php
// wikka.config.php written at 06/15/08 19:59:25 $wakkaConfig = array( |
Portability
Copy folder Uniform Server and all its content to a USB stick and your Wikka Wiki is ready to use.
Problems
Other than adding the two lines to .htaccess as explained above no other problem were encountered.
Conclusion
Nothing more to say other than enjoy.
Ric |