<commit_before>``django-reploc`` is a project that allows you to install a Google Map on your
site to display and filter "representatives" for your site. These
representatives may be dealers/vendors for your products, your friends or
business associates, or just places you've been and want to advertise. I built
the application to be a dealer locator, but I realize the value in an
application like this and tried to make it as generic as possible.

Features
========

* Unlimited number of representatives.
* Unlimited number of locations _per_ representative.
* Automatic latitude/longitude determination for locations. If there's a
  problem determining the coordinates to the address, you can enter them
  manually.
* Locations can have "attributes."  This is a way of specifying, for example,
  which locations carry which lines of your products.
* You can decide whether you want to use JavaScript or Python to do the heavy
  lifting.
* Users can search for locations within a radius of an address they specify.
* Offer your users driving directions to various representative locations.

Requirements
============

``django-reploc`` was rewritten for Django 1.4 and to make use of Google Maps
API version 3. It should work on previous versions of Django, but has not been
tested. For automatic coordinate determination, ``django-reploc`` requires
the ``geopy`` library. This can be installed using ``easy_install geopy``.
The application also requires that you have a Google Maps API key. To get one
of those, simply go to `the Google Maps API page
<http://code.google.com/apis/maps/signup.html>`_ and fill out the necessary
information. Finally, ``django-reploc`` relies heavily upon jQuery in order
to operate. I used the latest version of jQuery, which is currently 1.7.2.

Installation
============

Download ``django-reploc`` using *one* of the following methods:

easy_install
------------

You can download the package from the `CheeseShop
<http://pypi.python.org/pypi/django-reploc/>`_ or use::

    easy_install django-reploc

to download and install ``django-reploc``.

pip
---

Install ``django-reploc`` using::

    pip install -U django-reploc

Package Download
----------------

Download the latest ``.tar.gz`` file from the downloads section and extract it
somewhere you'll remember. Use ``python setup.py install`` to install it.

Clone From Source Control
-------------------------

You can get the latest copy of the source code from any of the these official
repositories::

    git clone http://github.com/kenbolton/django-reploc.git

Verifying Installation
----------------------

The easiest way to ensure that you have successfully installed Pendulum is to
execute a command such as::

    python -c "import reploc; print reploc.get_version()"

If that displays the version of ``django-reploc`` that you tried to install,
you're good to roll. If you see something other than that, you probably need
to check your ``PYTHONPATH`` environment variable.

Configuration
=============

First of all, you must add this project to your list of ``INSTALLED_APPS`` in
``settings.py``::

    INSTALLED_APPS = (
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.messages',
        'django.contrib.sessions',
        'django.contrib.sites',
        'django.contrib.messages',<commit_msg>Update master<commit_after>``django-reploc`` is a project that allows you to install a Google Map on your
site to display and filter "representatives" for your site. These
representatives may be dealers/vendors for your products, your friends or
business associates, or just places you've been and want to advertise. I built
the application to be a dealer locator, but I realize the value in an
application like this and tried to make it as generic as possible.

Features
========

* Unlimited number of representatives.
* Unlimited number of locations _per_ representative.
* Automatic latitude/longitude determination for locations. If there's a
  problem determining the coordinates to the address, you can enter them
  manually.
* Locations can have "attributes."  This is a way of specifying, for example,
  which locations carry which lines of your products.
* You can decide whether you want to use JavaScript or Python to do the heavy
  lifting.
* Users can search for locations within a radius of an address they specify.
* Offer your users driving directions to various representative locations.

Requirements
============

``django-reploc`` was rewritten for Django 1.4 and to make use of Google Maps
API version 3. It should work on previous versions of Django, but has not been
tested. For automatic coordinate determination, ``django-reploc`` requires
the ``geopy`` library. This can be installed using ``easy_install geopy``.
The application also requires that you have a Google Maps API key. To get one
of those, simply go to `the Google Maps API page
<http://code.google.com/apis/maps/signup.html>`_ and fill out the necessary
information. Finally, ``django-reploc`` relies heavily upon jQuery in order
to operate. I used the latest version of jQuery, which is currently 1.7.2.

Installation
============

Download ``django-reploc`` using *one* of the following methods:

easy_install
------------

You can download the package from the `CheeseShop
<http://pypi.python.org/pypi/django-reploc/>`_ or use::

    easy_install django-reploc

to download and install ``django-reploc``.

pip
---

Install ``django-reploc`` using::

    pip install -U django-reploc

Package Download
----------------

Download the latest ``.tar.gz`` file from the downloads section and extract it
somewhere you'll remember. Use ``python setup.py install`` to install it.

Clone From Source Control
-------------------------

You can get the latest copy of the source code from any of the these official
repositories::

    git clone http://github.com/codekoala/django-reploc.git

Verifying Installation
----------------------

The easiest way to ensure that you have successfully installed Pendulum is to
execute a command such as::

    python -c "import reploc; print reploc.get_version()"

If that displays the version of ``django-reploc`` that you tried to install,
you're good to roll. If you see something other than that, you probably need
to check your ``PYTHONPATH`` environment variable.

Configuration
=============

First of all, you must add this project to your list of ``INSTALLED_APPS`` in
``settings.py``::

    INSTALLED_APPS = (
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.messages',
        'django.contrib.sessions',
        'django.contrib.sites',
        'django.contrib.messages',
{'fraction_non_alphanumeric': 0.10384615384615385, 'fraction_numerical': 0.0017751479289940828, 'mean_word_length': 3.714783821478382, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 12, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4167922', 'n_tokens_mistral': 1794, 'n_tokens_neox': 1713, 'n_words': 854}