Who Wrote That? for Wikipedia
Explore authorship and revision information visually and directly in Wikipedia articles. Powered by WikiWho.
WhoWroteThat is available as a browser extension for Firefox and Chrome.
Table of Contents:
- Supported Wikipedias
- Installation: for users, for developers
- Releasing the browser extension
- Debugging
- API Proxy
- Changelog
Supported Wikipedias
The tool works on Wikipedias supported by the WhoColor API: English, German, Basque, Turkish, and Spanish.
Installation for users
- Navigate to the extension's page for your browser:
- Click 'Add to Firefox' or 'Add to Chrome'.
- You will be prompted to grant permission to install the extension. Do so.
- After installation, when you go to any applicable Wikipedia article, there will be a new 'Who Wrote That?' link in the sidebar.
Installation for developers
- Clone the repo:
git clone https://github.com/wikimedia/whowrotethat.git - Go into its directory:
cd whowrotethat - Run
npm install -
- Firefox:
- Run
grunt run - This will open Firefox to a random page on English Wikipedia, and you should have the 'Who Wrote That?' link in the sidebar. See the web-ext 'run' docs for details of how to customize this command with environment variables.
- If you want to load the extension manually,
go to
about:debuggingand select the manifest file indist/extension/.
- Run
- Chrome:
- Run
grunt build - Go to
chrome://extensions/in Chrome - Click on 'Load unpacked', and choose the
WhoWroteThat/dist/extensiondirectory - Enable the extension, and go to any article on a supported Wikipedia.
- Run
- Firefox:
Releasing the browser extension
First update the version number in package.json
and ensure the changelog is up to date,
then tag the release in Git.
Run grunt (the default task only) to create
six zip files such as dist/extension_firefox/whowrotethat_for_wikipedia-0.2.0.0.zip
(three for beta and three for production; two for Chrome and four for Firefox).
These can be uploaded to the Firefox and Chrome browser stores.
Note that web extensions use four-digit version numbers, but WWT only uses the first three (the last is always zero; it's added by the Grunt task).
The *_source.zip files contain the source code,
for submission to the Firefox add-ons store (but not for Chrome).
Maintainers (i.e. any members of the wmf-commtech Google Group) can upload releases via:
- https://addons.mozilla.org/en-US/developers/addon/whowrotethat/edit
- https://chrome.google.com/webstore/developer/edit/ekkbnedhfelfaidbpaedaecjiokkionn
Firefox store localization
In addition to uploading the two zip files for a new release, it's also necessary to check that the Firefox store (or AMO) has the correct translations.
This is done with the grunt checkListings and grunt checkListings:beta commands.
These will report any discrepancies with the published names or descriptions of the extension,
which will need to be resolved manually (because there's no editing API for the browser store).
Localization is not required for Chrome,
because it reads all names and descriptions from the _locales/ files.
Debugging
The extension exposes a debugging namespace for testing purposes in wwtDebug.
These commands can be run in the console and will work on valid articles where the script loads.
Available commands are:
wwtDebug.resetWelcomePopup(): Resets the value of the stored 'shown' state of the popup. This is useful in case the popup was dismissed (which means it will never appear again) and for testing purposes, we want to display it again. After confirmation in the console, the popup will be displayed on subsequent refresh of the page.
API Proxy
To protect the privacy of our users, this tool routes all requests to the WhoColor API through a proxy at wikiwho.wmflabs.org. Requests can only be made from Wikipedias. Refer to api.wikiwho.net if you would like to test making requests to the APIs directly. The proxy VPS is documented on Wikitech.
Changelog
Please see CHANGELOG.md for an updated status and changes between releases.