Merge "resourceloader: Add unit test for validateScriptFile()"
[lhc/web/wiklou.git] / RELEASE-NOTES-1.26
1 Security reminder: If you have PHP's register_globals option set, you must
2 turn it off. MediaWiki will not work with it enabled.
3
4 == MediaWiki 1.26 ==
5
6 THIS IS NOT A RELEASE YET
7
8 MediaWiki 1.26 is an alpha-quality branch and is not recommended for use in
9 production.
10
11 === Configuration changes in 1.26 ===
12
13 === New features in 1.26 ===
14 * Change tags can now be hidden in the interface by disabling the associated
15 "tag-<id>" interface message.
16 * ':' (colon) is now invalid in usernames for new accounts. Existing accounts
17 are not affected.
18 * Added a new hook, 'LogException', to log exceptions in nonstandard ways.
19
20 ==== External libraries ====
21
22 === Bug fixes in 1.26 ===
23 * (bug 51283) load.php sometimes sends 304 response without full headers
24
25 === Action API changes in 1.26 ===
26 * API action=query&list=tags: The displayname can now be boolean false if the
27 tag is meant to be hidden from user interfaces.
28 * action=import no longer allows both the namespace= and rootpage= parameters
29 to be set. If they are both set, the value of rootpage= will be ignored.
30 * prop=revision output in enum mode is now sorted by timestamp rather than
31 revision ID. This usually won't make any difference.
32
33 === Action API internal changes in 1.26 ===
34
35 === Languages updated in 1.26 ===
36
37 MediaWiki supports over 350 languages. Many localisations are updated
38 regularly. Below only new and removed languages are listed, as well as
39 changes to languages because of Bugzilla reports.
40
41
42 === Other changes in 1.26 ===
43 * ChangeTags::tagDescription() will return false if the interface message
44 for the tag is disabled.
45 * Added PageHistoryPager::doBatchLookups hook.
46 * Added ParserCacheSaveComplete to ParserCache
47 * supportsDirectEditing and supportsDirectApiEditing methods added to
48 ContentHandler, to provide a way for ApiEditPage and EditPage to check
49 if direct editing of content is allowed. These methods return false,
50 by default for the ContentHandler base class and true for TextContentHandler
51 and it's derivative classes (everything in core). For Content types that
52 do not support direct editing, an alternative mechanism should be provided
53 for editing, such as action overrides or specific api modules.
54 * mediaWiki.confirmCloseWindow now returns an object of functions, instead of
55 one function. The callback can't be called directly any more. The callback
56 function is replaced with confirmCloseWindow.release().
57 * Removed maintenance script deleteImageMemcached.php.
58 * MWFunction::newObj() was removed (deprecated in 1.25).
59 ObjectFactory::getObjectFromSpec() should be used instead.
60 * The parser will no longer randomize the string it uses to mark the place of
61 items that were stripped during parsing. It will use a fixed string instead.
62 This causes the parser to re-use the regular expressions it uses to search
63 and replace markers rather than generate novel expressions on each parse.
64 Re-using regular expressions will improve performance on HHVM and the
65 forthcoming PHP 7. The interfaces changes accompanying this change are:
66 - Parser::getRandomString() and Parser::uniqPrefix() have been deprecated.
67 - The $uniq_prefix argument for Parser::extractTagsAndParams() and the
68 $prefix argument for StripState::_construct() are deprecated and their
69 value is ignored.
70
71
72 == Compatibility ==
73
74 MediaWiki 1.26 requires PHP 5.3.3 or later. There is experimental support for
75 HHVM 3.3.0.
76
77 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
78 support for them is somewhat less mature. There is experimental support for
79 Oracle and Microsoft SQL Server.
80
81 The supported versions are:
82
83 * MySQL 5.0.3 or later
84 * PostgreSQL 8.3 or later
85 * SQLite 3.3.7 or later
86 * Oracle 9.0.1 or later
87 * Microsoft SQL Server 2005 (9.00.1399)
88
89 == Upgrading ==
90
91 1.26 has several database changes since 1.25, and will not work without schema
92 updates. Note that due to changes to some very large tables like the revision
93 table, the schema update may take quite long (minutes on a medium sized site,
94 many hours on a large site).
95
96 If upgrading from before 1.11, and you are using a wiki as a commons
97 repository, make sure that it is updated as well. Otherwise, errors may arise
98 due to database schema changes.
99
100 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
101 new database fields are filled with data.
102
103 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
104 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
105 with MediaWiki 1.21.
106
107 Don't forget to always back up your database before upgrading!
108
109 See the file UPGRADE for more detailed upgrade instructions.
110
111 For notes on 1.25.x and older releases, see HISTORY.
112
113 == Online documentation ==
114
115 Documentation for both end-users and site administrators is available on
116 MediaWiki.org, and is covered under the GNU Free Documentation License (except
117 for pages that explicitly state that their contents are in the public domain):
118
119 https://www.mediawiki.org/wiki/Documentation
120
121 == Mailing list ==
122
123 A mailing list is available for MediaWiki user support and discussion:
124
125 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
126
127 A low-traffic announcements-only list is also available:
128
129 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
130
131 It's highly recommended that you sign up for one of these lists if you're
132 going to run a public MediaWiki, so you can be notified of security fixes.
133
134 == IRC help ==
135
136 There's usually someone online in #mediawiki on irc.freenode.net.