django-reploc 0.1.1-pre1

功能

• 无限数量的代表。

• 每个代表无限数量的位置。

• 自动确定位置的经纬度。如果确定地址的坐标有问题，您可以手动输入。

• 位置可以具有“属性”。这是一种指定，例如，哪些位置携带您产品的哪些系列的方法。

• 您可以选择是否希望使用JavaScript或Python来完成繁重的工作。

• 用户可以在指定的地址半径内搜索位置。

• 为您的用户提供到各个代表位置的驾驶路线。

需求

django-reploc 至少需要 Django 1.0。为了自动确定坐标，django-reploc 需要使用 geopy 库。这可以通过使用 easy_install geopy 来安装。应用程序还需要您有一个 Google Maps API 密钥。要获取一个，只需访问 Google Maps API 页面 并填写必要的信息。最后，django-reploc 极度依赖 jQuery 来运行。我使用了当前最新版本的 jQuery，即 1.2.6。

安装

使用以下方法之一下载 django-reploc

easy_install django-reploc

pip install -U django-reploc

hg clone http://bitbucket.org/codekoala/django-reploc
hg clone http://django-reploc.googlecode.com/hg django-reploc
git clone http://github.com/codekoala/django-reploc.git

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

配置

首先，您必须将此项目添加到 settings.py 中的 INSTALLED_APPS 列表。

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    ...
    'reploc',
    ...
)

接下来，您应该将上下文处理器添加到 TEMPLATE_CONTEXT_PROCESSORS 设置中，以便模板可以访问 Google Maps API 密钥。如果您打算直接将 API 密钥放入模板中，则无需此步骤。

TEMPLATE_CONTEXT_PROCESSORS = (
    'django.core.context_processors.auth',
    'django.core.context_processors.i18n',
    'django.core.context_processors.media',
    'reploc.context_processors.representatives',
)

在您的 settings.py 文件中定义您的 Google Maps API 密钥。

GOOGLE_MAPS_KEY = 'sdfsafasfdasfdasdf'

此外，您可能指定是否希望 JavaScript 或 Python 处理基础工作（例如距离计算等）

REPLOC_USE_JS = False

这可能永远不会被广泛使用，但它就在那里，以防万一。应用程序默认使用 JavaScript。

运行 python manage.py syncdb。这将为您数据库创建一些必要操作的表。

接下来，您应该在主 urls.py 文件中添加一个条目。例如

from django.conf.urls.defaults import *

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    (r'^admin/(.*)', admin.site.root),
    (r'^locator/', include('reploc.urls')),
)

最后，您可能想要复制我在 django-reploc 中使用的媒体文件，除非您有自己的文件。这些文件可以在项目的 /media/ 目录中找到。实际上，您只需要将以下两个文件复制到您的媒体目录： reploc/media/js/jquery-1.3.1.min.js 和 reploc/media/img/ajax.gif（请参阅 http://code.google.com/p/django-reploc/source/browse/#hg%2Freploc%2Fmedia 了解特定文件）。或者，您可以覆盖模板以使用您想要的任何内容。不过，我不保证应用程序在这样做后仍然可以工作；）

用法

一旦您完成所有配置，只需启动您的网站（或重启它）并进入Django管理界面即可。如果您想的话，可以直接从“添加代表”页面添加位置。完成后，请转到http://www.yourwebsite.com/locator/（或根据您的具体情况）查看应用程序的实际运行情况。