Overall Setup

Multiple CMS's are run on the same server with each occupying their own directory. Redirects via .htaccess to point to the right instance. Underneath all of this is a basic html site in case of database failure.

Make sure you exclude any directories that shouldn't appear in search engines in robots.txt

Current Structure

/w - Mediawiki
/wiki - Public facing virtual directory for Mediawiki pages
/wordpress - Wordpress

Wordpress Setup

Use en-au localisation, mate.
Send admin emails to a group email to all administrators
Enable the "imagemagick" module in PHP selector
Wordpress needs a recent version of PHP, set this in PHP selector as well.

Mediawiki Setup

Mediawiki is used with the following local modifications at the file level

~~Version 1.5.0 was previously installed and the current version installed over the top. In Version 1.5.0 newline removed from end of includes/SpecialUpload.php~~ removed 9 Sep 2010
A Google sitemap was generated at some stage using code from http://www.thinklemon.com/wiki/MediaWiki:Google_Sitemaps but this is no longer used
~~An old version 1.14.0 is used (should be upgraded)~~ upgraded 7 Oct 2010

The installation is normal with

Apache used as the web server
MySQL used for database server
InnoDB is used for database storage (from 15 September 2010)
The database character set is MySQL 4.0 backwards-compatable UTF-8. This should be changed to MySQL 4.1/5.0 binary
Whilst shell access can be made available, avoid using it if at all possible, the CPanel interface is preferred
images in the images directory
an AdminSettings.php file with $wgDBadminuser and $wgDBadminuser set to the local database created from AdminSettings.sample
a LocalSettings.php file with many local modifications
In the Mediawiki namespace
- Edithelppage set to http://meta.wikimedia.org/wiki/Help:Editing to use Meta's Help pages
- Helppage set to http://meta.wikimedia.org/wiki/Help:Contents to use Meta's Help pages
Install ParserFunctions if MediaWiki 1.18 or later is not installed, the inbuilt string functions are not enabled.

Installing Mediawiki under CPanel

If the mod_security2 module is enabled in Apache, editing pages containing more than a few links will fail and generate a 404 error on index.php. To resolve this raise a fault docket with the hosting provider to remove mod_security for the hosting account as suggested by Mediawiki documentation or possibly just have the particular rule disabled for this account. Note that mod_security2 rules or in fact any feature of it cannot be modified in .htaccess with a default CPanel installation.

Change from MyISAM to InnoDB

Enable read-only mode in LocalSettings.php:
$wgReadOnly = 'Upgrading to InnoDB';
Take a backup of database
Using PHPMyAdmin change each table type to InnoDB except for:
- Leave table hitcounter as type Memory
- Leave table searchindex as type MyISAM
Alter LocalSettings.php:

# If you're on MySQL 3.x, this next line must be FALSE:<br />
$wgDBmysql4 = true;

change to

# MySQL table options to use during installation or update
$wgDBTableOptions   = "TYPE=InnoDB";

# Experimental charset support for MySQL 4.1/5.0.
$wgDBmysql5 = false;

Disable read-only mode in LocalSettings.php by removing $wgReadOnly line.

Upgrade Mediawiki version

Have a read of the manufacturers process at https://www.mediawiki.org/wiki/Manual:Upgrading first.

Enable read-only mode in LocalSettings.php at the end of the file:
$wgReadOnly = 'Upgrading to new version';
Take a backup of database to local storage
Take a backup of contents of the /w directory tree to local storage (can compress to a zip file from cPanel file manager, then download)
Copy the new distribution version of Mediawiki to the public_html directory
Extract the new Mediawiki version, which will create a new directory /Mediawiki-new.version/images
Copy the contents of the /w/images directory to /Mediawiki-new.version/images
Create a new database user
Create a new database
Copy the existing database, the new version will use this and the new user
Grant the new user rights to the new database
Install the new version within the /Mediawiki-new.version directory
Add local modifications (see below)
Enable read-only mode in LocalSettings.php at the end of the file:
$wgReadOnly = 'Upgrading to new version';
Complete testing of new version
To finish installation (reverse for rollback)
1. Rename old /w directory to /Mediawiki-old.version and rename /Mediawiki-new.version directory to /w
2. Complete testing of new version in place
Disable read-only mode in LocalSettings.php by removing $wgReadOnly line.
Complete testing of new version with writeable database, if rollback from here, changes will be lost.
At some point delete old database and files

Who can edit

Prevent anonymous users from editing and allow only SysOps to create accounts by setting in LocalSettings.php

$wgGroupPermissions['*'    ]['edit']            = false;
$wgGroupPermissions['*'    ]['createaccount']            = false;

Allow sysops to delete revisions of pages if required

$wgGroupPermissions['sysop']['deleterevision']  = true;

Image Uploading

Safe mode was used in the past so in LocalSettings.php set:

$wgHashedUploadDirectory = false;

