diff --git "a/include/class-wm\\Commons.php" "b/include/class-wm\\Commons.php" index 5349359..31af35d 100644 --- "a/include/class-wm\\Commons.php" +++ "b/include/class-wm\\Commons.php" @@ -1,33 +1,38 @@ . # Wikimedia namespace wm; +/** + * Commons singleton class + * + * @see https://commons.wikimedia.org/ + */ class Commons extends \mw\StaticSite { /** * @override */ const UID = 'commonswiki'; /** * @override */ const API_URL = 'https://commons.wikimedia.org/w/api.php'; } diff --git "a/include/class-wm\\Wikidata.php" "b/include/class-wm\\Wikidata.php" index 5357a45..5baecb8 100644 --- "a/include/class-wm\\Wikidata.php" +++ "b/include/class-wm\\Wikidata.php" @@ -1,83 +1,88 @@ . # Wikimedia namespace wm; +/** + * Wikidata singleton instance + * + * @see https://www.wikidata.org/ + */ class Wikidata extends \mw\StaticSite { /** * @override */ const UID = 'wikidatawiki'; /** * @override */ const API_URL = 'https://www.wikidata.org/w/api.php'; /** * Execute a SPARQL query * * @param $query string SPARQL query * @return array */ public static function querySPARQL( $query ) { $request = new \network\HTTPRequest( 'https://query.wikidata.org/sparql' ); $response = $request->fetch( [ 'format' => 'json', 'query' => $query ] ); $response_obj = json_decode( $response ); return $response_obj->results->bindings; } /** * Fetch a single Wikidata entity * * @param $entity_id string Entity Q-ID * @param $data array Additional data such as [ 'props' => '..' ] * @return wb\DataModel */ public function fetchSingleEntity( $entity_id, $data = [] ) { $data = array_replace( [ 'action' => 'wbgetentities', 'ids' => $entity_id, ], $data ); $entity = $this->fetch( $data ); if( ! isset( $entity->entities->{ $entity_id } ) ) { throw new Exception( "$wikidata_item does not exist" ); } return \wb\DataModel::createFromObject( $entity->entities->{ $entity_id } ); } /** * Edit a Wikidata entity * * @param $data array API data request * @return mixed * @see https://www.wikidata.org/w/api.php?action=help&modules=wbgetentities */ public function editEntity( $data = [] ) { return $this->post( array_replace( [ 'action' => 'wbeditentity', 'token' => $this->getToken( \mw\Tokens::CSRF ), ], $data ) ); } } diff --git "a/include/class-wm\\WikipediaIt.php" "b/include/class-wm\\WikipediaIt.php" index c8d2f68..4a9257d 100644 --- "a/include/class-wm\\WikipediaIt.php" +++ "b/include/class-wm\\WikipediaIt.php" @@ -1,60 +1,67 @@ . + # Wikimedia namespace wm; +/** + * Italian Wikipedia singleton class + * + * @see https://it.wikipedia.org/ + */ class WikipediaIt extends \mw\StaticSite { /** * @override */ const UID = 'itwiki'; /** * @override */ const API_URL = 'https://it.wikipedia.org/w/api.php'; /** * @override */ protected static function create() { parent::create(); $this->setNamespaces( [ new \mw\Ns( 1, 'Discussione' ), new \mw\Ns( 2, 'Utente' ), new \mw\Ns( 3, 'Discussioni utente' ), new \mw\Ns( 4, 'Wikipedia', ['Wp'] ), new \mw\Ns( 5, 'Discussioni Wikipedia', ['Dw'] ), new \mw\Ns( 6, 'File', ['Image', 'Immagine'] ), new \mw\Ns( 7, 'Discussioni file', ['Discussioni immagine', 'Image talk'] ), new \mw\Ns( 9, 'Discussioni MediaWiki' ), new \mw\Ns( 10, 'Template', ['T'] ), new \mw\Ns( 11, 'Discussioni template' ), new \mw\Ns( 12, 'Aiuto' ), new \mw\Ns( 13, 'Discussioni aiuto' ), new \mw\Ns( 14, 'Categoria', [ 'Cat' ] ), new \mw\Ns( 15, 'Discussioni categoria' ), new \mw\Ns( 100, 'Portale' ), new \mw\Ns( 101, 'Discussioni portale' ), new \mw\Ns( 102, 'Progetto' ), new \mw\Ns( 103, 'Discussioni proggetto', ['Dp'] ), new \mw\Ns( 828, 'Modulo' ), new \mw\Ns( 829, 'Discussioni modulo' ) ] ); } + }