Extension:WikimediaApiPortalOAuth
WikimediaApiPortalOAuth Release status: stable |
|
---|---|
Implementation | User interface |
Description | Extension to provide user interface and API client support to the Wikimedia API Portal |
Author(s) | Dejan Savuljesku, Robert Vogel |
MediaWiki | 1.35+ |
License | GNU General Public License 2.0 or later |
Download | |
|
|
|
|
Quarterly downloads | 3 (Ranked 128th) |
Translate the WikimediaApiPortalOAuth extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
The WikimediaApiPortalOAuth extension is designed to connect the API Portal with the OAuth server on Meta-Wiki by providing a user interface for creating and managing OAuth 2.0 clients. This extension requires the ability to connect to a wiki acting as an OAuth controller and running OAuth 1.36 or later.
Download
editThe extension can be retrieved directly from Git [?]:
- Browse code
- Some extensions have tags for stable releases.
- Browse tags
- Select the tag
- Click "snapshot"
- Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
- Browse branches
- Select a branch name
- Click "Continue"
Extract the snapshot and place it in the extensions/WikimediaApiPortalOAuth/ directory of your MediaWiki installation.
If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikimediaApiPortalOAuth.git
Installation
editWikimediaApiPortalOAuth requires MediaWiki 1.35 or later.
- Download and place the file(s) in a directory called
WikimediaApiPortalOAuth
in yourextensions/
folder. - Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'WikimediaApiPortalOAuth' );
- Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration
editOn the wiki where WikimediaApiPortalOAuth is installed, set $wgWikimediaApiPortalOAuthMetaRestURL
to the URL for rest.php on the OAuth controller wiki. For example, in the case of the beta Wikimedia API Portal, the OAuth controller wiki is the beta instance of Meta-Wiki (https://meta.wikimedia.beta.wmflabs.org/w/rest.php
). To allow WikimediaApiPortalOAuth to make requests to the OAuth server, set $wgRestAllowCrossOriginCookieAuth
to true on the OAuth controller wiki.
Variable name | Required? | Default | Type | Description |
---|---|---|---|---|
$wgWikimediaApiPortalOAuthMetaRestURL
|
Optional | https://meta.wikimedia.org/w/rest.php
|
String | URL for rest.php on the OAuth controller wiki |
Usage
editThe Special:AppManagement page provides a simplified set of options for creating and managing OAuth 2.0 clients. The extension supports creating two types of OAuth 2.0 clients:
- owner-only clients
- clients with authorization code, client credentials, and refresh token grant types
For more information about OAuth 2.0, visit OAuth/For Developers.
This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |