Installing Wikka Wiki: Difference between revisions
m
Reverted edits by Upazixorys (Talk); changed back to last version by Ric
Upazixorys (talk | contribs) No edit summary |
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric) |
||
| Line 1: | Line 1: | ||
<span id="top"></span> | |||
<div style="padding:0;margin:0; border-bottom:3px inset #000000"> | |||
{| | {| | ||
| [[Image:uc_small_logo.gif | MPG UniCenter]] || | | [[Image:uc_small_logo.gif | MPG UniCenter]] || | ||
Installing Wikka Wiki | Installing Wikka Wiki | ||
|} | |} | ||
</div> | |||
{| cellpadding= | {| 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= | {|width="800" | ||
|- | |- | ||
|valign= | |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= | |valign="top"| | ||
1& | 1 | ||
| | | | ||
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= | |valign="top"| | ||
2& | 2 | ||
| | | | ||
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= | |valign="top"| | ||
3& | 3 | ||
| | | | ||
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= | {|width="800" | ||
|- | |- | ||
|valign= | |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= | |valign="top"| | ||
1& | 1 | ||
| | | | ||
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= | |valign="top"| | ||
2& | 2 | ||
| | | | ||
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= | {|width="800" | ||
|- | |- | ||
|valign= | |valign="top"| | ||
Download and un-zip. | Download and un-zip. | ||
{| | {| | ||
|- | |- | ||
|valign= | |valign="top"| | ||
1& | 1 | ||
| | | | ||
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= | |valign="top"| | ||
2& | 2 | ||
| | | | ||
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= | |valign="top"| | ||
3& | 3 | ||
| | | | ||
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= | {|width="800" | ||
|- | |- | ||
|valign= | |valign="top"| | ||
Copy to correct location. | Copy to correct location. | ||
{| | {| | ||
|- | |- | ||
|valign= | |valign="top"| | ||
1& | 1 | ||
| | | | ||
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= | |valign="top"| | ||
2& | 2 | ||
| | | | ||
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 ''' | '''''Note'':''' If you have closed apanel re-start by typing '''<nowiki>http://localhost/apanel/</nowiki>''' into your browser address bar. | ||
{|cellpadding= | {|cellpadding="8" | ||
|- | |- | ||
|valign= | |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= | {|style="background:#f5f5f5 border:none" cellpadding="0" cellspacing="0" | ||
|-style= | |-style="background:#f5f5f5;" | ||
|valign= | |valign="top"| | ||
1& | 1 | ||
| | | | ||
Type the name of your database '''wikka''' | Type the name of your database '''wikka''' | ||
|-style= | |-style="background:#f5f5f5;" | ||
|valign= | |valign="top"| | ||
2& | 2 | ||
| | | | ||
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 | # 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= | {| cellpadding="8" cellspacing="2" style="background:#ff0000;" | ||
|style= | |style="background:#f5f5f5;"| | ||
'''Forbidden''' | '''Forbidden'''<br> | ||
You don't have permission to access /wikka/ on this server. | 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= | {| cellpadding="8" cellspacing="1" style="background:#000000;" | ||
|style= | |style="background:#f5f5f5;"| | ||
<IfModule mod_rewrite.c><br> | |||
& | '''Options +FollowSymLinks'''<br> | ||
& | RewriteEngine on<br> | ||
& | '''RewriteBase /wikka/'''<br> | ||
& | RewriteCond %{REQUEST_FILENAME} -d<br> | ||
& | RewriteRule ^(.*/[^\./]*[^/])$ $1/<br> | ||
& | RewriteRule ^(.*)$ wikka.php?wakka=$1 [QSA,L]<br> | ||
</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 ''' | 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= | {|cellpadding="2" | ||
|-style= | |-style="background:#cccccc" | ||
!Field Name | !Field Name | ||
!Values | !Values | ||
!Comments | !Comments | ||
|-style= | |-style="background:#f7f7f7" | ||
|'''Database Configuration'''|| || | |'''Database Configuration'''|| || | ||
|-style= | |-style="background:#f7f7f7" | ||
|MySQL host:||localhost|| | |MySQL host:||localhost|| | ||
|- style= | |- style="background:#f7f7f7" | ||
|MySQL database:||wikka|| | |MySQL database:||wikka|| | ||
|- style= | |- style="background:#f7f7f7" | ||
|MySQL user name ||'''root'''|| | |MySQL user name ||'''root'''|| | ||
|-style= | |-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= | |-style="background:#f7f7f7" | ||
|Table prefix:||wikka_ || | |Table prefix:||wikka_ || | ||
|-style= | |-style="background:#e7e7e7" | ||
|'''Wikka Site Configuration'''|| || | |'''Wikka Site Configuration'''|| || | ||
|- style= | |- 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= | |-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= | |-style="background:#f7f7f7" | ||
|Your Wiki suffix:||@wikka|| || | |Your Wiki suffix:||@wikka|| || | ||
|-style= | |-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= | |-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= | |-style="background:#e7e7e7" | ||
|'''Syntax Highlighting'''|| || | |'''Syntax Highlighting'''|| || | ||
|- style= | |- style="background:#f7f7f7" | ||
|GeSHi path:|| 3rdparty/plugins/geshi|| | |GeSHi path:|| 3rdparty/plugins/geshi|| | ||
|- style= | |- style="background:#f7f7f7" | ||
|GeSHi language files path:||3rdparty/plugins/geshi/geshi|| | |GeSHi language files path:||3rdparty/plugins/geshi/geshi|| | ||
|- style= | |- style="background:#f7f7f7" | ||
|Code wrapper (div or pre):||div|| | |Code wrapper (div or pre):||div|| | ||
|- style= | |- style="background:#f7f7f7" | ||
|Disable line numbers|| 1 || | |Disable line numbers|| 1 || | ||
|- style= | |- style="background:#f7f7f7" | ||
|Tab width: ||4 || | |Tab width: ||4 || | ||
|-style= | |-style="background:#e7e7e7" | ||
|'''Administrative Account Config'''|| || | |'''Administrative Account Config'''|| || | ||
|- style= | |- style="background:#f7f7f7" | ||
|Admin name:||'''JohnSmith'''||No spaces use capitals (Wiki convention) | |Admin name:||'''JohnSmith'''||No spaces use capitals (Wiki convention) | ||
|-style= | |-style="background:#f7f7f7" | ||
|Enter password:||'''abc123'''||Use real password | |Enter password:||'''abc123'''||Use real password | ||
|-style= | |-style="background:#f7f7f7" | ||
|Confirm password:||'''abc123'''|| | |Confirm password:||'''abc123'''|| | ||
|-style= | |-style="background:#f7f7f7" | ||
|Email:||'''smith@fred.com'''||Use real email | |Email:||'''smith@fred.com'''||Use real email | ||
|-style= | |-style="background:#e7e7e7" | ||
|'''Wikka URL Configuration'''|| || | |'''Wikka URL Configuration'''|| || | ||
|- style= | |- style="background:#f7f7f7" | ||
|Base URL:|| | |Base URL:||<nowiki>http://localhost/wikka/</nowiki>|| | ||
|- style= | |- 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: | ||
<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! | ||
</pre> | |||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
== Running Wikka Wiki == | == Running Wikka Wiki == | ||
Run Wikka Wiki by typing ''' | 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: | ||
|- | |- | ||
| | | | ||
<ol start="5"> | |||
<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. | |||
<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: | |||
</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 ''' | 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= | {| cellpadding="8" cellspacing="1" style="background:#000000;" | ||
|style= | |style="background:#f5f5f5;"| | ||
<?php | |||
// wikka.config.php written at 06/15/08 19:59:25 | // 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( | $wakkaConfig = array(<br> | ||
& | 'mysql_host' => 'localhost',<br> | ||
& | 'mysql_database' => 'wikka',<br> | ||
& | 'mysql_user' => 'root',<br> | ||
& | 'table_prefix' => 'wikka_',<br> | ||
& | 'root_page' => 'HomePage',<br> | ||
& | 'wakka_name' => 'Max International',<br> | ||
& | 'base_url' => ''''<nowiki>http://www.me.gotdns.com/wikka/</nowiki>'''',<br> | ||
& | 'rewrite_mode' => '1',<br> | ||
& | 'wiki_suffix' => '@wikka',<br> | ||
& | 'action_path' => 'actions',<br> | ||
...... | ......<br> | ||
...... | ...... | ||
|} | |} | ||