帮助您的django项目遵守欧盟cookie法律法规
django-cookie-law的Python项目详细描述
Django Cookie Law帮助您的Django项目遵守 EU cookie regulations。 通过显示cookie信息横幅,直到被用户取消。
警告
应用程序可能与本地cookie不兼容 法律法规。如有疑问,请咨询你的律师。
欢迎使用github发表意见: http://github.com/TyMaszWeb/django-cookie-law
请注意,Django Cookie法律要求:
- django>;=1.8
- django classy tags>;=0.3.0
安装
pip install django-cookie-law
将'cookielaw'添加到INSTALLED_APPS
运行collectstatic(django 1.3+)或将静态数据复制到媒体目录
直接或通过资产将cookielaw/js/cookielaw.js添加到标记中 管理器,例如django-pipeline或django-compressor
如果使用的是django>;1.8,请在TEMPLATES['OPTIONS']设置中启用'django.core.context_processors.request',例如:
TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [], 'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ 'django.template.context_processors.debug', 'django.core.context_processors.i18n', 'django.core.context_processors.media', 'django.template.context_processors.request', 'django.contrib.auth.context_processors.auth', 'django.core.context_processors.static', 'django.core.context_processors.tz', 'django.contrib.messages.context_processors.messages', ], }, }, ]
如果您使用的是旧版本的django(<;1.8),则需要更改 TEMPLATE_CONTEXT_PROCESSORS设置,例如:
TEMPLATE_CONTEXT_PROCESSORS = ( 'django.contrib.auth.context_processors.auth', 'django.core.context_processors.debug', 'django.core.context_processors.i18n', 'django.core.context_processors.media', 'django.core.context_processors.request', 'django.core.context_processors.static', 'django.core.context_processors.tz', 'django.contrib.messages.context_processors.messages' )Note
N.b. versions below 1.8 are not officially supported.
Note
If you don’t have this setting defined, just add it to your settings module.
- {% load cookielaw_tags %}并添加{% cookielaw_banner %}模板 标记要显示Cookielaw横幅的位置。最好的地方是 你的“基本”模板,所以你会在每一页的 你的网站。
配置
如果要使用我们的默认模板,请将cookielaw/css/cookielaw.css添加到 标记和您应该在页面顶部看到Cookie Law横幅,直到 你用右上角的按钮把它关掉。这个css是twitter引导 兼容,但很有可能,你还是会喜欢调整它。
要更改标记,只需添加名为cookielaw/banner.html的模板并 确保它在默认模板之前加载(例如 django.template.loaders.filesystem.Loader之前 django.template.loaders.app_directories.Loader并添加新模板 任何一个TEMPLATE_DIRS。
要更改css,只需编写自己的规则,而不包括默认的 样式表。
错误和贡献
请使用github报告错误、功能请求并提交代码: http://github.com/TyMaszWeb/django-cookie-law
author: | Piotr Kilczuk |
---|---|
date: | 2013/04/08 |