This is `boz-mw`, __another MediaWiki API handler in PHP__ with batteries included! It has a tons of features that will make your head spin!
This is a library to interact with MediaWiki and Wikibase APIs. There are also some [command line tools](https://gitpull.it/source/boz-mw/browse/master/tools/#boz-mw-command-line-tools).
## Download
- git clone https://gitpull.it/source/boz-mw.git
+````
+git clone https://gitpull.it/source/boz-mw.git
+````
## Command line tools
See [the command line tools](https://gitpull.it/source/boz-mw/browse/master/tools/#boz-mw-command-line-tools).
### Command line script `replace.php`
The [replace.php](https://gitpull.it/source/boz-mw/browse/master/tools/#replace-script-tt-class-remarkup) allows you to do some sobstitutions in a wiki.
### Command line script `mega-export.php`
The [mega-export.php](https://gitpull.it/source/boz-mw/browse/master/tools/#mega-export-tt-class-remarkup) allows you to export the _full_ page history of whatever page.
## API framework showcase
Here some usage examples.
### Basic API query
To obtain a simple information from the server (no continuation support):
```
<?php
require 'boz-mw/autoload.php';
// load it.wiki
$wiki = \wm\WikipediaIt::instance();
$response =
$wiki->fetch( [
'action' => 'query',
'prop' => 'info',
'titles' => [
'Pagina principale'
]
] );
print_r( $response );
```
### API query with continuation
To obtain a long result set from the server (with continuation support):
```
+<?php
+require 'boz-mw/autoload.php';
+
$wiki = \wm\WikipediaIt::instance();
$queries =
$wiki->createQuery( [
'action' => 'query',
'list' => 'categorymembers',
'cmtitle' => 'Categoria:Software con licenza GNU GPL',
] );
foreach( $queries as $query ) {
print_r( $query );
}
```
### Login and Edit API query
```
+<?php
+require 'boz-mw/autoload.php';
+
$wiki = \wm\WikipediaIt::instance();
$user = '';
$password = '';
$wiki->login( $user, $password );
$wiki->edit( [
'title' => 'Special:Nothing',
'text' => 'My wikitext',
'summary' => 'My edit summary',
] );
```
Note that you can also call `login()` without parameters if you specify a global username and password on the top of your script:
```
\mw\API::$DEFAULT_USERNAME = '':
\mw\API::$DEFAULT_PASSWORD = '';
```
### Wikidata SPARQL query
What if you want to list all the [cats from Wikidata](https://query.wikidata.org/#%23Cats%0ASELECT%20%3Fitem%20%3FitemLabel%20%0AWHERE%20%0A%7B%0A%20%20%3Fitem%20wdt%3AP31%20wd%3AQ146.%0A%20%20SERVICE%20wikibase%3Alabel%20%7B%20bd%3AserviceParam%20wikibase%3Alanguage%20%22%5BAUTO_LANGUAGE%5D%2Cen%22.%20%7D%0A%7D)?
-See the [`ContentDisposition`](include/class-network\ContentDisposition.php) class for some other constructors.
+Eventually see the [`ContentDisposition`](https://gitpull.it/source/boz-mw/browse/master/include/class-network%5CContentDisposition.php) class for some other constructors.
### Where to test
Please use your own wiki to test this framework or at least use the Wikimedia Wikis' Sandboxes!
Feel free to fork and improve this documentation! Or just look inside the [/include](./include) directory where there is some inline documentation for you!