Manual:Code

From mediawiki.org
(Redirected from MediaWiki code layout)

This page describes top-level directories in the MediaWiki core code repository.

See also the following pages in the versioned MediaWiki documentation site (auto-generated using Doxygen ):

Entry points

See Entry points on doc.wikimedia.org to learn about the entry point files, such as: index.php, api.php and load.php.

cache/

The installer recommends users to enable the $wgCacheDirectory feature by making this directory writable and using it for that feature.

This directory is empty by default.

docs/

Contains high-level documentation about MediaWiki, which is automatically published for each MediaWiki release (and for "master") to doc.wikimedia.org.

For the living version of the MediaWiki doc site, see https://doc.wikimedia.org/mediawiki-core/.

extensions/

This is where MediaWiki extensions are installed. To install an extension, its source code is placed in a subdirectory here (typically by unpacking a tarball downloaded from the extensions' mediawiki.org documentation page, or by cloning the source code from Gerrit). Then, to enable the extension it must be loaded from LocalSettings.php , typically by calling wfLoadExtension().

The default distribution for MediaWiki (as advertised on our homepage and as packaged with Debian) also bundles a number of extensions and skins. See Bundled extensions and skins .

includes/

This directory stores the majority of the MediaWiki source code.

To learn about the different classes and components of MediaWiki, see "Modules" on doc.wikimedia.org/mediawiki-core/.

images/

This is the default directory where user-uploaded media files will be stored. It is also where the generated thumbnails are stored by default.

See also Manual:Configuring file uploads and Manual:Image administration .

languages/

This directory contains pure data and configuration for localization and internationalization.

Specifically:

maintenance/

This directory contains shell scripts for use by system administrators to perform maintenance tasks. This includes scripts for performing database schema migrations, and batch operations. See Manual:Maintenance scripts for an overview.

mw-config/

This directory is the entry point for the Web installer which new administrators can use to install their wiki. It helps with configuring the wiki and creating the database schema.

resources/

This directory contains frontend resources (JavaScript and CSS) managed by ResourceLoader .

skins/

This is where MediaWiki skins are installed. To install a skin, its source code is placed in a subdirectory here (typically by unpacking a tarball, or by cloning the source code from Git). Then, to enable the skin it must be loaded from LocalSettings.php , typically by calling wfLoadSkin().

See also Bundled extensions and skins .

tests/

Contains unit tests, integration tests, and end-to-end tests.