Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A store locator extension for Django CMS
Python JavaScript Shell
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



An extension for Django CMS that lets you enter your store locations and drop a plugin on any page that generates a map and store list based on city/state or zip code search input, or a city drop down for each city with a location in it.


  • django (tested with 1.3)
  • django-cms (tested with 2.2)

Getting Started

To get started simply install using pip:

pip install django-cms-storelocator

Add store_locator to your installed apps and syncdb (or migrate, if you have south installed).

Your installed apps should look something like this:


Finally, add store_locator.urls to your so that we can make a few ajax calls needed to interact with the map. Here's what a simple might look like:

urlpatterns = patterns('',
    url(r'^admin/', include(,
    url(r'^store-locator/', include('store_locator.urls')),
    url(r'^', include('cms.urls')),


You can add store locations through the admin, the app will try to find a lat/long via google maps api if you do not enter them.

Once you have your locations entered you can simply drop a Store Locator plugin on any page in your Django CMS implementation and it will render a google map, a search field, a search distance drop down, and a search button. When a user searchs for an address, zip code, city, or any other location information that Google Maps can translate into an address, the plugin will show markers on the map for any Store Locations that are within the distance specified by the user of the address they searched for.

Something went wrong with that request. Please try again.