django-url-tracker 0.1.3

安装

安装就像这样简单

pip install django-url-tracker

完成！

配置

要在您的项目中开始使用url_tracker，只需将以下两行添加到您的settings.py

1. 将中间件url_tracker.middleware.URLChangePermanentRedirectMiddleware添加到MIDDLEWARE_CLASSES的末尾，之后它应该看起来像这样

   MIDDLEWARE_CLASSES = (
       'django.middleware.common.CommonMiddleware',
       'django.contrib.sessions.middleware.SessionMiddleware',
       'django.middleware.csrf.CsrfViewMiddleware',
       'django.contrib.auth.middleware.AuthenticationMiddleware',
       'django.contrib.messages.middleware.MessageMiddleware',
       'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware',
       'url_tracker.middleware.URLChangePermanentRedirectMiddleware',
   )

2. 将url_tracker添加到您的INSTALLED_APPS

   INSTALLED_APPS = (
        "url_tracker",
   )

现在您可以在项目中使用url_tracker了。接下来要做的就是注册一个用于跟踪的模型。

跟踪模型

这是一个跟踪模型的简单示例。假设我们有一个名为Project的模型，该模型包含特定项目的详细信息，并在URLhttp://www.example.com/project/some-project/上可用。项目的URL基于我们模型的SlugField。模型可能看起来像这样

class Project(models.Model):
    name = models.CharField(max_length=20)
    slug = models.SlugField(max_length=20)
    description = models.CharField(max_length=500)

我不会详细介绍如何创建缩写，因为这被认为是常见做法。所以现在我们假设slug是从name自动填充的。然而，还需要一个东西，让跟踪器能够工作，那就是get_absolute_url方法。让我们把这个添加到模型中

class Project(models.Model):
    ...

    @models.permalink
    def get_absolute_url(self):
        return ('project-detail', (), {'slug': self.slug})

现在，为了实际开始跟踪URL更改，需要在类定义的底部或相应文件中添加以下命令

import url_tracker
url_tracker.track_url_changes_for_model(Project)

您已完成。如果您进入管理界面，创建一个新的项目，然后更改其slug（这将更改其URL），您将看到一个反映更改的新的URLChangeRecord。打开old_url应将其重定向到new_url。

贡献

如果您发现问题或希望看到支持的功能，请转到问题部分并报告。

要以任何形式贡献代码，请fork github存储库并将其克隆到本地。为您的功能创建一个新的分支

git commit -b feature/whatever-you-like

将完成的功能推送到github，并从分支打开一个pull请求。