Skip to content
A store locator extension for Django CMS
Branch: master
Clone or download
ygneo Merge pull request #3 from dboczek/master
Fix for rearching with unicode characters like "Świętochłowice"
Latest commit 2e3cf30 Jun 12, 2013



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.

You can’t perform that action at this time.