Rookies' Setup Guide
From hub, the Help Forum for wikkii users
WORK IN PROGRESS
This page provides a broad step-by-step tutorial for users who are installing Mediawiki for the first time using the cPanel provided by Wikkii under the Advanced Hosting service. It is unlikely that a new wiki can commence on the Advanced Hosting service given Wikkii's T&C here, most likely it is an existing wiki moving to Wikkii's service from another wiki-host.
[edit] Moving from another wiki host
This following only applies to wikis running on Mediawiki:
- Download the latest database dump from the Special:Statistics page if available, else refer to Importing from old wiki section for other methods of retrieving old wiki's data.
- Thereafter go to Special:Export page to export all the pages and page history. In the case of huge wikis, this may need to be done in batches.
- Alternatively, advanced users can use the script developed by http://absurdopedia.net to do this via API for Bots ~
- See http://meta.wikimedia.org/wiki/Help:Export for step by step guide.
For wikis moving from other hosting services that do not use the Mediawiki engine, please refer to the following link for further reading:
- How sticky is your wiki? ~ http://jiscpowr.jiscinvolve.org/wp/2008/07/13/sticky-wiki/
- Importing from other wiki engines ~ http://www.mediawiki.org/wiki/Manual:Importing_external_content
[edit] Prerequisites before installation
- you should have received your wikkii.net account details from Wikkii, e.g.
Username: xyz123 Password: 12345678 Web address: http://xyz.wikkii.net FTP address: xyz.wikkii.net Cpanel location: http://xyz.wikkii.net/cpanel
- cpanel link may redirect, after which a pop-up dialog will prompt you for login name and password
- cPanel account must be up and running, you must be able to access it, see Advanced Hosting Overview for an idea of what the cPanel looks like
- FTP should be accessible either using browser plugin or stand-alone FTP client, see Advanced Hosting Overview
- if FTP access is blocked, check your firewall settings to allow FTP access
[edit] Downloading the Mediawiki installation package
- Mediawiki installation package ~ http://www.mediawiki.org/wiki/Download
- Mediawiki Extensions ~ http://www.mediawiki.org/w/index.php?title=Category:All_extensions&from=CATEGORYWATCH
[edit] General changes to Localsettings.php
- $wgScriptPath ~ change this path in Localsettings.php if moved MW folder AFTER installation, e.g. rename '/mediawiki-1.16.0' to '/w'
- $wgLogo ~ set FULL URL if required when using images not hosted on same site, else relative path
- generating thumbnails ~
[edit] Backing up original files
[edit] Short URLs
[edit] Before uploading/importing any file
Related reading ~ http://www.mediawiki.org/wiki/Manual:Configuration_settings#Uploads
A few main settings to configure in Localsettings.php:
- $wgEnableUploads
- check that uploading is enabled, since in MW's default deployment, uploading is disabled ~ http://www.mediawiki.org/wiki/Manual:$wgEnableUploads
- $wgHashedUploadDirectory
- review whether you wish to use hashed directory structure for uploads ~ http://www.mediawiki.org/wiki/Manual:$wgHashedUploadDirectory
- take the advice on that instruction page seriously if you do not want to have to re-upload everything!
- $wgUploadDirectory
- $wgUploadPath
Optional Settings include:
- $wgAllowCopyUploads
- allows uploading of files using URLs, regular uploading is only from local directory ~ http://www.mediawiki.org/wiki/Manual:$wgAllowCopyUploads
[edit] Importing from old wiki
Ability of Special:Import page to import XML database dump (generated from the old wiki site) based on the following:
- 1. the maxuploadsize= restricted by php.ini (which only the server host has access to)
- 2. the default Mediawiki import limit, which is about 1.4mb
The dumps for most big wikis will exceed this limit.
- Method 1
- Method 2
- If an AutoWikiBrowser(AWB) account is enabled at old wiki site, use AWB to generate a list of all pages, including redirects and other special namespaces.
- Go to Special:Export page at old wiki site and export the pages in batches, maintaining a reasonable size for Special:Import at new wiki site.
[edit] Uploading
This section refers to files other than the database or XML data dump, which is "imported". These files generally come with the prefix "File:", e.g. "File:worldmap.jpg".
[edit] Bulk Uploading
Some extensions can be installed for mass or bulk uploading include:
[edit] Images Uploading
[edit] User Accounts
[edit] Creating User Accounts
By default, wiki sysops should be able to create accounts for other users using the Special:UserLogin page while logged in as sysop. However, this entails doing it one username by one username.
- Extension for creating batch accounts ~ http://www.mediawiki.org/wiki/Extension:ImportUsers
[edit] User Rights Management
- To give sysops the "oversight" right ~ http://www.mediawiki.org/wiki/RevisionDelete
[edit] Bots and Semi-bots
- http://en.wikipedia.org/wiki/Wikipedia:Creating_a_bot
- http://en.wikipedia.org/wiki/Wikipedia:Semi-bots
- http://en.wikipedia.org/wiki/Wikipedia:Tools/Editing_tools#Semi-auto_edit_bots
[edit] Adding the 'Hosted by Wikkii' icon
Please note that you should have some basic understanding of PHP codes in order to attempt this section. This section's codes are only applicable to the VECTOR SKIN.
To add the 'Hosted by Wikkii' icon at the base of every page, next to the 'Powered by Mediawiki' and 'Copyright' icons:
- 1. Grab the icon from Wikkii.com's main page and upload to '/skins/common/images'
- 2. In your cPanel File manager, locate these 3 files from your base MW installation:
- /skins/Vector.php
- /includes/SkinTemplate.php
- /includes/Skin.php
- 3. In Vector.php, add this under <ul id="footer-icons" class="noprint"> section:
<?php if ( $this->data['hostedbyico'] ): ?> <li id="footer-icon-hostedby"><?php $this->html( 'hostedbyico' ) ?></li> <?php endif; ?>
- 4. Note that the above statement should be identical to the 'poweredbyico' and 'copyrightico' statements below, other than the change in variables.
- 5. In SkinTemplate.php, add this under wfProfileIn( __METHOD__ . '-stuff4' ); section above the 'copyrightico' statement:
$tpl->set( 'hostedbyico', $this->getHostedBy() ); //custom-added in hosted by icon
- 6. In Skin.php, add the following function, which is copied and modified from the getPowerBy() function already inside:
/**
* Gets the hosted by Wikkii icon.
* @return string
*/
function getHostedBy() {
global $wgStylePath;
$url = htmlspecialchars( "$wgStylePath/common/images/button-hostedby.jpg" );
$img = '<a href="http://www.wikkii.com/"><img src="' . $url . '" height="31" width="88" alt="Hosted by Wikkii" /></a>';
return $img;
}
- 7. Please ensure the image name 'button-hostedby.jpg' corresponds with the name of the icon that you have uploaded in Step 1.
[edit] Wiki Site Optimization
SEO (Search Engine Optimization) should only be done when the wiki has matured, i.e. has substantial content already.
- Overview on Website Optimization ~ http://developer.yahoo.com/performance/rules.html
- Google search ~ http://www.google.com/addurl/?continue=/addurl
- Bing search ~ http://www.bing.com/webmaster/SubmitSitePage.aspx
[edit] Site Statistics
Page counters, tools to monitor wiki's page hits, etc:
- http://flagcounter.com/ ~ breakdown of viewership into their country profiles
- http://www.quantcast.com/ ~ viewership stats, with detail breakdown for US viewers
- Google Analytics ~ http://www.google.com/analytics/discover_analytics.html
- Others ~ http://regulargeek.com/2010/05/29/25-free-google-analytics-alternatives/
[edit] Clearing cached pages from search engines results
When a wiki has moved to another host, sometimes pages from the old site still turn up on search engine results. This can be cleared upon request.
