Jump to content

Extension:NearbyPages

From mediawiki.org
MediaWiki extensions manual
NearbyPages
Release status: stable
Description Provides Special:Nearby
Latest version 1.40
MediaWiki 1.39
Database changes No
License GNU General Public License 2.0 or later
Download
README
  • $wgNearbyPagesNamespaces
  • $wgNearbyRandomButton
  • $wgNearbyRange
  • $wgNearbyPagesWikidataCompatibility
  • $wgNearbyPagesUrl
1.39
Quarterly downloads 11 (Ranked 122nd)
Translate the NearbyPages extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The NearbyPages extension provides location based articles via Special:Nearby special page. It was previously part of Extension:MobileFrontend but decoupled and rewritten with Vue.js . The extension can also be deployed as a static web app that is demoed as a standalone app for Wikipedia and Wikidata.

Special:Nearby

The page Special:Nearby lists articles that are geotagged nearest to the user's current location, as provided by their browser. Due to the limit of the geosearch API, only articles within a 10 km radius are listed by default, although this can be changed using the $wgMaxGeoSearchRadius and $wgNearbyRange variables.

It is also possible to manually specify a location by including its latitude and longitude as URL parameters. For example, this URL will generate a list of articles near the w:Statue of Liberty in New York City, US:

https://en.wikipedia.org/wiki/Special:Nearby#/coord/40.69,-74.04

Installation

  • Download and move the extracted NearbyPages folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/NearbyPages
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'NearbyPages' );
    $wgNearbyPagesUrl = "{$wgScriptPath}/api.php";
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Using with local data

Nearby can be populated with articles on your wiki by installing extension:Geodata.