MediaWiki

User:Rehman/MediaWiki

< User:Rehman

Over the next few months, I plan on doing some demos on how organisations can use MediaWiki. This page is where I will be storing my own notes (hence it will look messy/incomplete).

The demos will be done on https://wiki.rehman.website/. All uploaded content are dummy content, and the main domain and subdomains were purchased with the intention of being disposable.

Quick links and notes edit

  • Pre-install checks:
    • Clear old files from domain/subdomains/directories
    • Clear old database/users as required
    • Recheck SSL
  • Download → Installation guide → Config script → System administration → Upgrading → Uninstallation
  • Ideal root folder setup (on shared server): home/<user>/subdomain.domain.com/root/
    • Install MediaWiki in a subdirectory (/w): home/<user>/subdomain.domain.com/root/w/ (public: subdomain.domain.com/w/)
    • Files and/or deleted files could be located outside the root: home/<user>/subdomain.domain.com/images/deleted
  • Before running MediaWiki installer. Consider extracting all required extensions, so that they may all be installed at once automatically.

Extensions edit

Extensions included within MW 1.35.0 edit

The below extensions come with the main MediaWiki installer (v1.34.2). Install all of them (as some of them requires others):

Suggested extensions edit

Private wiki edit

Restricting access within MediaWiki edit

See Manual:Preventing access. The below are automatically set when selecting "Private wiki" during install.

  • Disable reading by anonymous users: $wgGroupPermissions['*']['read'] = false;
  • Disable anonymous editing: $wgGroupPermissions['*']['edit'] = false;
  • Prevent new user registrations except by sysops: $wgGroupPermissions['*']['createaccount'] = false;

Restriction direct access to uploaded files edit

See Manual:Image authorization

  1. Add Deny from All in the .htaccess file located in the /images directory
  2. Add $wgUploadPath = "{$wgScriptPath}/img_auth.php"; to LocalSettings.php

Block malicious files (suitable if users and untrusted/unknown): Manual:Security#Upload security

Restricting bots crawling on the site edit

See Manual:robots.txt

  1. Create a robot.txt file in the web root
  2. Add the below lines within the file:
    User-agent: *
    Disallow: /

Also add $wgDefaultRobotPolicy = 'noindex,nofollow';

Other settings or notes edit

Hide index.php from URL edit

See Manual:Short URL and/or Manual:Short URL/Apache#Simple instructions.

.htaccess: 

RewriteEngine On

# main rewrite rule
RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L]

# Redirect / to Main Page
RewriteRule ^/*$ %{DOCUMENT_ROOT}/w/index.php [L]

LocalSettings.php: 

$wgScriptPath = "/w";     
$wgArticlePath = "/wiki/$1";

edit

Read more at Manual:FAQ#How do I change the logo? 

# Update site logo (default path will be overridden during upgrade)
$wgLogo = "{$wgUploadPath}/6/62/mylogo.png";

Updating the favicon edit

Read more at Manual:FAQ#How do I change the icon in the browser's address line (favicon)?

Automatic double-redirect fix edit 

# Fix double redirects after a page move. Edits by Redirect_fixer account name.
$wgFixDoubleRedirects = true;

Adding more file types edit 

# Add more file types to the default array
$wgFileExtensions = array_merge(
    $wgFileExtensions, [
        'pdf', 'ppt', 'pptx', 'doc', 'docx', 'xls', 'xlsx', 'svg', 'oft'
    ]
);
  • To avoid the error File extension ".oft" does not match the detected MIME type of the file (application/sla) for .oft files, change application/sla stl to application/sla stl oft in /includes/libs/mime/mime.types.

Amend poweredby and copyright logos edit 

# Amend both poweredby and copyright logos
$wgFooterIcons = [
	"copyright" => [
		"copyright" => [
			"src" => "/resources/assets/example_logo.png",
			"url" => "https://www.example.com/",
			"alt" => "Example text",
		]
	],
	"poweredby" => [
		"mediawiki" => [
			// Defaults to point at
			// "$wgResourceBasePath/resources/assets/poweredby_mediawiki_88x31.png"
			// plus srcset for 1.5x, 2x resolution variants.
			"src" => null,
			"url" => "https://www.mediawiki.org/",
			"alt" => "Powered by MediaWiki",
		]
	],
];

Customising the sidebar edit

See Manual:Interface/Sidebar. Example:

Changing the Main page edit

  • Rename the page to the desired name, and update MediaWiki:Mainpage
  • Hide the page title? Use {{DISPLAYTITLE:<span style="opacity:0;position:absolute;">{{FULLPAGENAME}}</span>}}

Creating custom namespaces edit

Creating custom usergroups and rights edit

Modify password policy edit

Modify footer content edit

Disable caching edit

$wgParserCacheType = CACHE_NONE;

Others edit

  • Cpanel: Setup email and/or forwarders for the $wgPasswordSender
  • Cpanel: Disable index viewing
  • Cpanel: Enable hotlink protection

MediaWiki interface pages edit

To do edit

Retrieved from "https://www.mediawiki.org/w/index.php?title=User:Rehman/MediaWiki&oldid=4193514"