Quickstatements2 as seen at https://tools.wmflabs.org/quickstatements/
| Image name | Parent image | Quickstatements version |
|---|---|---|
wikibase/quickstatements : latest |
php:7.2-apache | master |
| Variable | Default | Description |
|---|---|---|
WIKIBASE_HOST |
NONE | Host of wikibase instance as seen by QS container |
WB_PUBLIC_HOST_AND_PORT |
NONE | Host and port of wikibase as seen by the user's browser |
QS_PUBLIC_HOST_AND_PORT |
NONE | Host and port of QS as seen by the user's browser |
OAUTH_CONSUMER_KEY |
NONE | OAuth consumer key (obtained from wikibase) |
OAUTH_CONSUMER_SECRET |
NONE | OAuth consumer key (obtained from wikibase) |
PHP_TIMEZONE |
UTC | setting of php.ini date.timezone |
| Directory | Description |
|---|---|
/var/www/html/quickstatements |
Base quickstatements directory |
/var/www/html/quickstatements/public_html |
The Apache Root folder |
/var/www/html/magnustools |
Base magnustools directory |
| File | Description |
|---|---|
/templates/config.json |
Template for Quickstatements' config.json (substituted to /var/www/html/quickstatements/public_html/config.json at runtime) |
/templates/oauth.ini |
Template for Quickstatements' oauth.ini (substituted to /var/www/html/quickstatements/oauth.ini at runtime) |
/templates/php.ini |
php config (default provided sets date.timezone to prevent php complaining substituted to /usr/local/etc/php/conf.d/php.ini at runtime) |
In order for quickstatements to communicate with wikibase it needs to know where your instance is and how it can find it. This must be done by setting the ENV variable WIKIBASE_HOST. n.b. This should reflect how this container when running sees the wikibase container. For example the docker container alias like wikibase.svc.
The user's browser will also be redirected to the Wikibase instance and finally back to quickstatements. The address the user sees for the Wikibase may be different from how the running container sees it. For example: it may be running on localhost on a specific port. e.g. https://localhost:8181. This should be passed to the quickstatements container as WB_PUBLIC_HOST_AND_PORT
One must also know how this container will be visible to the user as well so it can ask the wikibase to redirect the user back here. This should be passed as QS_PUBLIC_HOST_AND_PORT
You can pass the consumer and secret token you got from the wikibase to this container as the environment variables OAUTH_CONSUMER_KEY and OAUTH_CONSUMER_SECRET. If you don't, docker-compose automatically handles this.
You can now test it works by navigating to https://<your quickstatements host> and logging in using the button top right.
You should be redirected to the wiki where you can authorize this Quickstatements to act on your behalf
Finally you should be redirected back to Quickstatements and you should appear logged in.
Use Quickstatements as normal with the Run button. Currently "Run in background" is not supported by this image.
If you see an error such as mw-oauth exception when trying to log in check that you have passed the right consumer token and secret token to quickstatements.
If you have changed the value of $wgSecretKey $wgOAuthSecretKey since you made the consumer you'll need to make another new consumer or reissue the secret token for the old one.
These images are build from the master branch of the quickstatements and magnustools repos.
For this reason the images may sometimes break due to upstream changes and need fixing.
Additional images for new releases do not need to be created.