django-legal 1.0

安装

1. 使用pip安装：

   $ pip install django-legal
   

2. 将legal添加到INSTALLED_APPS设置中。

3. （可选）添加新设置：LEGAL_TOS_NAME = 'terms_of_service'

4. 用以下命令更新urls.py：

   url(r'^legal/', include('legal.urls')),
   

5. 创建新的协议和协议版本（最好通过数据迁移）：

   # -*- coding: utf-8 -*-
   import os
   from south.v2 import DataMigration
   
   # This should be the same value as LEGAL_TOS_NAME (if you overrode it)
   AGREEMENT_NAME = 'tos'
   
   
   class Migration(DataMigration):
       def forwards(self, orm):
           agreement, created = orm['legal.Agreement'].objects.get_or_create(name=AGREEMENT_NAME)
   
           # This file should live in the same directory as the migration
           f = open('%s/tos_content_2013_08_01.html' % os.path.dirname(__file__), 'r')
           orm['legal.AgreementVersion'].objects.create(agreement=agreement, date='2013-08-01', content=f.read())
   
       def backwards(self, orm):
           agreement = orm['legal.Agreement'].objects.get(name=AGREEMENT_NAME)
           agreement.delete()
   
       models = {
           'legal.agreement': {
               'Meta': {'object_name': 'Agreement'},
               'id': ('django.db.models.fields.AutoField', [], {'primary_key': 'True'}),
               'name': (
                   'django.db.models.fields.CharField', [], {'unique': 'True', 'max_length': '50', 'db_index': 'True'})
           },
           'legal.agreementversion': {
               'Meta': {'ordering': "['-date']", 'unique_together': "(('agreement', 'date'),)",
                        'object_name': 'AgreementVersion'},
               'agreement': ('django.db.models.fields.related.ForeignKey', [], {'to': "orm['legal.Agreement']"}),
               'content': ('django.db.models.fields.TextField', [], {}),
               'date': ('django.db.models.fields.DateTimeField', [], {}),
               'id': ('django.db.models.fields.AutoField', [], {'primary_key': 'True'})
           }
       }
   
       # Change this to be the name of the app where the migration lives
       complete_apps = ['my-app']
       symmetrical = True
   

测试此应用程序

包含一个修改过的manage.py和django设置文件来测试此应用：

$ python manage.py test

测试应用程序

您可能会发现中间件对于您的测试有点过分，因为它要求您创建一个协议和版本，并代表您的测试用户接受该协议。如果要禁用中间件，请在设置中添加以下内容：

if 'test' in sys.argv:
  MIDDLEWARE_CLASSES = list(MIDDLEWARE_CLASSES)
  MIDDLEWARE_CLASSES.remove('legal.middleware.TermsOfServiceAcceptanceMiddleware')