diff --git "a/include/class-wm\\Wikidata.php" "b/include/class-wm\\Wikidata.php" index 90375db..7e2df33 100644 --- "a/include/class-wm\\Wikidata.php" +++ "b/include/class-wm\\Wikidata.php" @@ -1,51 +1,85 @@ . # Wikimedia namespace wm; class Wikidata extends \mw\StaticSite { /** * @override \mw\StaticSite::UID */ const UID = 'wikidatawiki'; /** * @override \mw\StaticSite::getApiURL() */ protected static function getApiURL() { return '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( [ + 'action' => 'wbeditentity', + 'token' => $this->getToken( mw\Tokens::CSRF ), + ] ); + } + }