Set the wiki images,images/archives,images/thumbs and images/temp directories to be world write (757)
Enable image uploading so in LocalSettings.php set:

$wgEnableUploads       = true;

Add PDF, SVG, EMF and EPS file type to the list of allowable uploads, so in LocalSettings.php set:

$wgFileExtensions = array_merge(
    $wgFileExtensions, array(
        'pdf', 'sag', 'emf', 'eps'
        )
    );

To avoid an error with mime types add "emf" to include/mime.types:

chemical/x-mdl-rgfile rg emf

passthru() appears to be disabled in PHP so disable the use of ImageMagick in LocalSettings.php by

# $wgUseImageMagick = true;
# $wgImageMagickConvertCommand = "/usr/bin/convert";

Links to telephone numbers

Allow links using the tel: schema by adding an entry to LocalSettings.php as follows

# Allow tel: links
$wgUrlProtocols[] = "tel:";

Short URL's

Short urls are used, ie. http://www.bpuc.org/wiki/Articlename. This is implemented using the procedure outlined for servers without web access:

Choose the virtual directory /wiki/ in which you want your articles to appear (as Wikipedia does).
Install MediaWiki in /w/ relative to your web root (as Wikipedia does).

Add or edit the following setting in LocalSettings.php. This will cause the HTML generated by MediaWiki to refer to "/wiki/Articlename" instead of the default:

$wgScriptPath = "/w";         # Physical path (right part of first rewrite rule). Should 
                              # already be in LocalSettings.php
$wgArticlePath = "/wiki/$1";  # Virtual path (left part of first rewrite rule). MUST be 
                              # DIFFERENT from the path set above ($wgScriptPath)!
$wgUsePathInfo = true;

Create or edit .htaccess in your web root directory (typically, public_html) adding:
```
RewriteEngine On
RewriteRule ^wiki/(.*)$ /w/index.php?title=$1 [PT,L,QSA]
RewriteRule ^wiki/*$ /w/index.php [L,QSA]
RewriteRule ^/*$ /w/index.php [L,QSA]
```
RewriteRule defines virtual paths and how they should be rewritten; in the example above, /wiki/Page will cause /w/index.php?title=Page to be loaded instead.
Set robots.txt to stop robots crawling all over where they are unwanted

Preserving old URLs

To keep URLs from the older static HTML website working add the following lines to .htaccess in your web root directory (typically, public_html) adding:

RewriteRule ^people/ken_anderson\.html$ /wiki/Ken_Anderson [R]
RewriteRule ^index\.html$ /wiki/Main_Page [R]
RewriteRule ^wedding /wiki/Wedding [R]
RewriteRule ^prayer\.html$ /wiki/Prayer [R]
RewriteRule ^jokes\.html$ /wiki/Jokes [R]
RewriteRule ^baptism\.html$ /wiki/Baptism [R]

CPanel additions to .htaccess

CPanel adds two sections for 403 errors and to deny access from an annoying robot:

<Files 403.shtml>
order allow,deny
allow from all
</Files>

deny from 1.2.3.4 (annoying robot we want to block)

Look and Feel

Use the church logo

by modifying LocalSettings.php to set:

$wgLogo = "/images/bpuclogos.png"; # Point to logo

Church logo uploaded to /images/bpuclogos.png

The standard monobook skin is modified:

Remove the edit buttons etc for all except logged in users by modifying skins/Monobook.php

*** 132,137 ****
--- 132,138 ----
        </div>
                </div>
                <div id="column-one">
+         <?php if($this->data['loggedin']) { ?>
        <div id="p-cactions" class="portlet">
                <h5><?php $this->msg('views') ?></h5>
                <div class="pBody">
***************
*** 160,165 ****
--- 161,167 ----
                        </ul>
                </div>
        </div>
+         <?php } ?>
        <div class="portlet" id="p-personal">
               <h5><?php $this->msg('personaltools') ?></h5>
                <div class="pBody">

Set in the BPWiki namespace:
- About to "This is the website of Brougham Place Uniting Church. It is a Wiki so that all members of the Brougham Place Community can contribute to it."
- Current events set to avoid double redirect

#REDIRECT [[Current events]]

Set in the MediaWiki namespace:
- Contact set to "Contact us"
- Contact-url set to "Contact"
- Monobook.css customised

/* CSS placed here will affect users of the Monobook skin */

body.page-Main_Page h1.firstHeading { display:none; }

body { background: #F0FFFF; }

- MediaWiki:Sidebar customised as

* navigation
** mainpage|mainpage
** currentevents-url|currentevents
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help
** contact-url|contact

Listing Directories

The Apache directory listing is disabled by the host. Use Directory lister instead. Be careful not to delete the index.php file when cleaning up directories that are listed.

MIME types

Add the following entries which are not specified by the defaults

MIME Type	Extension(s)
application/epub+zip	image/emf
ePub	emf

Website Setup

Contents