Installing Wikka Wiki: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
No edit summary
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric)
Line 1: Line 1:
=[http://otyxemydu.co.cc UNDER COSTRUCTION, PLEASE SEE THIS POST IN RESERVE COPY]=
<span id="top"></span>
&lt;span id=&quot;top&quot;&gt;&lt;/span&gt;
<div style="padding:0;margin:0; border-bottom:3px inset #000000">
&lt;div style=&quot;padding:0;margin:0; border-bottom:3px inset #000000&quot;&gt;
{|  
{|  
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
Installing Wikka Wiki
Installing Wikka Wiki
|}
|}
&lt;/div&gt;
</div>
{| cellpadding=&quot;4&quot;
{| cellpadding="4"
|
|
__TOC__
__TOC__
Line 29: Line 28:


=== Un-Zip Wikka-1.1.6.2.zip ===
=== Un-Zip Wikka-1.1.6.2.zip ===
{|width=&quot;800&quot;
{|width="800"
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
Download and un-zip. ('''''Note'':''' This is an older version shown only for completeness)
Download and un-zip. ('''''Note'':''' This is an older version shown only for completeness)


{|
{|
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
1&amp;nbsp;
1&nbsp;
|
|
Create a folder named '''temp''', download file '''Wikka-1.1.6.2.zip''' and save it to this folder.
Create a folder named '''temp''', download file '''Wikka-1.1.6.2.zip''' and save it to this folder.
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
2&amp;nbsp;
2&nbsp;
|
|
In Windows XP double click on this file. Select '''Extract all files''' when the wizard starts click '''next''' and  '''next''' again and finally '''finish'''.
In Windows XP double click on this file. Select '''Extract all files''' when the wizard starts click '''next''' and  '''next''' again and finally '''finish'''.
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
3&amp;nbsp;
3&nbsp;
|
|
The process creates a new folder '''Wikka-1.1.6.2''' inside this you will find a folder named '''Wikka''' this contains the script folders and files.
The process creates a new folder '''Wikka-1.1.6.2''' inside this you will find a folder named '''Wikka''' this contains the script folders and files.
Line 58: Line 57:


=== Copy to Uniform Server Root ===
=== Copy to Uniform Server Root ===
{|width=&quot;800&quot;
{|width="800"
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
Copy to correct location. ('''''Note'':''' This is an older version shown only for completeness)
Copy to correct location. ('''''Note'':''' This is an older version shown only for completeness)


{|
{|
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
1&amp;nbsp;
1&nbsp;
|
|
Start Uniform Server. I assume you are using drive W (Substitute the letter you are using).
Start Uniform Server. I assume you are using drive W (Substitute the letter you are using).
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
2&amp;nbsp;
2&nbsp;
|
|
From the above step 3 copy the '''Wikka''' folder and all its contents into the Uniform Server root folder '''WWW'''.
From the above step 3 copy the '''Wikka''' folder and all its contents into the Uniform Server root folder '''WWW'''.
Line 82: Line 81:


=== Un-Zip Wikka-1.1.6.4.zip ===
=== Un-Zip Wikka-1.1.6.4.zip ===
{|width=&quot;800&quot;
{|width="800"
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
Download and un-zip.
Download and un-zip.


{|
{|
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
1&amp;nbsp;
1&nbsp;
|
|
Create a folder named '''temp''', download file '''Wikka-1.1.6.4.zip''' and save it to this folder.
Create a folder named '''temp''', download file '''Wikka-1.1.6.4.zip''' and save it to this folder.
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
2&amp;nbsp;
2&nbsp;
|
|
In Windows XP double click on this file. Select '''Extract all files''' when the wizard starts click '''next''' and  '''next''' again and finally '''finish'''.
In Windows XP double click on this file. Select '''Extract all files''' when the wizard starts click '''next''' and  '''next''' again and finally '''finish'''.
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
3&amp;nbsp;
3&nbsp;
|
|
The process creates a new folder '''Wikka-1.1.6.4''' inside this you will find another one again named '''Wikka-1.1.6.4''' its this folder that contains the script folders and files.
The process creates a new folder '''Wikka-1.1.6.4''' inside this you will find another one again named '''Wikka-1.1.6.4''' its this folder that contains the script folders and files.
Line 111: Line 110:


=== Copy to Uniform Server Root ===
=== Copy to Uniform Server Root ===
{|width=&quot;800&quot;
{|width="800"
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
Copy to correct location.
Copy to correct location.


{|
{|
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
1&amp;nbsp;
1&nbsp;
|
|
Start Uniform Server. I assume you are using drive W (Substitute the letter you are using).
Start Uniform Server. I assume you are using drive W (Substitute the letter you are using).
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
2&amp;nbsp;
2&nbsp;
|
|
From the above step 3 copy the second  '''Wikka-1.1.6.4''' folder and all its contents to the Uniform Server root folder '''WWW'''.
From the above step 3 copy the second  '''Wikka-1.1.6.4''' folder and all its contents to the Uniform Server root folder '''WWW'''.
Line 139: Line 138:
Uniform Server lets you create any number of databases we need to create one named '''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 '''&lt;nowiki&gt;http://localhost/apanel/&lt;/nowiki&gt;''' into your browser address bar.
'''''Note'':''' If you have closed apanel re-start by typing '''<nowiki>http://localhost/apanel/</nowiki>''' into your browser address bar.
{|cellpadding=&quot;8&quot;
{|cellpadding="8"
|-
|-
|valign=&quot;top&quot; style=&quot;background:#f5f5f5;&quot;|
|valign="top" style="background:#f5f5f5;"|
From apanel click on '''phpMyAdmin''' (menu on left) this opens phpMyAdmin in a new browser window.
From apanel click on '''phpMyAdmin''' (menu on left) this opens phpMyAdmin in a new browser window.


{|style=&quot;background:#f5f5f5 border:none&quot; cellpadding=&quot;0&quot; cellspacing=&quot;0&quot;
{|style="background:#f5f5f5 border:none" cellpadding="0" cellspacing="0"
|-style=&quot;background:#f5f5f5;&quot;
|-style="background:#f5f5f5;"
|valign=&quot;top&quot;|
|valign="top"|
1&amp;nbsp;
1&nbsp;
|
|
Type the name of your database '''wikka'''
Type the name of your database '''wikka'''
|-style=&quot;background:#f5f5f5;&quot;
|-style="background:#f5f5f5;"
|valign=&quot;top&quot;|
|valign="top"|
2&amp;nbsp;
2&nbsp;
|
|
Click '''Create'''.
Click '''Create'''.
Line 169: Line 168:
Only two steps to go to complete installation:
Only two steps to go to complete installation:


# Start the Wikka installer by typing &lt;nowiki&gt;http://localhost/wikka/&lt;/nowiki&gt; into your browser address bar.
# Start the Wikka installer by typing <nowiki>http://localhost/wikka/</nowiki> into your browser address bar.
# Follow the instructions of the installer.
# Follow the instructions of the installer.


Do not be surprised when you see a message similar to this:
Do not be surprised when you see a message similar to this:


{| cellpadding=&quot;8&quot; cellspacing=&quot;2&quot; style=&quot;background:#ff0000;&quot;
{| cellpadding="8" cellspacing="2" style="background:#ff0000;"
|style=&quot;background:#f5f5f5;&quot;|
|style="background:#f5f5f5;"|
'''Forbidden'''&lt;br&gt;
'''Forbidden'''<br>
You don't have permission to access /wikka/ on this server.&lt;br&gt;
You don't have permission to access /wikka/ on this server.<br>
Apache/2.0.55 (Win32) DAV/2 PHP/5.1.1 Server at localhost Port 80
Apache/2.0.55 (Win32) DAV/2 PHP/5.1.1 Server at localhost Port 80
|}
|}
Line 187: Line 186:
Open file .htaccess located in folder W:\www\Wikka and add the lines shown highlighted in bold:
Open file .htaccess located in folder W:\www\Wikka and add the lines shown highlighted in bold:


{| cellpadding=&quot;8&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000;&quot;
{| cellpadding="8" cellspacing="1" style="background:#000000;"
|style=&quot;background:#f5f5f5;&quot;|
|style="background:#f5f5f5;"|
&lt;IfModule mod_rewrite.c&gt;&lt;br&gt;
<IfModule mod_rewrite.c><br>
&amp;nbsp;&amp;nbsp;'''Options +FollowSymLinks'''&lt;br&gt;
&nbsp;&nbsp;'''Options +FollowSymLinks'''<br>
&amp;nbsp;&amp;nbsp;RewriteEngine on&lt;br&gt;
&nbsp;&nbsp;RewriteEngine on<br>
&amp;nbsp;&amp;nbsp;'''RewriteBase /wikka/'''&lt;br&gt;
&nbsp;&nbsp;'''RewriteBase /wikka/'''<br>
&amp;nbsp;&amp;nbsp;RewriteCond %{REQUEST_FILENAME} -d&lt;br&gt;
&nbsp;&nbsp;RewriteCond %{REQUEST_FILENAME} -d<br>
&amp;nbsp;&amp;nbsp;RewriteRule ^(.*/[^\./]*[^/])$ $1/&lt;br&gt;
&nbsp;&nbsp;RewriteRule ^(.*/[^\./]*[^/])$ $1/<br>
&amp;nbsp;&amp;nbsp;RewriteRule ^(.*)$ wikka.php?wakka=$1 [QSA,L]&lt;br&gt;
&nbsp;&nbsp;RewriteRule ^(.*)$ wikka.php?wakka=$1 [QSA,L]<br>
&lt;/IfModule&gt;
</IfModule>
|}
|}


Line 203: Line 202:
'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
== Installation Single Page form ==
== Installation Single Page form ==
After making the above modification, refresh page or re-type '''&lt;nowiki&gt;http://localhost/wikka/&lt;/nowiki&gt;''' into your browser address bar.
After making the above modification, refresh page or re-type '''<nowiki>http://localhost/wikka/</nowiki>''' 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.
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.


{|cellpadding=&quot;2&quot;
{|cellpadding="2"
|-style=&quot;background:#cccccc&quot;
|-style="background:#cccccc"
!Field Name
!Field Name
!Values
!Values
!Comments
!Comments
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|'''Database Configuration'''|| ||
|'''Database Configuration'''|| ||
|-style=&quot;background:#f7f7f7&quot;    
|-style="background:#f7f7f7"    
|MySQL host:||localhost||   
|MySQL host:||localhost||   
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|MySQL database:||wikka|| 
|MySQL database:||wikka|| 
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|MySQL user name ||'''root'''||   
|MySQL user name ||'''root'''||   
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|MySQL password:||'''root''' || Read this [[Home Web Server: Security |security check list]] before going live
|MySQL password:||'''root''' || Read this [[Home Web Server: Security |security check list]] before going live
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Table prefix:||wikka_ ||
|Table prefix:||wikka_ ||
|-style=&quot;background:#e7e7e7&quot;
|-style="background:#e7e7e7"
|'''Wikka Site Configuration'''|| || 
|'''Wikka Site Configuration'''|| || 
|- style=&quot;background:#f7f7f7&quot;  
|- style="background:#f7f7f7"  
|Your Wikka site's name:||'''Max International'''||You can use spaces
|Your Wikka site's name:||'''Max International'''||You can use spaces
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Home page:||'''H'''ome'''P'''age||No spaces use capitals as shown (Wiki convention)
|Home page:||'''H'''ome'''P'''age||No spaces use capitals as shown (Wiki convention)
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Your Wiki suffix:||@wikka|| ||   
|Your Wiki suffix:||@wikka|| ||   
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Meta Keywords: ||'''test''','''suppot''','''pub'''||Used by search engines separate with commas
|Meta Keywords: ||'''test''','''suppot''','''pub'''||Used by search engines separate with commas
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Meta Description: ||'''My site is the best'''||Short description of your site
|Meta Description: ||'''My site is the best'''||Short description of your site
|-style=&quot;background:#e7e7e7&quot;
|-style="background:#e7e7e7"
|'''Syntax Highlighting'''|| ||
|'''Syntax Highlighting'''|| ||
|- style=&quot;background:#f7f7f7&quot;  
|- style="background:#f7f7f7"  
|GeSHi path:|| 3rdparty/plugins/geshi||
|GeSHi path:|| 3rdparty/plugins/geshi||
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|GeSHi language files path:||3rdparty/plugins/geshi/geshi||
|GeSHi language files path:||3rdparty/plugins/geshi/geshi||
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|Code wrapper (div or pre):||div|| 
|Code wrapper (div or pre):||div|| 
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|Disable line numbers|| 1 ||
|Disable line numbers|| 1 ||
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|Tab width: ||4 ||  
|Tab width: ||4 ||  
|-style=&quot;background:#e7e7e7&quot;
|-style="background:#e7e7e7"
|'''Administrative Account Config'''|| ||
|'''Administrative Account Config'''|| ||
|- style=&quot;background:#f7f7f7&quot;  
|- style="background:#f7f7f7"  
|Admin name:||'''JohnSmith'''||No spaces use capitals (Wiki convention)
|Admin name:||'''JohnSmith'''||No spaces use capitals (Wiki convention)
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Enter password:||'''abc123'''||Use real password
|Enter password:||'''abc123'''||Use real password
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Confirm password:||'''abc123'''||  
|Confirm password:||'''abc123'''||  
|-style=&quot;background:#f7f7f7&quot;
|-style="background:#f7f7f7"
|Email:||'''smith@fred.com'''||Use real email
|Email:||'''smith@fred.com'''||Use real email
|-style=&quot;background:#e7e7e7&quot;
|-style="background:#e7e7e7"
|'''Wikka URL Configuration'''|| ||  
|'''Wikka URL Configuration'''|| ||  
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|Base URL:||&lt;nowiki&gt;http://localhost/wikka/&lt;/nowiki&gt;||
|Base URL:||<nowiki>http://localhost/wikka/</nowiki>||
|- style=&quot;background:#f7f7f7&quot;
|- style="background:#f7f7f7"
|Rewrite mode:||ticked [Enabled]||   
|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:
During installation a checklist is displayed make sure OK is assigned to each result. On success you will be presented with the following message:
&lt;pre&gt;
<pre>
  That's all! You can now return to your Wikka site. However, you are
  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
  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!  
  been written. Leaving the file writable can be a security risk!  
&lt;/pre&gt;
</pre>


'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
== Running Wikka Wiki ==
== Running Wikka Wiki ==
Run Wikka Wiki by typing '''&lt;nowiki&gt;http://localhost/wikka/&lt;/nowiki&gt;''' or '''&lt;nowiki&gt;localhost/wikka/&lt;/nowiki&gt;''' into your browser address bar. Your site index page is displayed note the site title '''Max Internation'''.
Run Wikka Wiki by typing '''<nowiki>http://localhost/wikka/</nowiki>''' or '''<nowiki>localhost/wikka/</nowiki>''' into your browser address bar. Your site index page is displayed note the site title '''Max Internation'''.
{|
{|
|-
|-
Line 289: Line 288:
|-
|-
|
|
&lt;ol start=&quot;5&quot;&gt;
<ol start="5">
&lt;li&gt; Type your page content and any special codes into this area. I am going to create two links that take you to MyPage1 or MyPage2.  Note Wiki naming convention for the links it is important.
<li> Type your page content and any special codes into this area. I am going to create two links that take you to MyPage1 or MyPage2.  Note Wiki naming convention for the links it is important.
&lt;li&gt; When you have finished adding your content click on Preview (7) to view the page. To save the page click on Stote (6). Doing this performs a number of function:
<li> When you have finished adding your content click on Preview (7) to view the page. To save the page click on Stote (6). Doing this performs a number of function:
&lt;/ol&gt;
</ol>
::* The page is stored in MySQL database.
::* The page is stored in MySQL database.
::* The links (MyPage1 and MyPage2) are created.
::* The links (MyPage1 and MyPage2) are created.
Line 306: Line 305:
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.
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 '''&lt;nowiki&gt;http://www.me.gotdns.com&lt;/nowiki&gt;''' the Wikka base URL becomes '''&lt;nowiki&gt;http://www.me.gotdns.com/wikka/&lt;/nowiki&gt;'''.
Suppose your web server URL is '''<nowiki>http://www.me.gotdns.com</nowiki>''' the Wikka base URL becomes '''<nowiki>http://www.me.gotdns.com/wikka/</nowiki>'''.


Open file '''wikka.config.php''' located in folder '''Wikka''' replace the highlighted line below with your own URL:
Open file '''wikka.config.php''' located in folder '''Wikka''' replace the highlighted line below with your own URL:


{| cellpadding=&quot;8&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000;&quot;
{| cellpadding="8" cellspacing="1" style="background:#000000;"
|style=&quot;background:#f5f5f5;&quot;|
|style="background:#f5f5f5;"|
&lt;?php
<?php
// wikka.config.php written at 06/15/08 19:59:25&lt;br&gt;
// wikka.config.php written at 06/15/08 19:59:25<br>
// do not change wikka_version manually!
// do not change wikka_version manually!


$wakkaConfig = array(&lt;br&gt;
$wakkaConfig = array(<br>
&amp;nbsp;&amp;nbsp;'mysql_host' =&gt; 'localhost',&lt;br&gt;
&nbsp;&nbsp;'mysql_host' => 'localhost',<br>
&amp;nbsp;&amp;nbsp;'mysql_database' =&gt; 'wikka',&lt;br&gt;
&nbsp;&nbsp;'mysql_database' => 'wikka',<br>
&amp;nbsp;&amp;nbsp;'mysql_user' =&gt; 'root',&lt;br&gt;
&nbsp;&nbsp;'mysql_user' => 'root',<br>
&amp;nbsp;&amp;nbsp;'table_prefix' =&gt; 'wikka_',&lt;br&gt;
&nbsp;&nbsp;'table_prefix' => 'wikka_',<br>
&amp;nbsp;&amp;nbsp;'root_page' =&gt; 'HomePage',&lt;br&gt;
&nbsp;&nbsp;'root_page' => 'HomePage',<br>
&amp;nbsp;&amp;nbsp;'wakka_name' =&gt; 'Max International',&lt;br&gt;
&nbsp;&nbsp;'wakka_name' => 'Max International',<br>
&amp;nbsp;&amp;nbsp;'base_url' =&gt; ''''&lt;nowiki&gt;http://www.me.gotdns.com/wikka/&lt;/nowiki&gt;'''',&lt;br&gt;
&nbsp;&nbsp;'base_url' => ''''<nowiki>http://www.me.gotdns.com/wikka/</nowiki>'''',<br>
&amp;nbsp;&amp;nbsp;'rewrite_mode' =&gt; '1',&lt;br&gt;
&nbsp;&nbsp;'rewrite_mode' => '1',<br>
&amp;nbsp;&amp;nbsp;'wiki_suffix' =&gt; '@wikka',&lt;br&gt;
&nbsp;&nbsp;'wiki_suffix' => '@wikka',<br>
&amp;nbsp;&amp;nbsp;'action_path' =&gt; 'actions',&lt;br&gt;
&nbsp;&nbsp;'action_path' => 'actions',<br>
......&lt;br&gt;
......<br>
......  
......  
|}
|}

Revision as of 08:35, 24 November 2010

MPG UniCenter

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)

Create a folder named temp, download file Wikka-1.1.6.2.zip and save it to this folder.

In Windows XP double click on this file. Select Extract all files when the wizard starts click next and next again and finally finish.

The process creates a new folder Wikka-1.1.6.2 inside this you will find a folder named Wikka this contains the script folders and files.

Top

Copy to Uniform Server Root

Copy to correct location. (Note: This is an older version shown only for completeness)

Start Uniform Server. I assume you are using drive W (Substitute the letter you are using).

From the above step 3 copy the Wikka folder and all its contents into the Uniform Server root folder WWW.


Un-Zip Wikka-1.1.6.4.zip

Download and un-zip.

Create a folder named temp, download file Wikka-1.1.6.4.zip and save it to this folder.

In Windows XP double click on this file. Select Extract all files when the wizard starts click next and next again and finally finish.

The process creates a new folder Wikka-1.1.6.4 inside this you will find another one again named Wikka-1.1.6.4 its this folder that contains the script folders and files.

Top

Copy to Uniform Server Root

Copy to correct location.

Start Uniform Server. I assume you are using drive W (Substitute the letter you are using).

From the above step 3 copy the second Wikka-1.1.6.4 folder and all its contents to the Uniform Server root folder WWW.

Rename this copied folder to Wikka

Top

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.

Type the name of your database wikka

Click Create.

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.

Top

Installing Wikka

Only two steps to go to complete installation:

  1. Start the Wikka installer by typing http://localhost/wikka/ into your browser address bar.
  2. Follow the instructions of the installer.

Do not be surprised when you see a message similar to this:

Forbidden
You don't have permission to access /wikka/ on this server.
Apache/2.0.55 (Win32) DAV/2 PHP/5.1.1 Server at localhost Port 80

Top

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>
  Options +FollowSymLinks
  RewriteEngine on
  RewriteBase /wikka/
  RewriteCond %{REQUEST_FILENAME} -d
  RewriteRule ^(.*/[^\./]*[^/])$ $1/
  RewriteRule ^(.*)$ wikka.php?wakka=$1 [QSA,L]
</IfModule>

First line informs Apache to follow the newly created link names. Second line forces a base address (strictly not be required).

Top

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! 

Top

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.

  1. Click the settings/Login link to login (Shown already logged in)
  2. Note the Wiki naming convention no spaces use capitals to highlight word seperation. This covention is important used for page and link names
  3. When logged in click on HomePage (Note this is your home page) to view its contents.
  4. To edit a page click on the Edit page link this takes you into the Wiki edit screen.

  1. Type your page content and any special codes into this area. I am going to create two links that take you to MyPage1 or MyPage2. Note Wiki naming convention for the links it is important.
  2. When you have finished adding your content click on Preview (7) to view the page. To save the page click on Stote (6). Doing this performs a number of function:
  • The page is stored in MySQL database.
  • The links (MyPage1 and MyPage2) are created.
  • The pages MyPage1 and MyPage2 are created if they do not already exist.

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.

Top

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
// do not change wikka_version manually!

$wakkaConfig = array(
  'mysql_host' => 'localhost',
  'mysql_database' => 'wikka',
  'mysql_user' => 'root',
  'table_prefix' => 'wikka_',
  'root_page' => 'HomePage',
  'wakka_name' => 'Max International',
  'base_url' => 'http://www.me.gotdns.com/wikka/',
  'rewrite_mode' => '1',
  'wiki_suffix' => '@wikka',
  'action_path' => 'actions',
......
......

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.

Top


Ric