Media Wiki Concepts: Difference between revisions
| Line 174: | Line 174: | ||
wfLoadExtension( 'ExtensionName' ); | wfLoadExtension( 'ExtensionName' ); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==Installed Extensions== | |||
To get a list of installed extensions and their versions go to 'Special pages' → Version. | |||
==Useful Extensions== | ==Useful Extensions== | ||
====BreadCrumbs==== | ====BreadCrumbs==== | ||
Revision as of 21:35, 18 April 2021
Internal
Directory Layout
/ ├── etc │ ├── php.ini │ └── php.d │ └── var/www/mediawiki-X.Y.Z ├── LocalSettings.php ├── includes │ └── DefaultSettings.php ├── images │ ├── .htaccess │ ├── archive │ ├── lockdir │ ├── thumb │ └── c │ └── cf │ └── SomeImage.png ├── extensions │ ├── BreadCrumbs │ ├── CategoryTree │ └── ... └── ...
Versions
The MediaWiki version, as well as PHP, database and extension versions can be read from Special pages → Version → Installed software.
php.ini
php.ini is the PHP configuration file. After changing it, use:
apachectl graceful
to reload the configuration file without killing the server.
To find the location for the command line interpreter, run:
php --ini
To find the location for the web module, create a "phpinfo.php" file in http root, with the following content:
<?php
phpinfo();
and load it through the web server.
LocalSettings.php
The file is located in the root of the MediaWiki installation /var/www/<installation-dir>/LocalSettings.php. To enable a change, the web server needs to be restarted with:
apachectl graceful
Contains, among others, the following:
Database Type
$wgDBtype = "mysql";
Database Hostname
$wgDBserver = "localhost";
Database User ID
$wgDBuser = "c3kb_wiki";
Database Password
$wgDBpassword = "...";
Database Default Character Set
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
Database Name
$wgDBname = "c3kb_wiki";
Site Name
$wgSitename = "Nova Ordis Knowledge Base";
Server Name
$wgServer = "https://kb.novaordis.com";
$wgServer contains the base URL of the server, including protocol and optionally the port, if non-standard, but without the trailing slash and without the subdirectory if any (e.g., https://www.mediawiki.org). The links to the wiki site from inside the pages will contain this value, so it is important to set correctly, otherwise the links embedded in pages will not work.
For example, if the site will be accessed over a ssh tunnel from the local host over a non-standard port, then wgServer should be:
$wgServer = "http://localhost:10080";
wfLoadExtension
See Extensions below.
DefaultSettings.php
MediaWiki:Common.css
A page that contains CSS modifications to be applied to all skins. If it does not exist, it can be created.
Used by:
Security
Transclusion
Transclusion means the inclusion of the content of a document into another document by reference. The most common situation where transclusion is used is the use of templates: the same content can be included in multiple documents without having having to edit those documents separately.
Namespace
Templates
A template is a page in the "Template:" namespace that gets transcluded in regular pages that refer to it. This mechanism is useful to disseminate complex content into multiple target pages, while editing the source context in just one place and referring to it via a simple name from the target pages.
Template Declaration
To start a new template, declare a link in the "Template:" namespace, as shown below
[[Template:TestTemplate]]
follow the link, and edit it. The initiating page will contain the link to the template and can be used for access. For an example of actual template declarations see the "Editing - Blockquote" section.
Parameterized Templates
MediaWiki performs variable substitution in templates, where the variables are declared as {{{1}}}, {{{2}}}, etc. A template that contains variables is called a parameterized template.
Template Invocation
The template is invoked by enclosing the template name (without the Template: namespace prefix) between {{ }}.
Example:
{{SomeTemplate}}
If the template is parameterized, the parameters are provided in order, after the template name, preceded by "|".
Example:
{{SomeTemplate|paramenter one content|parameter two content}}
ImageMap
Extensions
Extensions provide customizations on how MediaWiki looks and works. Extensions can be installed by system administrators. Extensions are usually distributed as modular packages. They are installed in their own "extensions" subdirectory, and, after installation, they are declared in LocalSettings.php as:
wfLoadExtension( 'ExtensionName' );
Installed Extensions
To get a list of installed extensions and their versions go to 'Special pages' → Version.