一个可重用的django应用程序,允许向任何django模型添加日期十进制值
django-dated-values的Python项目详细描述
一个可重用的django应用程序,允许向任何django模型添加日期十进制值。
安装
从pypi获得最新的稳定版本
pip install django-dated-values
从github获取最新提交
pip install -e git+git://github.com/bitmazk/django-dated-values.git#egg=dated_values
TOdo:描述进一步的安装步骤(编辑/删除以下示例):
将dated_values添加到INSTALLED_APPS
INSTALLED_APPS=(...,'dated_values',)
将dated_valuesurl添加到urls.py
urlpatterns=patterns('',...url(r'^dated-values/',include('dated_values.urls')),)
不要忘记迁移数据库
./manage.py migrate dated_values
添加css或编写自己的自定义样式。
{% load static %} <linkhref="{% static "dated_values/css/dated_values.css"%}"rel="stylesheet">
用法
用法相当直截了当。您需要添加DatedValueType 要将值添加到的每个内容类型的实例。
decimal_places字段允许您减少小数位数 用于表单验证。默认值为2,最大值为8。
注意
使用postgres,它可以存储所有的小数位,不管 如果你少输入。
如果自动使用默认模板将hidden设置为True。 隐藏窗体中的值。例如,您可以使用它在 用户看不到的背景。
如果使用默认模板将editable设置为True,则 只呈现值而不呈现输入字段。
一旦设置好并访问管理视图,您将看到一个表单 保存该项的所有已定义类型的所有值的表。 url kwargs需要ctype_id和object_id。一个例子 实现可能是:
classMyModel(models.Model):...# my fields and other things go heredefget_management_url(self):"""Returns the management url from django-dated-values."""ctype=ContentType.objects.get_for_model(self.__class__)returnreverse('dated_values_management_view',kwargs={'ctype_id':ctype.id,'object_id':self.id})
设置
DATED_VALUES_ACCESS_ALLOWED设置需要一个函数,它接受 用户和内容对象作为参数。需要定义访问权限 “值管理”视图的权限。默认值如下:
DATED_VALUES_ACCESS_ALLOWED=lambdauser,obj=None:user.is_staff
注意
超级用户将始终能够打开视图,无论 就在这里。
您可以更改显示项的长度,默认为14(2周) 设置DATED_VALUES_DISPLAYED_ITEMS:
# this will only show 1 weekDATED_VALUES_DISPLAYED_ITEMS=7
贡献
如果您想参与此项目,请执行以下步骤
# Fork this repository # Clone your fork mkvirtualenv -p python2.7 django-dated-values make develop git co -b feature_branch master # Implement your feature and tests git add . && git commit git push -u origin feature_branch # Send us a pull request for your feature branch