Difference between revisions of "MediaWiki/Upgrade/REL1 25 to REL1 26"
(Adds section on preferences) |
m (Freephile moved page MediaWiki/Upgrade/REL1 25 to REL1 26 to MediaWiki/Upgrade/REL1 25 to REL1 26: organize) |
||
(16 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | |||
− | |||
Last updated in 2008, it was time to revisit this page and make some new notes. Even though the README, UPGRADE and online help are very detailed, I find it helpful to note my personal preferences, observations, and clarifications. Still, for the do-it-yourself types, the [[mw:Manual:Upgrading#Using_Git|official docs]] are the best resource. If you need professional help with MediaWiki, then contact [[User:Freephile|Greg Rundlett]] | Last updated in 2008, it was time to revisit this page and make some new notes. Even though the README, UPGRADE and online help are very detailed, I find it helpful to note my personal preferences, observations, and clarifications. Still, for the do-it-yourself types, the [[mw:Manual:Upgrading#Using_Git|official docs]] are the best resource. If you need professional help with MediaWiki, then contact [[User:Freephile|Greg Rundlett]] | ||
The process obviously started with downloading the source from the web. However, since the wikipedia project uses the continuous integration method of development (meaning they always run their own latest code), I follow the same practice and run off either the latest release branch or master from the [[git]] repository. So, I simply did a <code>composer update --no-dev && git fetch</code> to prepare for an upgrade. | The process obviously started with downloading the source from the web. However, since the wikipedia project uses the continuous integration method of development (meaning they always run their own latest code), I follow the same practice and run off either the latest release branch or master from the [[git]] repository. So, I simply did a <code>composer update --no-dev && git fetch</code> to prepare for an upgrade. | ||
− | + | == Consult the release notes == | |
− | Before doing anything, stop and consult the release notes supplied with the new | + | Before doing anything, stop and consult the [[mw:Release_notes/1.26#MediaWiki_1.26.2|release notes]] supplied with the new |
version of the software. This detail bug fixes, new features and functionality, | version of the software. This detail bug fixes, new features and functionality, | ||
and any particular points that may need to be noted during the upgrade | and any particular points that may need to be noted during the upgrade | ||
procedure. There was a lot here, although nothing that impacted the function of my installation. | procedure. There was a lot here, although nothing that impacted the function of my installation. | ||
− | + | == Backup first == | |
I copied my filesystem as a backup and testing ground. | I copied my filesystem as a backup and testing ground. | ||
Line 18: | Line 16: | ||
For the database, I have a backup script that in addition to timed backups, will create a spot backup on demand: <code>~/bin/backup.db.sh mediawiki</code> | For the database, I have a backup script that in addition to timed backups, will create a spot backup on demand: <code>~/bin/backup.db.sh mediawiki</code> | ||
− | + | == Perform the file upgrade == | |
− | + | For extensions that support the [[mw:Manual:Extension_registration|new extension registration mechanism]] you can change the old 'requires' with a call to the 'wfLoadExtension' function <code>require_once\( *"\$IP/extensions/.*/([^/]*)" * \); wfLoadExtension( '\1' );</code> | |
With the software downloaded (git fetch), and a check to see if you've modified anything (git status), you can simply switch the branch you're on <code>git checkout -b REL1_26 origin/REL1_26</code> and then do the database upgrade. | With the software downloaded (git fetch), and a check to see if you've modified anything (git status), you can simply switch the branch you're on <code>git checkout -b REL1_26 origin/REL1_26</code> and then do the database upgrade. | ||
Line 26: | Line 24: | ||
You must preserve: | You must preserve: | ||
− | + | # The LocalSettings.php file | |
− | + | # DatabaseSettings file, where it exists | |
− | + | # The extensions directory | |
− | + | # The images directory | |
If using an alternative uploads directory, preserve this; and if using custom skins, preserve these too. The core code is now updated. | If using an alternative uploads directory, preserve this; and if using custom skins, preserve these too. The core code is now updated. | ||
− | + | == Perform the database upgrade == | |
− | |||
− | |||
− | |||
From the command line, browse to the maintenance directory and run the | From the command line, browse to the maintenance directory and run the | ||
Line 49: | Line 44: | ||
</pre> | </pre> | ||
− | + | == Check configuration settings == | |
The names of configuration variables, and their default values and purposes, | The names of configuration variables, and their default values and purposes, | ||
Line 55: | Line 50: | ||
with $wgEnableUploads in later versions. When upgrading, consult the release | with $wgEnableUploads in later versions. When upgrading, consult the release | ||
notes to check for configuration changes which would alter the expected | notes to check for configuration changes which would alter the expected | ||
− | + | behavior of MediaWiki. | |
− | + | == Change the wiki pointer == | |
− | In order to quickly upgrade, revert or take the site offline, you can simply use a symbolic link and point that to the correct target folder. However, note that this can present problems for your extensions when <code>$IP</code> is not defined correctly | + | In order to quickly upgrade, revert or take the site offline, you can simply use a symbolic link and point that to the correct target folder. However, note that this can present problems for your extensions when <code>$IP</code> is not defined correctly due to the nature of symbolic links. |
− | + | == Test == | |
It makes sense to test your wiki immediately following any kind of maintenance | It makes sense to test your wiki immediately following any kind of maintenance | ||
Line 67: | Line 62: | ||
and quirks which reveal themselves. | and quirks which reveal themselves. | ||
− | === Extension and Skin Upgrades | + | # [[User:Freephile/Books/Organic_Gardening]] to test [[Collections]] |
+ | # [[Tooltips]] to test Semantic MediaWiki info parser function | ||
+ | # [[Terminology]] to test the Lingo extension | ||
+ | # [[Visual editor]] | ||
+ | # [[Svg]] for the SVG-Edit extension | ||
+ | # [[Cloning]] for the PDF Handler extension (show pdf file as thumbnail) | ||
+ | # [[Categories]] for the Wiki Category Tag Cloud extension | ||
+ | # [[:Template:Categorypage]] or [[:Category:Wiki]] for the Category Tree extension | ||
+ | # [[Special:ReplaceText]] for the Replace Text extension. Note that this extension can use regex like <code><nowiki><abbr title="[^"]+">(.*)<\/abbr></nowiki></code> where you can strip out tags and replace with $1 | ||
+ | |||
+ | == Extension and Skin Upgrades == | ||
− | Your MediaWiki site will contain many extensions to provide extra functionality. You also have one or more skins installed. Those need to be upgraded independently since they are not distributed with the core. The [[Special:Version]] page will list the ones in use, so go through the list one at a time and check for upgrades. | + | Your MediaWiki site will contain many [[MediaWiki/Extensions|extensions]] to provide extra functionality. You also have one or more skins installed. Those need to be upgraded independently since they are not distributed with the core (although many are bundled if you download a tarball). The [[Special:Version]] page will list the ones in use, so go through the list one at a time and check for upgrades. |
For those [https://gerrit.wikimedia.org/r/#/admin/projects/?filter=mediawiki%252Fextensions%252F extensions available in git] you can fetch the latest updates to the code with something like | For those [https://gerrit.wikimedia.org/r/#/admin/projects/?filter=mediawiki%252Fextensions%252F extensions available in git] you can fetch the latest updates to the code with something like | ||
<source lang="bash"> | <source lang="bash"> | ||
+ | release=REL1_26 | ||
+ | # work within the extensions directory so as not to conflict with the main composer.json | ||
cd extensions | cd extensions | ||
base=`pwd`; | base=`pwd`; | ||
Line 79: | Line 86: | ||
echo "fetching $ext"; | echo "fetching $ext"; | ||
git fetch; | git fetch; | ||
+ | # checkout the new release branch you want | ||
+ | git checkout $release; | ||
+ | # and update dependencies if project uses composer | ||
+ | if [ -f "./composer.json" ]; then | ||
+ | composer update; | ||
+ | fi | ||
cd $base; | cd $base; | ||
done | done | ||
</source> | </source> | ||
− | Also, if you don't even know whether there are submodules in use, you can search for those by looking for .gitmodules or .git '''files''' <code>find . -type f -name .git</code> | + | Also, if you don't even know whether there are submodules in use, you can search for those by looking for .gitmodules or .git '''files''' <code>find . -type f -name .git</code> And if you want to know which extensions may be using composer, you can check <code>find . -maxdepth 2 -name composer.json |xargs grep -l '"require":'</code> |
+ | |||
+ | === Bad Behavior === | ||
+ | * not in gerrit | ||
+ | * added a whitelist.ini file for [http://bad-behavior.ioerror.us/ bad-behavior] to avoid the file not found error | ||
+ | * upgraded bad-behavior 2.2.13 to 2.2.17 | ||
+ | * deleted all the log table entries because they were from 2014 | ||
+ | |||
+ | === Bootstrap === | ||
+ | * I chose to install the Bootstrap extension, which will allow me to use skins based on Bootstrap. E.g. Chameleon | ||
+ | <source lang="bash"> | ||
+ | composer require "mediawiki/bootstrap:~1.0" | ||
+ | composer update | ||
+ | </source> | ||
+ | |||
+ | === Category Tree === | ||
+ | [[CategoryTree]] | ||
+ | |||
+ | === [[mw:Extension:Cite|Cite]] === | ||
+ | [[Citations]] | ||
+ | * upgraded to (e26565f) 2016-01-08T17:16:58 from null | ||
+ | * change the .git repo from https://gerrit.wikimedia.org/r/p/mediawiki/core.git to https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Cite | ||
+ | * delete the Cite dir and clone the new repo | ||
+ | * git checkout REL1_26 | ||
+ | * comment the old requires (there used to be two: Cite/Cite.php and Cite/SpecialCite.php) | ||
+ | * wfLoadExtension( 'Cite' ); | ||
+ | * The second extension can be installed separately now, and provides the SpecialPage | ||
+ | * git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/CiteThisPage.git | ||
+ | * git checkout REL1_26 | ||
+ | * wfLoadExtension( 'CiteThisPage' ); | ||
+ | |||
+ | === Collections === | ||
+ | [[Collections]] | ||
+ | * The new config does save books, and renders to pdf (using pediapress) but the output needs some work to be truly professional looking. | ||
+ | * If there is an error rendering PDFs, try again. It's probably due to the low-capacity public server of PediaPress | ||
+ | |||
+ | === Delete Batch === | ||
+ | * upgraded to 1.5.0 (3870998) 2015-09-29T17:32:00 from 1.4 (non-git) | ||
+ | [[Delete]] | ||
+ | |||
+ | === [[mw:Extension:DynamicPageList_(third-party)|DynamicPageList (third party)]] === | ||
+ | * upgraded to 2.3.0 (fa2f83b) 2015-06-22T10:40:33 | ||
+ | [[Dynamic content]] | ||
+ | |||
+ | === Gadgets === | ||
+ | [[Gadgets]] | ||
+ | * upgraded to REL1_26 (58f236d) 2015-11-23T16:22:00 from (a775200) 2014-01-26T12:22:15 | ||
+ | * compatible with wfLoadExtension | ||
+ | |||
+ | === Html2Wiki === | ||
+ | [[Html2Wiki]] | ||
+ | * disabled temporarily | ||
+ | * re-enabled and tested | ||
+ | |||
+ | === Interwiki === | ||
+ | [[Interwiki links]] | ||
+ | * bundled | ||
+ | * upgraded to 3.0 20140719 (6ed9dc3) 2015-11-23T16:39:17 from 2.2 20120425 (83fa077) 2013-03-31T14:51:05 | ||
+ | * Since the freephile wiki is served in secure mode (https), and all my interwiki links were hardcoded to 'http', I'd be unfairly dumping visitors out to the non-encrypted web. Interwiki since v1.18+ supports Protocol Relative URLs (PRURLs), so I updated my interwiki table converting all links to use // It's not possible to browse the freephile wiki in plain http mode (because our server is configured to always redirect to secure mode), so you can't really link off to an insecure website via the interwiki table now. But, if we ever decide to serve plain http, then our interwiki links will maintain your insecurity. | ||
+ | <source lang="sql"> | ||
+ | SELECT * FROM mediawiki.interwiki; | ||
+ | UPDATE mediawiki.interwiki | ||
+ | SET iw_url = REPLACE(iw_url, 'http://', '//') | ||
+ | LIMIT 200; | ||
+ | </source> | ||
+ | |||
+ | === Lingo === | ||
+ | * The Lingo extension was installed via Composer | ||
+ | * Creates new [[Terminology]] page | ||
+ | |||
+ | === [[mw:Extension:Lockdown|Lockdown]] === | ||
+ | * upgraded to REL1_26 (c0f9986) 2015-09-29T17:56:04 from (db7023e) 2012-12-31T16:48:02 | ||
+ | * still spews a million PHP Notices | ||
+ | |||
+ | === [[mw:Extension:Nuke|Nuke]] === | ||
+ | [[Delete]] | ||
+ | * Installed v1.2.0 (5763d10) 2015-11-23T16:46:18 | ||
+ | * There were several broken Html2wiki import images which I wanted to use this extension to remove from the wiki. I still had to delete them by hand, but at least the 'recent changes' view on the main page is now fixed. The Nuke extension is still a useful tool | ||
+ | |||
+ | === Page Schemas === | ||
+ | was at 0.4.5 (c60b6fc) 2015-06-22T14:38:11 from Semantic Bundle. Disabled | ||
+ | |||
+ | === [[mw:Extension:ParserFunctions|Parser Functions]] === | ||
+ | [[Parser functions]] | ||
+ | * (bundled) | ||
+ | * upgraded to 1.6.0 (81eca7c) 2015-11-23T17:18:03 from 1.6.0 (738403b) 2014-10-11T18:09:18 | ||
+ | |||
+ | === Parsoid === | ||
+ | deactivated 0.2.0 (b23043f) 2014-10-11T18:09:35 | ||
+ | |||
+ | === PDF Handler === | ||
+ | [[Pdf]] | ||
+ | * upgraded to (6d8477d) 2015-11-23T17:19:41 from (f7044ec) 2014-01-21T20:50:35 | ||
+ | * installed poppler-utils on Ubuntu | ||
+ | <source lang="bash"> | ||
+ | which gs convert pdfinfo # tells if you have the right dependencies | ||
+ | </source> | ||
+ | * added link to example test page | ||
+ | |||
+ | |||
+ | === Scribunto === | ||
+ | [[Lua]] | ||
+ | * from 184a649) 2013-10-23T12:23:02 | ||
+ | |||
+ | |||
+ | === [[mw:Semantic Bundle|Semantic Bundle]] === | ||
+ | * upgraded to 1.9.2 (97c0b0a) 2014-01-03T15:33:07 from 1.8.0.5.3 (97c0b0a) 2014-01-03T15:33:07 | ||
+ | * but then decided to use straight SMW with Composer | ||
+ | |||
+ | === [https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Semantic MediaWiki] === | ||
+ | [[Metadata]] | ||
+ | * upgraded from 1.8.0.5 (fbd7570) 2013-04-06T20:44:28 to 2.3.1 | ||
+ | * deleted the now unused PageSchemas and SemanticBundle directories. | ||
+ | * {{@todo}} Need to find out whether I should delete or do anything with the following which were bundled. | ||
+ | ** ./SemanticCompoundQueries | ||
+ | ** ./SemanticDrilldown | ||
+ | ** ./SemanticForms | ||
+ | ** ./SemanticFormsInputs | ||
+ | ** ./SemanticImageInput | ||
+ | ** ./SemanticInternalObjects | ||
+ | ** ./SemanticMaps | ||
+ | ** ./SemanticResultFormats | ||
+ | ** ./SemanticTasks | ||
+ | ** ./SemanticWatchlist | ||
+ | * When you look at the composer.json file, it recommends semantic-forms and semantic-result-formats | ||
+ | |||
+ | |||
+ | === [[mw:Extension:SVGEdit|SVGEdit]] === | ||
+ | [[Svg]] | ||
+ | * upgraded to the latest git from (00b9b30) 2013-11-22T16:46:23 | ||
+ | |||
+ | === SyntaxHighlight_GeSHi === | ||
+ | [[Syntax Highlighting]] | ||
+ | * Note this extension now uses Pygments | ||
+ | * Initially had difficulty with this throwing all kinds of notices and breaking things like the edit window, probably because I was on REL1_25 | ||
+ | * But still after upgrading to REL1_26 it caused a 500 error. | ||
+ | * Then I noticed that you need to composer update | ||
+ | * upgraded to 2.0 (a15f02e) 2015-12-12T07:49:03 | ||
+ | * and Parsoid and VisualEditor | ||
+ | |||
+ | === Tooltip === | ||
+ | [[Tooltips]] | ||
+ | * This interesting extension fell out of maintenance, and is superseded by the Lingo extension. | ||
+ | |||
+ | |||
+ | === User Merge and Delete === | ||
+ | [[Merge]] | ||
+ | * upgraded to 1.9.0 (8a4faae) 2015-09-29T18:53:44 from 1.7 (9cdb625) 2013-04-04T16:10:25 | ||
+ | |||
+ | |||
+ | === Visual editor === | ||
+ | [[Visual editor]] | ||
+ | * completely updated (new git repo) | ||
+ | * upgraded to 0.1.0 (34a21d8) 2015-11-10T07:15:06 from 0.1.0 (c416e78) 2014-05-07T17:36:05 | ||
+ | * Followed the complete install instructions which includes deprecating the Parsoid extension. Node was [[mw:Parsoid/Installing_Node|already installed]] | ||
+ | * previously and was new enough (running v0.10.40) | ||
+ | |||
+ | === Wiki Category Tag Cloud === | ||
+ | [[Categories]] | ||
+ | * upgraded to 1.2.0 (e8c04a8) 2015-09-29T18:58:37 from 1.1 | ||
+ | |||
+ | |||
+ | === [[mw:Extension:WikiEditor|WikiEditor]] === | ||
+ | [[Text Editor]] | ||
+ | * upgraded to 0.5.0 (72db6c7) 2015-09-29T18:59:11 from 0.4.0 (b13e25d) 2014-10-11T18:26:25 | ||
+ | * added options within LocalSettings | ||
+ | |||
+ | |||
+ | == Gadgets == | ||
+ | === wikEd === | ||
+ | * For the wikEd [https://freephile.org/wiki/Special:Gadgets gadget], I had to adjust the javascript and also add [ResourceLoader] to the definition | ||
+ | |||
+ | === Toggle === | ||
+ | For the [[mw:Snippets/Toggle_between_dropdown_menus_and_tabs|Menu Tab Toggle gadget]], I had to update the definition. | ||
== Preferences == | == Preferences == | ||
− | Oftentimes, you will need to test and check | + | Oftentimes, you will need to test and check [[Special:Preferences]] in combination with core, skins, extensions and [[Gadgets]] upgrades. |
− | + | == Debug == | |
When things don't quite work as expected, you're left to figure out why. There are [[mw:Manual:How to debug|several debugging options]] that can assist you. | When things don't quite work as expected, you're left to figure out why. There are [[mw:Manual:How to debug|several debugging options]] that can assist you. | ||
[[Category:Wiki]] | [[Category:Wiki]] |
Latest revision as of 11:36, 14 July 2017
Last updated in 2008, it was time to revisit this page and make some new notes. Even though the README, UPGRADE and online help are very detailed, I find it helpful to note my personal preferences, observations, and clarifications. Still, for the do-it-yourself types, the official docs are the best resource. If you need professional help with MediaWiki, then contact Greg Rundlett
The process obviously started with downloading the source from the web. However, since the wikipedia project uses the continuous integration method of development (meaning they always run their own latest code), I follow the same practice and run off either the latest release branch or master from the git repository. So, I simply did a composer update --no-dev && git fetch
to prepare for an upgrade.
Contents
- 1 Consult the release notes
- 2 Backup first
- 3 Perform the file upgrade
- 4 Perform the database upgrade
- 5 Check configuration settings
- 6 Change the wiki pointer
- 7 Test
- 8 Extension and Skin Upgrades
- 8.1 Bad Behavior
- 8.2 Bootstrap
- 8.3 Category Tree
- 8.4 Cite
- 8.5 Collections
- 8.6 Delete Batch
- 8.7 DynamicPageList (third party)
- 8.8 Gadgets
- 8.9 Html2Wiki
- 8.10 Interwiki
- 8.11 Lingo
- 8.12 Lockdown
- 8.13 Nuke
- 8.14 Page Schemas
- 8.15 Parser Functions
- 8.16 Parsoid
- 8.17 PDF Handler
- 8.18 Scribunto
- 8.19 Semantic Bundle
- 8.20 Semantic MediaWiki
- 8.21 SVGEdit
- 8.22 SyntaxHighlight_GeSHi
- 8.23 Tooltip
- 8.24 User Merge and Delete
- 8.25 Visual editor
- 8.26 Wiki Category Tag Cloud
- 8.27 WikiEditor
- 9 Gadgets
- 10 Preferences
- 11 Debug
Consult the release notes[edit | edit source]
Before doing anything, stop and consult the release notes supplied with the new version of the software. This detail bug fixes, new features and functionality, and any particular points that may need to be noted during the upgrade procedure. There was a lot here, although nothing that impacted the function of my installation.
Backup first[edit | edit source]
I copied my filesystem as a backup and testing ground.
For the database, I have a backup script that in addition to timed backups, will create a spot backup on demand: ~/bin/backup.db.sh mediawiki
Perform the file upgrade[edit | edit source]
For extensions that support the new extension registration mechanism you can change the old 'requires' with a call to the 'wfLoadExtension' function require_once\( *"\$IP/extensions/.*/([^/]*)" * \); wfLoadExtension( '\1' );
With the software downloaded (git fetch), and a check to see if you've modified anything (git status), you can simply switch the branch you're on git checkout -b REL1_26 origin/REL1_26
and then do the database upgrade.
You must preserve:
- The LocalSettings.php file
- DatabaseSettings file, where it exists
- The extensions directory
- The images directory
If using an alternative uploads directory, preserve this; and if using custom skins, preserve these too. The core code is now updated.
Perform the database upgrade[edit | edit source]
From the command line, browse to the maintenance directory and run the update.php script to check and update the schema. This will insert missing tables, update existing tables, and move data around as needed. In most cases, this is successful and nothing further needs to be done.
cd wiki/maintenance/ ls php -q ./update.php
Check configuration settings[edit | edit source]
The names of configuration variables, and their default values and purposes, can change between release branches, e.g. $wgDisableUploads in 1.4 is replaced with $wgEnableUploads in later versions. When upgrading, consult the release notes to check for configuration changes which would alter the expected behavior of MediaWiki.
Change the wiki pointer[edit | edit source]
In order to quickly upgrade, revert or take the site offline, you can simply use a symbolic link and point that to the correct target folder. However, note that this can present problems for your extensions when $IP
is not defined correctly due to the nature of symbolic links.
Test[edit | edit source]
It makes sense to test your wiki immediately following any kind of maintenance procedure, and especially after upgrading; check that page views and edits work normally and that special pages continue to function, etc. and correct errors and quirks which reveal themselves.
- User:Freephile/Books/Organic_Gardening to test Collections
- Tooltips to test Semantic MediaWiki info parser function
- Terminology to test the Lingo extension
- Visual editor
- Svg for the SVG-Edit extension
- Cloning for the PDF Handler extension (show pdf file as thumbnail)
- Categories for the Wiki Category Tag Cloud extension
- Template:Categorypage or Category:Wiki for the Category Tree extension
- Special:ReplaceText for the Replace Text extension. Note that this extension can use regex like
<abbr title="[^"]+">(.*)<\/abbr>
where you can strip out tags and replace with $1
Extension and Skin Upgrades[edit | edit source]
Your MediaWiki site will contain many extensions to provide extra functionality. You also have one or more skins installed. Those need to be upgraded independently since they are not distributed with the core (although many are bundled if you download a tarball). The Special:Version page will list the ones in use, so go through the list one at a time and check for upgrades.
For those extensions available in git you can fetch the latest updates to the code with something like
release=REL1_26
# work within the extensions directory so as not to conflict with the main composer.json
cd extensions
base=`pwd`;
for ext in `find . -type d -name .git | sed 's/.git//' `; do
cd $ext;
echo "fetching $ext";
git fetch;
# checkout the new release branch you want
git checkout $release;
# and update dependencies if project uses composer
if [ -f "./composer.json" ]; then
composer update;
fi
cd $base;
done
Also, if you don't even know whether there are submodules in use, you can search for those by looking for .gitmodules or .git files find . -type f -name .git
And if you want to know which extensions may be using composer, you can check find . -maxdepth 2 -name composer.json |xargs grep -l '"require":'
Bad Behavior[edit | edit source]
- not in gerrit
- added a whitelist.ini file for bad-behavior to avoid the file not found error
- upgraded bad-behavior 2.2.13 to 2.2.17
- deleted all the log table entries because they were from 2014
Bootstrap[edit | edit source]
- I chose to install the Bootstrap extension, which will allow me to use skins based on Bootstrap. E.g. Chameleon
composer require "mediawiki/bootstrap:~1.0"
composer update
Category Tree[edit | edit source]
Cite[edit | edit source]
- upgraded to (e26565f) 2016-01-08T17:16:58 from null
- change the .git repo from https://gerrit.wikimedia.org/r/p/mediawiki/core.git to https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Cite
- delete the Cite dir and clone the new repo
- git checkout REL1_26
- comment the old requires (there used to be two: Cite/Cite.php and Cite/SpecialCite.php)
- wfLoadExtension( 'Cite' );
- The second extension can be installed separately now, and provides the SpecialPage
- git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/CiteThisPage.git
- git checkout REL1_26
- wfLoadExtension( 'CiteThisPage' );
Collections[edit | edit source]
- The new config does save books, and renders to pdf (using pediapress) but the output needs some work to be truly professional looking.
- If there is an error rendering PDFs, try again. It's probably due to the low-capacity public server of PediaPress
Delete Batch[edit | edit source]
- upgraded to 1.5.0 (3870998) 2015-09-29T17:32:00 from 1.4 (non-git)
DynamicPageList (third party)[edit | edit source]
- upgraded to 2.3.0 (fa2f83b) 2015-06-22T10:40:33
Gadgets[edit | edit source]
- upgraded to REL1_26 (58f236d) 2015-11-23T16:22:00 from (a775200) 2014-01-26T12:22:15
- compatible with wfLoadExtension
Html2Wiki[edit | edit source]
- disabled temporarily
- re-enabled and tested
Interwiki[edit | edit source]
- bundled
- upgraded to 3.0 20140719 (6ed9dc3) 2015-11-23T16:39:17 from 2.2 20120425 (83fa077) 2013-03-31T14:51:05
- Since the freephile wiki is served in secure mode (https), and all my interwiki links were hardcoded to 'http', I'd be unfairly dumping visitors out to the non-encrypted web. Interwiki since v1.18+ supports Protocol Relative URLs (PRURLs), so I updated my interwiki table converting all links to use // It's not possible to browse the freephile wiki in plain http mode (because our server is configured to always redirect to secure mode), so you can't really link off to an insecure website via the interwiki table now. But, if we ever decide to serve plain http, then our interwiki links will maintain your insecurity.
SELECT * FROM mediawiki.interwiki;
UPDATE mediawiki.interwiki
SET iw_url = REPLACE(iw_url, 'http://', '//')
LIMIT 200;
Lingo[edit | edit source]
- The Lingo extension was installed via Composer
- Creates new Terminology page
Lockdown[edit | edit source]
- upgraded to REL1_26 (c0f9986) 2015-09-29T17:56:04 from (db7023e) 2012-12-31T16:48:02
- still spews a million PHP Notices
Nuke[edit | edit source]
- Installed v1.2.0 (5763d10) 2015-11-23T16:46:18
- There were several broken Html2wiki import images which I wanted to use this extension to remove from the wiki. I still had to delete them by hand, but at least the 'recent changes' view on the main page is now fixed. The Nuke extension is still a useful tool
Page Schemas[edit | edit source]
was at 0.4.5 (c60b6fc) 2015-06-22T14:38:11 from Semantic Bundle. Disabled
Parser Functions[edit | edit source]
- (bundled)
- upgraded to 1.6.0 (81eca7c) 2015-11-23T17:18:03 from 1.6.0 (738403b) 2014-10-11T18:09:18
Parsoid[edit | edit source]
deactivated 0.2.0 (b23043f) 2014-10-11T18:09:35
PDF Handler[edit | edit source]
- upgraded to (6d8477d) 2015-11-23T17:19:41 from (f7044ec) 2014-01-21T20:50:35
- installed poppler-utils on Ubuntu
which gs convert pdfinfo # tells if you have the right dependencies
- added link to example test page
Scribunto[edit | edit source]
- from 184a649) 2013-10-23T12:23:02
Semantic Bundle[edit | edit source]
- upgraded to 1.9.2 (97c0b0a) 2014-01-03T15:33:07 from 1.8.0.5.3 (97c0b0a) 2014-01-03T15:33:07
- but then decided to use straight SMW with Composer
Semantic MediaWiki[edit | edit source]
- upgraded from 1.8.0.5 (fbd7570) 2013-04-06T20:44:28 to 2.3.1
- deleted the now unused PageSchemas and SemanticBundle directories.
- todo Need to find out whether I should delete or do anything with the following which were bundled.
- ./SemanticCompoundQueries
- ./SemanticDrilldown
- ./SemanticForms
- ./SemanticFormsInputs
- ./SemanticImageInput
- ./SemanticInternalObjects
- ./SemanticMaps
- ./SemanticResultFormats
- ./SemanticTasks
- ./SemanticWatchlist
- When you look at the composer.json file, it recommends semantic-forms and semantic-result-formats
SVGEdit[edit | edit source]
- upgraded to the latest git from (00b9b30) 2013-11-22T16:46:23
SyntaxHighlight_GeSHi[edit | edit source]
- Note this extension now uses Pygments
- Initially had difficulty with this throwing all kinds of notices and breaking things like the edit window, probably because I was on REL1_25
- But still after upgrading to REL1_26 it caused a 500 error.
- Then I noticed that you need to composer update
- upgraded to 2.0 (a15f02e) 2015-12-12T07:49:03
- and Parsoid and VisualEditor
Tooltip[edit | edit source]
- This interesting extension fell out of maintenance, and is superseded by the Lingo extension.
User Merge and Delete[edit | edit source]
- upgraded to 1.9.0 (8a4faae) 2015-09-29T18:53:44 from 1.7 (9cdb625) 2013-04-04T16:10:25
Visual editor[edit | edit source]
- completely updated (new git repo)
- upgraded to 0.1.0 (34a21d8) 2015-11-10T07:15:06 from 0.1.0 (c416e78) 2014-05-07T17:36:05
- Followed the complete install instructions which includes deprecating the Parsoid extension. Node was already installed
- previously and was new enough (running v0.10.40)
Wiki Category Tag Cloud[edit | edit source]
- upgraded to 1.2.0 (e8c04a8) 2015-09-29T18:58:37 from 1.1
WikiEditor[edit | edit source]
- upgraded to 0.5.0 (72db6c7) 2015-09-29T18:59:11 from 0.4.0 (b13e25d) 2014-10-11T18:26:25
- added options within LocalSettings
Gadgets[edit | edit source]
wikEd[edit | edit source]
- For the wikEd gadget, I had to adjust the javascript and also add [ResourceLoader] to the definition
Toggle[edit | edit source]
For the Menu Tab Toggle gadget, I had to update the definition.
Preferences[edit | edit source]
Oftentimes, you will need to test and check Special:Preferences in combination with core, skins, extensions and Gadgets upgrades.
Debug[edit | edit source]
When things don't quite work as expected, you're left to figure out why. There are several debugging options that can assist you.