Skip to main content

A reusable Django app that allows you to manage and display your stores

Project description

A reusable Django app that allows you to manage and display your stores.

If you e.g. have different outlets, where you sell your products and those scattered across the world’s surface, you can provide easy access to the customer about where they can find them.

The app includes simple management of countries and outlets and a google map integration. For integration into the great django-cms, see cmsplugin-django-outlets.


To get the latest stable release from PyPi

pip install django-outlets

# optional if you want cms integration
pip install cmsplugin-django-outlets

To get the latest commit from GitHub

pip install -e git+git://

Add outlets to your INSTALLED_APPS

    # again just if you want cms integration add the following

Add the outlets URLs to your

urlpatterns = patterns('',
    url(r'^outlets/', include('outlets.urls')),

Don’t forget to migrate your database

./ migrate outlets
# and another optional line. You guessed it. Only if you require it to work
# in django-cms.
./ migrate cmsplugin_outlets


If you want to use the map, that comes with the default tempalte and you override the template, keep in mind to to hook up the Google maps API and the django-outlets googlemap_outlets.js inside the template if you haven’t added it globally already.

{% load staticfiles %}

<script src=""></script>
<script type="text/javascript" src="{% static "django_libs/js/maps.js" %}"></script>
<script type="text/javascript" src="{% static "outlets/js/googlemap_outlets.js" %}"></script>

Check the Google API docs for further information

To be able to display your outlets on the map, every Outlet needs to have the lat and lon field set properly.

To customize the info boxes, that appear, when you click on the map markers, you can override the template at outlets/outlet_map_marker.html.

When customizing the outlets/outlet_list.html template, please note the comments inside the template.

CMS3 integration

If you installed and added the cmsplugin-django-outlets app as described above, you can go ahead and create a page with the “Outlets Apphook” to it.

That’s it.

For more details on apphooks refer to the django-cms v3.x documentation itself.

Template tags


This tag loads all outlet countries from within a template.


{% load outlets_tags %}

{% get_outlet_countries as countries %}

<p>Visit our outlets in:</p>
  {% for country in countries}
    <li><a href="{{ country.get_absolute_url }}">{{ }}</a></li>
  {% endfor %}


If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
mkvirtualenv -p python2.7 django-outlets
make develop

git co -b feature_branch master
# Implement your feature and tests
git add . && git commit
git push -u origin feature_branch
# Send us a pull request for your feature branch

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-outlets-0.4.4.tar.gz (14.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page