Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A simple Expression Engine plugin to find places near a known zip code.
tree: be5ae5cecd

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Nearby is a simple ExpressionEngine plugin that uses the API to find places near a known zip code.


Place the nearby plugin folder in your ExpressionEngine installation's third_party folder (system/expressionengine/third_party by default).

Since Nearby makes user of the GeoNames API, a GeoNames user account will be required to use more than the demo mode provided. You can sign up for one at

Once your account is created and activated, you will need to log in to the GeoNames site, click your username in the top right of the page to bring up the user control panel and then click the "Click here to enable" link under the title "Free Web Services" to enable API usage on your account.

Once your account is fully enabled, you can pass your username to the plugin via the "username" parameter or set your username in your config.php file with the code:

$config['nearby_username'] = "YOUR USERNAME";

Note: The free web services account on GeoNames provides for 2,000 requests per hour and a total of 30,000 requests per day. If more is needed, you can sign up for a commercial account at




  • zip (required) - the zipcode you'd like to search on
  • limit - limit the number of results returned
  • radius - distance in miles to search surrounding the desired zipcode
  • username - your GeoNames username

Single Variables:

  • {zip} - zipcode of result
  • {placename} - plain text descriptor of result
  • {latitude} - latitude of result, in decimal
  • {longitude} - longitude of result, in decimal
  • {distance} - the result's distance from the searched zipcode


Something went wrong with that request. Please try again.