Extension:DonateButton

MediaWiki extensions manual

DonateButton Release status: stable
Implementation	Skin , MyWiki , Hook
Description	Add button with link to a donation page
Author(s)	WikiMANNia (WikiForMentalk)
Latest version	1.7.0 (2025-01-07)
MediaWiki	1.35+
PHP	7.3.19+
License	GNU General Public License 2.0 or later
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net .
Parameters $wgDonateButton $wgDonateButtonURL
Hooks used BeforePageDisplay SkinAfterPortlet SkinBuildSidebar

The DonateButton extension allows a custom addition of a button with link to a donation page to a wikis sidebar . The button image is automatically adapted according to the language selection.

Use

Install the extension and upload to the wiki a file as specified in $wgDonateButtonFilename. By entering * donatebutton in the MediaWiki:Sidebar , the button can be placed individually.

Installation

For recent versions of MediaWiki (1.35+), use the following instruction:

• Check-out the sources with git clone https://github.com/WikiMANNia/MediaWiki-Extension-DonateButton.git and place the file(s) in a directory called DonateButton in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'DonateButton' );
  

• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Installation for older versions of MediaWiki

For MediaWiki 1.25-1.34, replace the above-mentioned "git clone" command with the following: git clone -b REL1_25 https://github.com/WikiMANNia/MediaWiki-Extension-DonateButton.git

Configuration options

Enable the DonateButton. Default is false.

$wgDonateButton = true;

An image with this name should be uploaded on each wiki of your wikifarm.

• Specify the link to a donation page.

$wgDonateButtonURL = "https://example.org/yourdonationpage.php?lang=";

The link is automatically completed by the code of the language selected by the user or alternatively by the $wgLanguageCode variable.

Localisation

The extension is provided in "de", "en", "es", "fr", "he", "it", "nl", "pt", "ru".

See also

• An alternative to the unmaintained extensions SidebarDonateBox and DonateBoxInSidebar .

Remarks

• Branch REL1_25 works from REL1_25 and has been tested up to MediaWiki version REL1_37 .
• Branch REL1_35 works from REL1_35 and has been tested up to MediaWiki version REL1_43 .
• The extension was tested with the following MediaWiki versions: 1.35.14, 1.39.11, 1.40.2, 1.41.2, 1.42.3, 1.43.0
• Configuration of a donation link in skin Minerva Neue .
• Version 1.5 has some Refactoring:

  Changed “configuration schema”, replaced manifest version 1 with version 2 and changed the prefix of the configuration variables from default to wm.

  Replaced class “DonateButtonHooks” (extends “Hooks”) with class implements interfaces.

• Version 1.5.1 adds a dirty hack for skin Timeless.
• Version 1.6.0 has added support for skin Monaco.
• Version 1.6.1 changed the prefix of the configuration variables back to wg.
• Version 1.7.0 has added support for skin Citizen.