||This page contains release notes for an unsupported version of MediaWiki.|
|Branch points • Version lifecycle|
MediaWiki 1.25 is a legacy MediaWiki version. Consult the RELEASE-NOTES file for the full list of changes. It was deployed on the Wikimedia Foundation's wikis through incremental "wmf"-branches from September 2014 to April 2015. The 1.25.0 stable release was released on Monday, May 25, 2015. A 1.25.1 tarball was released shortly afterwards due to a JSON syntax error in the ConfirmEdit extension. It features over 2200 changes from over 140 developers, as well as the work of many translators. Download the latest snapshot or checkout the
REL1_25 branch in Git to follow this release.
- 1 Indicators
- 2 Enhanced recent changes
- 3 Live preview
- 4 Import
- 5 Hit counters removed
- 6 Internationalization
- 7 Upgrade notices for MediaWiki administrators
- 8 Release schedule
- 9 Subpages
Templates that add icons to the top right corner of the page (and more) can be updated to use the new page status indicators feature.
Enhanced recent changes[edit source]
MediaWiki now uses by default the extended watchlist and so called enhanced recent changes (preference "Group changes by page in recent changes and watchlist"), which also received several improvements in MediaWiki 1.24 and 1.25 (task T37785).
This means that Special:RecentChanges and Special:Watchlist show all the changes to each page in a given day, sorted by page rather than chronologically. Changes to each page are collapsed by default and a compact overview is shown, with links to collated diffs and counts of each user's actions. Full activity for an individual page can then be shown with a single click.
Live preview[edit source]
While editing, you're not sure what a wikitext syntax will produce? That's no longer a problem, now that live preview is no longer experimental. By enabling the feature in your preferences, MediaWiki will display the effect of your edits without fully reloading the page, so that you can quickly correct any mistake.
Hit counters removed[edit source]
MediaWiki no longer includes hit counters in core, following a request for comment, which means that Special:PopularPages and the "Most Viewed Pages" section of Special:Statistics are now removed. The hit numbers, which occurred until the 1.25 upgrade was installed, will still be kept in the database, but they will no longer be updated. If you want to continue using this functionality: It has been re-implemented into Extension:HitCounters.
Logging and gender[edit source]
Continuing the work in MediaWiki 1.18 and 1.19, multiple log types of Special:Log have been migrated to the new logging system, which allows full internationalization including word order and grammatical gender. The migration continues. See task T26620 for a list.
New locales[edit source]
The following locales have been added:
- روچ کپتین بلوچی
- Koyraboro Senni
Upgrade notices for MediaWiki administrators[edit source]
Breaking changes[edit source]
- PHP 5.3.3 or newer is now required to run MediaWiki (up from PHP 5.3.2).
- The legacy skinning system, that uses skin autodiscovery, has been removed (deprecated since 1.23) in favor of the skin registration system. This skinning system has been available, with some minor changes, since MediaWiki 1.12.
- The OpenSearchXml extension was merged into MediaWiki core. If you have it installed, you should undeploy it.
- Users installing from git will now need to fetch external libraries. More details are available below in #External libraries.
- Special:Cite was moved out of the Cite extension and into a separate CiteThisPage repository.
require_once "$IP/extensions/Cite/SpecialCite.php";should be replaced by
wfLoadExtension( 'CiteThisPage' );
- If you do not keep your extensions or skins inside the default location (
$IP/skins), see #Changes to extension loading below.
- #Hit counters removed
Configuration changes[edit source]
More configuration defaults have been flipped, to reduce the strain needed by most administrators to get a sensibly-configured install. See the full release notes for details.
API changes[edit source]
A large amount of time was spent cleaning up the API, making the output saner, and friendlier for new developers to use. The following breaking changes are included in 1.25:
- Backlinks, imageusage, and embeddedin as prop modules
- Warnings will be sent if no continuation parameter is passed
- API help overhaul (see below)
- Breaking change in generator=search
- Deprecation of list=deletedrevs, and a minor BREAKING CHANGE for action=query revids=
- BREAKING CHANGE: Title-part parameters will no longer silently break on the '#' character
- BREAKING CHANGE: list=search redirecttitle is no longer an object
- Reminder: Breaking change to API continuation planned for 1.26
The API documentation was overhauled to use internationalized messages, a prettier format, and be easier to navigate. The help can be embedded or linked to in wiki pages by transcluding Special:ApiHelp. For those who preferred being able to see all documentation in one page, you can use recursivesubmodules=1.
API responses in
php have a more sensible data layout if clients specify a new
formatversion=2 parameter in requests (task T76728). If you do not specify this, API responses should be backwards-compatible, but in some cases developers of API modules will need to update their extension to ensure this. All extensions that are developed in Wikimedia Gerrit have been updated in 1.25 to ensure backwards compatibility. More details are in API:JSON version 2 and the generated API help for
user_newtalk.user_idto an unsigned integer
- Increase the length for various comment and reason fields to prepare for increasing the edit summary length
Changes to extension loading[edit source]
To work towards a proper configuration database, we are changing the way extensions and skins are registered with MediaWiki. Extensions and skins can now move their metadata into extension.json or skin.json, and use
wfLoadExtension( 'FooBar' ); or
wfLoadSkin( 'FooBar' ); to load those that support it. All extensions and skins bundled with the tarball support this. The old style of loading by
require_once "$IP/extensions/FooBar/FooBar.php"; will continue to be supported for backwards-compatibility.
If you do not keep your extensions or skins inside the default location (
$IP/skins), you will need to set
for extensions, and the poorly named
Developer documentation on how to migrate extensions can be found at extension registration.
Less invasive profiling[edit source]
The entire profiling system has been overhauled to be more flexible and less invasive using the xhprof extension. Manual
wfProfileOut function calls are no longer needed and should be removed. See Manual:Profiling for an overview of the new options and how to update your
External libraries[edit source]
As part of the Library infrastructure for MediaWiki project, MediaWiki core now uses composer for managing external dependencies instead of copying the files into our code repo, such as CSSJanus and lessphp. In addition, libraries not specific to MediaWiki that were originally written for MediaWiki, such as the CDB library, were moved out into their own repos.
The tarball will contain these dependencies and the upgrade process for tarball users should stay the same. Users who have cloned from git will need to follow the instructions at Download from Git#Fetch external libraries. Installed libraries will be displayed upon Special:Version in their own section.
Better support for composer-managed extensions[edit source]
composer.json was previously used for composer-managed extensions, but it is now used for managing dependencies of MediaWiki core. After discussions regarding this issue, a composer-merge-plugin was developed so sysadmins could specify their dependencies in a
composer.local.json. More documentation is available at Composer/For extensions.
Release schedule[edit source]
The anticipated dates for point releases for 1.25 are as follows:
|1.25.1||2015-05-25; fixes bugs in QuestyCaptcha and ReCaptcha that are bundled with 1.25.0.|