Files changed (10)
-`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.
- * 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.
-`django-reploc` requires at least Django 1.0. 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 [http://code.google.com/apis/maps/signup.html the Google Maps API page] 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.2.6.
-You can download the package from the [http://pypi.python.org/pypi/django-reploc/ CheeseShop] or use
-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.
-Execute the following command (or use the equivalent function in a GUI such as TortoiseSVN), and make sure you're checking Pendulum out somewhere on the `PYTHONPATH`.
-The easiest way to ensure that you have successfully installed Pendulum is to execute a command such as:
-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.
-Next you should add the context processor to your `TEMPLATE_CONTEXT_PROCESSORS` setting so the templates have access to the Google Maps API key. You don't really need this step if you're going to put the API key straight into your template.
-Run `manage.py syncdb`. This creates a few tables in your database that are necessary for operation.
-Finally, you'll probably want to copy the media files that I use in `django-reploc`, unless you have some of your own. Those files can be found in the `/media/` directory of the project. There are really only two files that you should need to copy to your media directory: `reploc/media/js/jquery-1.3.1.min.js` and `reploc/media/img/ajax.gif` (see http://code.google.com/p/django-reploc/source/browse/#svn/trunk/reploc/media for the specific files). Alternatively, you may just override the templates to use whatever you want. I make no guarantees that the application will still work if you do that though ;)
-As soon as you have all of the configuration taken care of, simply fire up your site (or restart it) and jump into the Django administration interface. You can add locations straight from the "Add Representative" page if you'd like. When you're done, head on over to http://www.yourwebsite.com/locator/ (or whatever it happens to be in your case) to see the application in action.
+ description="A simple way for people to find representative locations on your Django-powered Web site.",
- description="A simple way for people to find representative locations on your Django-powered Web site.",
-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.